破棄ジョブの作成

リソース・マネージャで破棄ジョブを作成して、スタックに関連付けられたリソースを解放(分解)し、テナンシをクリーンアップします。リリースされたリソースは、最終的に関連するOCIサービスによって削除されます。たとえば、リリースされたコンピュート・インスタンスは、最終的にOCIコンピュート・サービスによって削除されます。

スタックのジョブ履歴および状態は、破棄ジョブの実行後も残ります。スタックのログ・ファイルを調べることで、ステータスをモニターし、破棄ジョブの結果を確認できます。

破棄ジョブは、スタックによって作成されたリソースが存在する場合に使用できます。

ノート

スタックを削除して関連リソースを解放する前に、破棄ジョブを実行することをお薦めします。スタックを削除すると、関連する状態ファイルも削除されるため、関連するリソースの状態のトラッキングが失われます。削除されたスタックに関連付けられているリソースのクリーンアップは、特にそれらのリソースが複数のコンパートメントにまたがる場合、状態ファイルなしでは困難になる可能性があります。後で困難なクリーンアップを回避するために、破棄ジョブを実行して関連付けられたリソースを最初に解放することをお薦めします。スタックにリソースが関連付けられていない場合、破棄ジョブは使用できません。状態ファイルの欠落を気にせずに、このようなスタックを安全に削除できます。

破棄されたリソースからデータをリカバリすることはできません。

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

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

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

      ノート

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

    破棄ジョブが作成されます。新しいジョブが「ジョブ」の下にリストされます。

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

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

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

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

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

次の処理

破棄ジョブの実行後、ジョブの詳細を取得してそのステータスを確認します。オプションで、Terraform状態ファイルを表示したり、ログを表示したり、リソースの削除を確認できます。破棄されたリソースを再作成することもできます。

ジョブの詳細を取得して、ジョブ・ステータス(ライフサイクルの状態)をモニターします。「成功」(SUCCEEDED)は、ジョブが完了したことを示します。ジョブの複雑さによっては、操作に時間がかかる場合があります。ジョブの実行中または終了後に、ジョブ・ログの内容を取得できます。

Terraformの状態ファイル(ジョブの実行後のリソースの状態を示します)を表示するには、ジョブの名前をクリックして「ジョブ詳細」ページを表示し、「リソース」の下の「状態の表示」をクリックします。オプションで、「このバージョンの変更の表示」を選択します。

ジョブのログを表示するには、ジョブの名前をクリックして「ジョブ詳細」ページを開き、「リソース」の下の「ログ」をクリックします。

リソースの削除を確認するには、コンパートメントのリソースを検査します。

リソースが破棄された後にスタックのリソースを再作成するには、適用ジョブを実行します。新しいリソースは、一意のOCIDsおよびその他のメタデータによって、以前に破棄されたリソースとは異なります。