デプロイ、リビジョン、プレビューの概要

このページでは、デプロイとリビジョンについて説明します。内容は次のとおりです。

  • 各デプロイ用に保存されたメタデータのリスト。
  • デプロイ名とリビジョン名の形式。

デプロイ

Infra Manager は、リソースをデプロイとして Google Cloud にプロビジョニングします。

デプロイでは、複数のロケーションと複数のプロジェクトに Google Cloud リソースをプロビジョニングできます。次のことに注意してください。

  • 特定のリソースは、ロケーションで使用可能である必要があります。たとえば、Cloud Run を利用できるロケーションの一覧については、Cloud Run のロケーションをご覧ください。
  • サービス アカウントには、指定されたプロジェクトにデプロイするために必要な権限が付与されている必要があります。詳細については、サービス アカウントを構成するをご覧ください。

デプロイのメタデータ

Infra Manager は、Infra Manager が実行されるプロジェクトとロケーションにストレージ バケットを作成します。デプロイが作成されると、Infrastructure Manager アーティファクトは gs://PROJECT_NUMBER-LOCATION-blueprint-config という名前のストレージ バケットに格納されます。

Infra Manager では、Terraform 構成を指す用語として「ブループリント」を使用します。

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

  • PROJECT_ID: Infra Manager が実行されているプロジェクト ID。
  • LOCATION: Infra Manager が実行されるロケーション。

ストレージ バケット内のデプロイ アーティファクトには、次のものが含まれます。

  • Cloud Build のログ。
  • Terraform ログ。
  • Terraform 構成のコピー。

Infra Manager は、Terraform 状態ファイルのコピーも保存します。ファイルへのアクセスなど、状態ファイルの詳細については、Terraform 状態ファイルを管理するをご覧ください。

リビジョンはデプロイのバージョンであるため、Infra Manager はこのデプロイ メタデータをリビジョンごとに保存します。

デプロイ ID

デプロイ ID は、デプロイ リソースのユーザー指定の識別子です。デプロイ ID を使用して、次の形式でデプロイを参照します。

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

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

  • PROJECT_ID は、Infra Manager が実行されるプロジェクト ID です。
  • LOCATION は、Infra Manager が実行されるロケーションです。有効なロケーションのリストについては、Infrastructure Manager のロケーションをご覧ください。
  • DEPLOYMENT_ID は、ユーザーが指定した名前であるデプロイ ID です。この ID は次の条件を満たしている必要があります。
    • 小文字、数字、ハイフンのみを使用する。
    • 先頭は小文字でなければなりません。
    • 末尾が数字または英小文字である
    • 文字列 archived-deployments または archived-previews にすることはできません
    • Infra Manager が実行されるプロジェクトとロケーション内で一意にする必要があります。

次に例を示します。

projects/my-project/locations/us-central1/deployments/my-deployment

リビジョン

リビジョンはデプロイのバージョンです。最初に Deployment を作成すると、この Deployment はリビジョンにもなり、リビジョン ID r-0 が割り当てられます。

リビジョン名

Infra Manager デプロイを作成すると、リビジョン ID r-0 が自動的に付与されます。デプロイを更新すると、Infrastructure Manager は識別子 r-1 を持つ新しいリビジョンを作成します。新しいリビジョンごとに、識別子は 1 ずつ増加します。リビジョン識別子は、Infrastructure Manager でのみ設定できます。

たとえば、リビジョン名は次のようになります。

projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1

プレビュー

プレビューには、特定の Terraform 構成をアクチュエートするアクションが記述されています。新しいデプロイを作成する前、またはデプロイを更新する前に、デプロイをプレビューして、プロビジョニングが予定されているリソースを確認できます。

メタデータをプレビューする

Infra Manager は、Infra Manager が実行されるプロジェクトとロケーションにストレージ バケットを作成します。プレビューが作成されると、Infra Manager アーティファクトは gs://PROJECT_NUMBER-LOCATION-blueprint-config という名前のストレージ バケットに格納されます。

新しいデプロイのプレビューの場合、メタデータは new-previews 接頭辞で整理されます。例: gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name

既存のデプロイの更新をプレビューすることもできます。既存のデプロイを対象とするこれらのプレビューの場合、アーティファクトはデプロイ アーティファクトと同じストレージ バケットに保存されます。gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID という名前のストレージ バケット。

Infrastructure Manager では、Terraform 構成を指す用語として「ブループリント」を使用します。

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

  • PROJECT_ID: Infra Manager が実行されているプロジェクト ID。
  • LOCATION: Infra Manager が実行されるロケーション。

ストレージ バケット内のプレビュー アーティファクトには、次のものが含まれます。

  • Cloud Build のログ。
  • Terraform ログ。
  • Terraform 構成のコピー。

プレビュー名

プレビュー名の形式は次のとおりです。

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

ここで

  • PROJECT_ID は、Infra Manager が実行されるプロジェクト ID です。
  • LOCATION は、Infra Manager が実行されるロケーションです。有効なロケーションのリストについては、Infrastructure Manager のロケーションをご覧ください。
  • PREVIEW_ID はプレビュー識別子で、ユーザーが指定した名前です。この名前は次の条件を満たす必要があります。
    • 小文字、数字、ハイフンのみを使用する。
    • 先頭は小文字でなければなりません。
    • 末尾が数字または英小文字である
    • 文字列 archived-deployments または archived-previews にすることはできません
    • Infra Manager が実行されるプロジェクトとロケーション内で一意にする必要があります。

次に例を示します。

projects/my-project/locations/us-central1/previews/my-preview

次のステップ