デプロイメントの削除

このページでは、Infrastructure Manager デプロイメントを削除する方法について説明します。

このページは、Terraform に精通していることを前提としています。詳細については、Terraform と Infrastructure Manager をご覧ください。

始める前に

  1. Infra Manager が有効になっていることを確認します。
  2. デプロイメントの作成に必要な IAM 権限（roles/config.admin）があることを確認します。
  3. デプロイの作成または更新に最後に使用したサービス アカウントがまだ有効であることを確認します。Infra Manager は、このサービス アカウントを使用してデプロイメントを削除します。
  4. Infrastructure 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 projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID

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

    • PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
    • LOCATION: Infra Manager が実行されるロケーション。有効なロケーションの一覧については、Infrastructure Manager のロケーションをご覧ください。
    • DEPLOYMENT_ID: 指定したデプロイ ID。デプロイ 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: 指定したデプロイ ID。デプロイ 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: 指定したデプロイ ID。デプロイ ID の制約について詳しくは、デプロイ名をご覧ください。

次のステップ