Oracle Cloud Infrastructureドキュメント

プラン・ジョブの作成

リソース・マネージャでプラン・ジョブを作成します。

計画ジョブを作成(実行)すると、Terraform構成が解析され、関連するスタックの実行計画に変換されます。実行計画には、適用ジョブの実行後に予想されるアクションなど、Oracle Cloud Infrastructureリソースをプロビジョニングするために計画された特定のアクションの順序がリストされます。適用ジョブの実行前に、計画ジョブ(実行計画の生成)を実行することをお薦めします。実行計画は適用ジョブに渡され、その適用ジョブによって手順が実行されます。

GitHubやGitLabなどのソース・コード制御システムに格納された構成の場合、ジョブは最新のコミットを使用します。

    1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「リソース・マネージャ」で、「スタック」をクリックします。
    2. 「スタック」ページで、目的のスタックを含むコンパートメントを選択します。
    3. 目的のスタックの名前をクリックします。
    4. 「スタックの詳細」ページで、「プラン」をクリックします。
    5. (オプション)「プラン」パネルで、ジョブのデフォルト名を編集します。機密情報の入力は避けてください。
    6. Terraformプロバイダの構成済ソースから使用可能な最新バージョンを取得するには、「拡張オプションの表示」をクリックし、「プロバイダ・バージョンのアップグレード」を選択します。
      スタックはTerraform 0.14以上である必要があり、スタックが古い場合は、Terraformレジストリを使用にアップグレードする必要があります。このステップは、Terraform構成のプロバイダ・バージョンが、スタックで最後にジョブが実行されてから変更された場合に必要です。依存関係ロックファイルは、新規および更新されたスタックに対して自動的に管理されます。プロバイダは、Terraform構成のバージョン制約内で更新されます。
    7. デバッグの詳細なログ・コンテンツを生成するには、「拡張オプションの表示」をクリックし、「詳細なログ・レベル」から目的のログ・レベルを選択します。
      詳細は、Terraformのデバッグを参照してください。
    8. Terraformによるグラフの移動に従って同時操作の最大数を調整するには、「拡張オプションの表示」をクリックし、「パラレル操作の最大数」の値を編集します。(デフォルト: 10。)このオプションを使用して、ジョブを高速化します。
      ノート

      値が大きいと、リソースがスロットルする可能性があります。たとえば、数百のコンピュート・インスタンスを定義するTerraform構成を考えてみます。適用ジョブは、可能なかぎり多くのインスタンスを同時に作成しようとします。この例では、100の値によって、コンピュート・サービスによるスロットルが発生する場合があります。
    9. ジョブを実行する前に最新の状態をフェッチするには、「拡張オプションの表示」をクリックし、「差異をチェックする前にリソース状態をリフレッシュ」を選択します。

      このオプションを使用して、最初に状態をリフレッシュします。たとえば、手動で更新された(既存の)インフラストラクチャで実行する適用ジョブでこのオプションを使用することを検討してください。

      ノート

      状態をリフレッシュすると、パフォーマンスに影響する可能性があります。構成に複数のリソースが含まれている場合は、このオプションを使用しないことを検討してください。
    10. (オプション)「拡張オプションの表示」をクリックし、ジョブにタグを割り当てます。
      • タグ・ネームスペース: 定義済タグを追加するには、既存のネームスペースを選択します。フリー・タグを追加するには、値を空白のままにします。
      • タグ・キー: 定義済タグを追加するには、既存のタグ・キーを選択します。フリーフォーム・タグを追加するには、必要なキー名を入力します。
      • タグ値: 必要なタグ値を入力します。
      • タグの追加: クリックして別のタグを追加します。
    11. 「計画」をクリックします。

    プラン・ジョブが作成されます。新しいジョブが「ジョブ」の下にリストされます。

  • oci resource-manager job create-plan-jobコマンドおよび必須パラメータを使用して、計画ジョブを実行します。

    oci resource-manager job create-plan-job [OPTIONS]

    CLIコマンドのパラメータおよび値の完全なリストは、リソース・マネージャのコマンドライン・リファレンスを参照してください。

  • CreateJob操作を使用して、計画ジョブを作成します。

    リクエストのoperation部分の例は、CreatePlanJobOperationDetailsを参照してください。