デプロイメントの削除

Infrastructure Manager を使用すると、不要になったデプロイを削除できます。デプロイを削除すると、そのメタデータと状態が削除されます。基盤となるプロビジョニングされたリソースを削除するか、保持するかを選択できます。

このドキュメントは、Terraform に精通していることを前提としています。詳細については、Terraform と Infra Manager をご覧ください。

始める前に

  1. Infra Manager が有効になっていることを確認します。
  2. デプロイの作成に必要な IAM 権限（roles/config.admin）があることを確認します。
  3. デプロイの作成または更新に最後に使用されたサービス アカウントがまだ有効であることを確認します。Infra Manager は、このサービス アカウントを使用してデプロイを削除します。
  4. Infra Manager がデプロイの作成または更新に使用した Terraform 構成が引き続き有効であることを確認します。Infra Manager は、この構成を使用してデプロイを削除します。
  5. 削除する Infra Manager デプロイを特定します。
  6. サービス アカウントに、指定されたプロジェクトとロケーションのリソースを削除するために必要な IAM 権限があることを確認します。

構成に固有の権限を付与する

特定のデプロイで Google Cloud リソースを削除するには、Infra Manager の呼び出しに使用するサービス アカウントに、削除対象に固有の権限が必要です。

これらの権限は、Infra Manager サービスを使用するために必要な権限に加えて必要です。

Google Cloud リソースの権限を付与し、必要なプロジェクトにアクセスできるようにする方法については、サービス アカウントを構成するをご覧ください。

デプロイメントの削除

Infra Manager デプロイが作成されると、Infra Manager はデプロイ、デプロイされた Terraform 構成、状態ファイルに関するメタデータを保存します。

デプロイを削除すると、このメタデータとファイルが削除されます。デプロイによってプロビジョニングされたリソースを削除することも、これらのリソースを保持することもできます。

プロビジョニングされたリソースを削除する

デプロイ メタデータを削除し、プロビジョニングされたリソースを削除するには:

  1. 必要に応じて、デプロイによってプロビジョニングされたリソースを一覧表示します。

    gcloud infra-manager resources list --revision=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID

    次のように置き換えます。

    • PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
    • LOCATION: Infra Manager が実行されるロケーション。有効なロケーションのリストについては、Infrastructure Manager のロケーションをご覧ください。
    • DEPLOYMENT_ID: 指定するデプロイ識別子。デプロイ識別子の制約の詳細については、デプロイ名をご覧ください。
    • REVISION_ID: デプロイの特定のリビジョンを表すリビジョン ID。リビジョン ID の制約の詳細については、デプロイ名をご覧ください。

  2. リソースの削除をプレビューします。詳細については、デプロイの削除をプレビューするをご覧ください。

  3. デプロイメントとプロビジョニングされたリソースを削除します。

    gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

    次のように置き換えます。

    • PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
    • LOCATION: Infra Manager が実行されるロケーション。有効なロケーションのリストについては、Infrastructure Manager のロケーションをご覧ください。
    • DEPLOYMENT_ID: 指定するデプロイ識別子。デプロイ識別子の制約の詳細については、デプロイ名をご覧ください。

プロビジョニングされたリソースを保持する

デプロイを削除して、デプロイによってプロビジョニングされた Google Cloud リソースを保持することもできます。

たとえば、 Google Cloud用の Terraform ブループリントとモジュールから構成をデプロイします。デプロイ後は、Infrastructure as Code（IaC）を使用せずに、コンソールでリソースを管理します。この場合、デプロイのメタデータを使用しないため、デプロイを削除することをおすすめします。

デプロイ メタデータを削除して、プロビジョニングされたリソースを保持するには:

gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
    --delete-policy=abandon

次のように置き換えます。

  • PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
  • LOCATION: Infra Manager が実行されるロケーション。有効なロケーションのリストについては、Infrastructure Manager のロケーションをご覧ください。
  • DEPLOYMENT_ID: 指定するデプロイ識別子。デプロイ識別子の制約の詳細については、デプロイ名をご覧ください。

次のステップ