Oracle Cloud Infrastructureドキュメント

計画ロールバック・ジョブの作成

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

計画ロールバック・ジョブを作成(実行)すると、ターゲット・ジョブのTerraform構成が解析され、関連するスタックの実行計画に変換されます。実行計画には、Oracle Cloud Infrastructureリソースをロールバックするように計画された特定のアクション(適用ロールバック・ジョブの実行後に予想されるアクションを含む)の順序がリストされます。

次のフローを使用してロールバック・ジョブの適用を実行する前に、計画ロールバック・ジョブ(実行計画の生成)を実行することをお薦めします。

  1. ロールバック先の成功した適用ジョブを特定します。

    ロールバック先のジョブは、ターゲット・ジョブとも呼ばれます。

  2. ターゲット・ジョブの計画ロールバック・ジョブを作成します。

    このページには説明があります。

  3. 計画ロールバック・ジョブが成功したことを確認します。

  4. 生成された実行計画が期待を満たしていることを確認します。

  5. 生成された実行計画(executionPlanRollbackStrategy)を使用して、ロールバックの適用ジョブを作成します。

    実行計画はロールバックの適用ジョブに渡され、その後命令が実行されます。

    1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「リソース・マネージャ」で、「スタック」をクリックします。
    2. 「スタック」ページで、目的のスタックを含むコンパートメントを選択します。
    3. 目的のスタックの名前をクリックします。
    4. 「スタックの詳細」ページの「ジョブ」リストで、ロールバックする適用ジョブの「アクション」メニュー(アクション・メニュー)をクリックし、「ロールバック」を選択します。
      「ロールバック」パネルが開き、選択した適用ジョブのOCIDと名前(ターゲット・ロールバック・ジョブのOCIDおよびターゲット・ロールバック・ジョブの名前)が表示されます。
    5. 「ロールバック・ジョブ・タイプ」で、「プラン」を選択してプラン・ロールバック・ジョブを作成します。
    6. (オプション)ロールバック・ジョブのデフォルト名を編集します。機密情報の入力は避けてください。
    7. デバッグの詳細なログ・コンテンツを生成するには、「拡張オプションの表示」をクリックし、「詳細なログ・レベル」から目的のログ・レベルを選択します。
      詳細は、Terraformのデバッグを参照してください。
    8. Terraformによるグラフの移動に従って同時操作の最大数を調整するには、「拡張オプションの表示」をクリックし、「パラレル操作の最大数」の値を編集します。(デフォルト: 10。)このオプションを使用して、ジョブを高速化します。
      ノート

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

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

      ノート

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

    計画ロールバック・ジョブが作成されます。新しいジョブが「ジョブ」の下にリストされます。

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

    oci resource-manager job create-plan-rollback-job --stack-id <stack_OCID> --target-rollback-job-id <job_OCID>

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

  • CreateJob操作を使用して、計画ロールバック・ジョブを作成します。

    計画ロールバック・ジョブの詳細は、PlanRollbackJobOperationDetailsを参照してください。