このページでは、Infrastructure Manager によってプロビジョニングされたリソースに関する情報を表示する方法について説明します。
デプロイを更新または削除する前に、リソースを表示して状態を確認したり、デプロイに存在するリソースを確認したりできます。
Infrastructure Manager が Terraform 構成をデプロイすると、サービスは構成で定義されている Google Cloud リソースをプロビジョニングして構成します。これらのリソースのメタデータは Terraform 状態ファイルにあり、Infra Manager はデプロイとリビジョンごとにこのファイルを保存します。
状態ファイルには、Infra Manager によってプロビジョニングされたリソースに関する情報が含まれています。状態ファイルと Infra Manager には、これらのリソースが変更された場合の情報は保存されません(Infra Manager リビジョンによって変更された場合を除く)。
たとえば、Infra Manager を使用してロードバランサをデプロイし、 Google Cloud コンソールを使用してロードバランサを変更できます。この場合、Infra Manager には、最初にプロビジョニングされたロードバランサに関する情報はありますが、 Google Cloud コンソールで行った変更に関する情報はありません。
デプロイ名または状態に関する情報については、デプロイを表示するをご覧ください。
始める前に
- Infra Manager が有効になっていることを確認します。
- サービス アカウントがあることを確認します。
- デプロイメントを表示するために必要な IAM 権限があることを確認します。
roles/config.admin
またはroles/config.viewer
Deployment によってプロビジョニングされたリソースを一覧表示する
デプロイによってプロビジョニングされたリソースを一覧表示するには:
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: リソースのデプロイのデプロイ ID。
- REVISION_ID: 表示しているリビジョンのリビジョン ID。
リソースのリストをフィルタする
リソースのリストをフィルタするには:
gcloud infra-manager resources list --revision=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID --filter=EXPRESSION
次のように置き換えます。
- PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
- LOCATION: Infra Manager が実行されるロケーション。有効なロケーションの一覧については、Infrastructure Manager のロケーションをご覧ください。
- DEPLOYMENT_ID: リソースのデプロイのデプロイ ID。
- REVISION_ID: 表示およびフィルタリングするリビジョンのリビジョン ID。
- EXPRESSION: フィルタする式。サポートされている式は次のとおりです。
terraformInfo.address (string)
terraformInfo.type (string)
terraformInfo.id (string)
state (string)
:STATE_UNSPECIFIED
、PLANNED
、IN_PROGRESS
、RECONCILED
、FAILED
のいずれかintent(string)
:INTENT_UNSPECIFIED
、CREATE
、UPDATE
、DELETE
、RECREATE
、UNCHANGED
のいずれかcaiAssets.fullResourceName
(地図)caiAssets.type
(地図)
リソースのリストを並べ替える
リソースのリストを並べ替えるには:
gcloud infra-manager resources list --revision=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID --sort-by=[FIELD]
以下のように置き換えます。
- PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
- LOCATION: Infra Manager が実行されるロケーション。有効なロケーションの一覧については、Infrastructure Manager のロケーションをご覧ください。
- DEPLOYMENT_ID: リソースのデプロイのデプロイ ID。
- REVISION_ID: 表示および並べ替えるリビジョンのリビジョン ID。
- FIELD: 並べ替えに使用されるフィールド。サポートされているフィールドは次のとおりです。
name
terraformInfo.address
terraformInfo.type
terraformInfo.id
リソースの詳細を表示する
特定のリソースの詳細を表示するには、リソース ID を使用します。
gcloud infra-manager resources describe projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID/resources/RESOURCE_ID
以下のように置き換えます。
- PROJECT_ID: Infrastructure Manager が実行されるプロジェクト ID。
- LOCATION: Infra Manager が実行されるロケーション。有効なロケーションの一覧については、Infrastructure Manager のロケーションをご覧ください。
- DEPLOYMENT_ID: リソースのデプロイのデプロイ ID。
- REVISION_ID: リソースをデプロイした特定のリビジョンのリビジョン ID。
- RESOURCE_ID: 表示しているリソースのリソース ID。
次のステップ
- Google Cloudで Terraform を使用する方法の詳細を確認する。
- デプロイを自動化する。
- デプロイメントを更新する。
- デプロイの状態を表示する。
- デプロイメントを削除する。