Oracle Cloud Infrastructureドキュメント

計画ジョブの作成

リソース・マネージャで計画ジョブを作成します。

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

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

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

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

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

      ノート

      状態をリフレッシュすると、パフォーマンスに影響する可能性があります。構成に複数のリソースが含まれている場合は、このオプションを使用しないことを検討してください。
    8. (オプション)タグを追加します:
      1. タグ付けオプションを表示するには、「拡張オプションの表示」を選択します。
      2. 定義済タグを追加するには、ネームスペースとキーを選択し、値を入力します。
      3. フリーフォーム・タグを追加するには、キーと値を入力します。
    9. 「プラン」を選択します。

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

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

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

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

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

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