SaaS サービスを設計してデプロイする

Application Design Center と App Lifecycle Manager を使用すると、顧客ごとにインフラストラクチャを手動で構成することなく、マルチテナント SaaS の提供を標準化してスケーリングできます。再利用可能な Terraform モジュールを App Design Center で複合アプリケーション テンプレートに組み立て、それらのテンプレートを App Lifecycle Manager でマネージド SaaS サービスにパッケージ化します。

このチュートリアルでは、分離されたテナント環境をプロビジョニングし、段階的な更新とロールアウトを自動化します。このワークフローは、プラットフォーム エンジニア、エンタープライズ アーキテクト、DevOps オペレーターを対象としています。

目標

  • Cloud Run と Cloud Storage の Terraform モジュールを含む GitHub リポジトリを準備します。
  • Developer Connect を使用して GitHub リポジトリを Google Cloud にリンクします。
  • Terraform モジュールをインポートして、App Design Center でコンポーネント テンプレートを作成し、カタログ化します。
  • コンポーネント テンプレートを含む複合アプリケーション テンプレートを設計します。
  • テンプレートをパッケージ化し、App Lifecycle Manager でお客様の環境をデプロイします。
  • お客様の環境全体で段階的なロールアウトを自動化します。

費用

このドキュメントでは、課金対象である次の Google Cloudコンポーネントを使用します。

料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。

新規の Google Cloud ユーザーは無料トライアルをご利用いただける場合があります。

このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Developer Connect, Secret Manager, App Lifecycle Manager, Infrastructure Manager, and Cloud Run APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Developer Connect, Secret Manager, App Lifecycle Manager, Infrastructure Manager, and Cloud Run APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  8. プロジェクトに次の Identity and Access Management(IAM)ロールがあることを確認します。
    • 設定を行うには、Application Design Center 管理者(roles/designcenter.admin)と Service Usage 管理者(roles/serviceusage.serviceUsageAdmin)。
    • SaaS Service Management 管理者(roles/saasservicemgmt.admin)
    • Developer Connect 管理者(roles/developerconnect.admin)
    • サービス アカウントを作成して IAM ロールを付与するためのプロジェクト IAM 管理者(roles/resourcemanager.projectIamAdmin)またはセキュリティ管理者(roles/iam.securityAdmin)。
    • Cloud Run 管理者(roles/run.admin)
    • Storage 管理者(roles/storage.admin)
    • サービス アカウント管理者(roles/iam.serviceAccountAdmin)
  9. Google Cloud CLI をインストールして、初期化します。
    gcloud init
    beta コンポーネントがインストールされていることを確認します。
    gcloud components install beta
  10. 単一プロジェクトのアプリケーション管理境界を使用して、プロジェクトで Application Design Center の設定を完了します。この設定により、アプリケーション管理が有効になり、Terraform のストレージ バケットがプロビジョニングされ、default-space スペースと default-catalog カタログが作成されます。
  11. ローカルマシンに Git をインストールします。
  12. リポジトリを作成し、個人用アクセス トークンを生成する権限を持つ GitHub アカウントがあることを確認します。

環境とソース リポジトリを設定する

このチュートリアルの環境を設定するには、変数の値を指定して GitHub リポジトリを構成します。

チュートリアル変数を指定する

このチュートリアルとコマンド ターミナルで変数を設定します。

  1. このチュートリアルのコマンドを更新するには、次の変数を設定します。

    変数 説明 値
    PROJECT_ID Google Cloud プロジェクト ID PROJECT_ID
    REGION App Design Center リソース、Developer Connect、App Lifecycle Manager サービス、テナント インフラストラクチャのデプロイ リージョン us-central1
  2. コマンド ターミナルで、アクティブな Google Cloud プロジェクトを構成します。

    gcloud config set project PROJECT_ID
    
  3. Google Cloud プロジェクト番号を取得して、環境変数に保存します。

    PROJECT_NUM=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
    

Terraform 構成ファイルを作成する

Cloud Run と Cloud Storage のモジュラー Terraform 定義を作成します。これらのモジュールは、後で App Design Center にインポートして、再利用可能なアーキテクチャ コンポーネントにパッケージ化します。

  1. Terraform モジュールのローカル ディレクトリ構造を作成します。

    mkdir -p adc-alm-starter/infra/cloud-run
    mkdir -p adc-alm-starter/infra/cloud-storage
    cd adc-alm-starter
    
  2. infra/cloud-run/main.tf で、Cloud Run モジュール定義を作成します。

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = ">= 5.0.0"
        }
      }
    }
    
    variable "project_id" {
      type        = string
      description = "The Google Cloud project ID."
    }
    
    variable "region" {
      type        = string
      description = "The deployment region."
      default     = "us-central1"
    }
    
    variable "service_name" {
      type        = string
      description = "Name of the Cloud Run service."
      default     = "sample-app"
    }
    
    variable "bucket_name" {
      type        = string
      description = "Name of the Cloud Storage bucket to connect."
      default     = ""
    }
    
    resource "google_service_account" "app_sa" {
      account_id   = "${var.service_name}-sa"
      display_name = "Service Account for ${var.service_name}"
      project      = var.project_id
    }
    
    resource "google_cloud_run_v2_service" "app_service" {
      name                = var.service_name
      location            = var.region
      project             = var.project_id
      deletion_protection = false
    
      template {
        service_account = google_service_account.app_sa.email
        containers {
          image = "us-docker.pkg.dev/cloudrun/container/hello"
          env {
            name  = "STORAGE_BUCKET"
            value = var.bucket_name
          }
          resources {
            limits = {
              cpu    = "1"
              memory = "512Mi"
            }
          }
        }
      }
    }
    
    output "service_url" {
      description = "URL of the deployed Cloud Run service."
      value       = google_cloud_run_v2_service.app_service.uri
    }
    
    output "service_account_email" {
      description = "Email of the Cloud Run service account."
      value       = google_service_account.app_sa.email
    }
    
  3. infra/cloud-run/metadata.yaml で、モジュールのメタデータ定義を作成します。

    apiVersion: blueprints.cloud.google.com/v1alpha1
    kind: BlueprintMetadata
    metadata:
      name: cloud-run-component
    spec:
      info:
        title: Cloud Run Component
        version: 0.1.0
        actuationTool:
          flavor: Terraform
          version: ">= 1.5.0"
      interfaces:
        variables:
          - name: project_id
            description: The Google Cloud project ID.
            varType: string
            required: true
          - name: region
            description: The deployment region.
            varType: string
            defaultValue: us-central1
          - name: service_name
            description: Name of the Cloud Run service.
            varType: string
            defaultValue: sample-app
          - name: bucket_name
            description: Name of the Cloud Storage bucket to connect.
            varType: string
            defaultValue: ""
        outputs:
          - name: service_url
            description: URL of the deployed Cloud Run service.
          - name: service_account_email
            description: Email of the Cloud Run service account.
    
  4. infra/cloud-storage/main.tf で、Cloud Storage モジュール定義を作成します。

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = ">= 5.0.0"
        }
        random = {
          source  = "hashicorp/random"
          version = ">= 3.5.0"
        }
      }
    }
    
    variable "project_id" {
      type        = string
      description = "The Google Cloud project ID."
    }
    
    variable "region" {
      type        = string
      description = "The deployment region."
      default     = "us-central1"
    }
    
    variable "bucket_name_prefix" {
      type        = string
      description = "Prefix for the Cloud Storage bucket."
      default     = "app-data"
    }
    
    variable "writer_service_account" {
      type        = string
      description = "Service account email granted objectAdmin permissions."
      default     = ""
    }
    
    resource "random_id" "bucket_suffix" {
      byte_length = 4
    }
    
    resource "google_storage_bucket" "bucket" {
      name                        = "${var.bucket_name_prefix}-${random_id.bucket_suffix.hex}"
      location                    = var.region
      project                     = var.project_id
      uniform_bucket_level_access = true
      force_destroy               = true
    }
    
    resource "google_storage_bucket_iam_member" "writer_grant" {
      count  = var.writer_service_account != "" ? 1 : 0
      bucket = google_storage_bucket.bucket.name
      role   = "roles/storage.objectAdmin"
      member = "serviceAccount:${var.writer_service_account}"
    }
    
    output "bucket_name" {
      description = "Name of the created storage bucket."
      value       = google_storage_bucket.bucket.name
    }
    
  5. infra/cloud-storage/metadata.yaml で、モジュールのメタデータ定義を作成します。

    apiVersion: blueprints.cloud.google.com/v1alpha1
    kind: BlueprintMetadata
    metadata:
      name: cloud-storage-component
    spec:
      info:
        title: Cloud Storage Component
        version: 0.1.0
        actuationTool:
          flavor: Terraform
          version: ">= 1.5.0"
      interfaces:
        variables:
          - name: project_id
            description: The Google Cloud project ID.
            varType: string
            required: true
          - name: region
            description: The deployment region.
            varType: string
            defaultValue: us-central1
          - name: bucket_name_prefix
            description: Prefix for the Cloud Storage bucket.
            varType: string
            defaultValue: app-data
          - name: writer_service_account
            description: Service account email granted objectAdmin permissions.
            varType: string
            defaultValue: ""
        outputs:
          - name: bucket_name
            description: Name of the created storage bucket.
    

Terraform を GitHub に push する

Terraform 構成を GitHub リポジトリに commit し、Developer Connect を介してリポジトリを Google Cloud に接続します。この接続により、App Design Center はソース管理からインフラストラクチャ リビジョンを直接インポートするための安全なアクセス権を取得します。

  1. ウェブブラウザで、adc-alm-starter という名前の新しい GitHub リポジトリを作成します。

  2. GitHub で、git push コマンドを認証するためのきめ細かい個人アクセス トークンを作成します。adc-alm-starter リポジトリを選択し、コンテンツ: 読み取りと書き込みの権限を付与します。

  3. コマンド ターミナルで、adc-alm-starter ディレクトリで Git を初期化し、ファイルを commit して GitHub に push します。

    cd adc-alm-starter
    git init
    git add infra/
    git commit -m "feat: initialize Cloud Run and Cloud Storage modules"
    git branch -M main
    git remote add origin https://github.com/GITHUB_USER_OR_ORG/adc-alm-starter.git
    git push -u origin main
    

    認証を求められたら、GitHub のユーザー名と個人用アクセス トークンを入力します。

  4. Google Cloud コンソールで、[Developer Connect] ページに移動します。

    Developer Connect に移動

  5. GitHub アカウントの us-central1 リージョンに接続を作成し、リポジトリをリンクします。詳細な手順については、GitHub に接続するをご覧ください。

  6. リンクされたリポジトリの接続 ID と Git リポジトリ リンク ID を特定し、次の変数を更新します。

    • CONNECTION_ID: Developer Connect 接続識別子。
    • GIT_REPO_LINK_ID: リンクされた Git リポジトリの ID。

App Design Center でテンプレートを作成する

Google Cloud インフラストラクチャを設計するには、Terraform モジュールをコンポーネント テンプレートとして App Design Center にインポートします。次に、コンポーネントを含む複合アプリケーション テンプレートを作成します。

スペースとカタログを確認する

Google Cloud コンソールで App Design Center の設定を完了している場合は、デフォルトのスペースとカタログが自動的に作成されています。

gcloud CLI で設定を完了した場合は、次の操作を行います。

  1. default-space がリージョンに存在することを確認します。

    gcloud design-center spaces describe "default-space" \
        --location="us-central1"
    

    default-space は、App Design Center のスペース ID に置き換えます。

  2. スペースが存在しない場合は、スペースとカタログを作成します。

    gcloud design-center spaces create "default-space" \
        --location="us-central1" \
        --display-name="Default Space"
    
    gcloud design-center spaces catalogs create "default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --display-name="Default Catalog"
    

    default-catalog は、カタログ ID に置き換えます。

コンポーネント テンプレートを作成する

コンポーネント テンプレートは、個々の Terraform モジュールを、マルチサービス アプリケーション テンプレートに追加できる構成要素に変換します。

Git リポジトリの Terraform モジュールに基づいてコンポーネント テンプレートを作成します。

  1. Cloud Run のカタログ テンプレートを作成します。

    gcloud design-center spaces catalogs templates create "cloud-run-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --display-name="Cloud Run Component" \
        --template-category=component-template
    

    cloud-run-component は、Cloud Run コンポーネント テンプレートの識別子に置き換えます。

  2. Cloud Storage のカタログ テンプレートを作成します。

    gcloud design-center spaces catalogs templates create "cloud-storage-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --display-name="Cloud Storage Component" \
        --template-category=component-template
    

    cloud-storage-component は、Cloud Storage コンポーネント テンプレート識別子に置き換えます。

  3. Git リポジトリから Cloud Run Terraform モジュールをインポートして、テンプレート リビジョンを作成します。

    gcloud design-center spaces catalogs templates revisions create r-1 \
        --template="cloud-run-component" \
        --catalog="default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --developer-connect-repo="projects/PROJECT_ID/locations/us-central1/connections/CONNECTION_ID/gitRepositoryLinks/GIT_REPO_LINK_ID" \
        --developer-connect-repo-dir="infra/cloud-run" \
        --developer-connect-repo-ref="refs/heads/main"
    

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

    • CONNECTION_ID: Developer Connect 接続 ID。
    • GIT_REPO_LINK_ID: リンクされた Git リポジトリのリンク ID。
  4. Git リポジトリから Cloud Storage Terraform モジュールをインポートして、テンプレート リビジョンを作成します。

    gcloud design-center spaces catalogs templates revisions create r-1 \
        --template="cloud-storage-component" \
        --catalog="default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --developer-connect-repo="projects/PROJECT_ID/locations/us-central1/connections/CONNECTION_ID/gitRepositoryLinks/GIT_REPO_LINK_ID" \
        --developer-connect-repo-dir="infra/cloud-storage" \
        --developer-connect-repo-ref="refs/heads/main"
    

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

    • CONNECTION_ID: Developer Connect 接続 ID。
    • GIT_REPO_LINK_ID: リンクされた Git リポジトリのリンク ID。
  5. スペース内の共有済みテンプレートを一覧表示して、共有済みテンプレート ID を取得します。

    gcloud design-center spaces shared-templates list \
        --space="default-space" \
        --location="us-central1"
    

    コマンド出力で、cloud-run-component と cloud-storage-component の両方の name フィールド(projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/SHARED_TEMPLATE_ID)から SHARED_TEMPLATE_ID セグメントをメモします。

複合アプリケーション テンプレートを作成する

コンポーネント テンプレートを複合アプリケーション テンプレートに結合し、パラメータ接続を構成します。App Lifecycle Manager は、複合テンプレートを使用して、アプリケーション トポロジを SaaS サービスとして管理します。出力と入力を指定して、Cloud Run サービスがバケット名と Cloud Storage へのアクセスに必要な IAM 権限を自動的に受け取るようにします。

  1. 複合アプリケーション テンプレートを作成します。

    gcloud design-center spaces application-templates create "run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --display-name="Cloud Run and Storage Multi-Tenant Application" \
        --composition-type=composite
    

    run-storage-app は、複合アプリケーション テンプレート ID に置き換えます。

  2. アプリケーション テンプレートに Cloud Run コンポーネントを追加します。

    gcloud design-center spaces application-templates components create cloud-run-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --shared-template-revision-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/RUN_SHARED_TEMPLATE_ID/revisions/r-1"
    

    RUN_SHARED_TEMPLATE_ID は、取得した cloud-run-component 共有済みテンプレート ID に置き換えます。

  3. Cloud Storage コンポーネントをアプリケーション テンプレートに追加します。

    gcloud design-center spaces application-templates components create cloud-storage-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --shared-template-revision-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/STORAGE_SHARED_TEMPLATE_ID/revisions/r-1"
    

    STORAGE_SHARED_TEMPLATE_ID は、取得した cloud-storage-component 共有済みテンプレート ID に置き換えます。

  4. Cloud Run サービスから Cloud Storage バケットへの接続を作成します。これにより、バケット出力がサービス環境変数にリンクされ、サービス アカウントに IAM アクセス権が付与されます。

    gcloud design-center spaces application-templates components connections create run-to-storage \
        --component=cloud-run-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --destination-component-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app/components/cloud-storage-comp" \
        --source-component-parameters='[{"key": "bucket_name", "value": "module.cloud-storage-comp.bucket_name"}]' \
        --destination-component-parameters='[{"key": "writer_service_account", "value": "module.cloud-run-comp.service_account_email"}]'
    
  5. アプリケーション テンプレートを commit して、不変のテンプレート リビジョンを生成します。

    gcloud design-center spaces application-templates commit "run-storage-app" \
        --space="default-space" \
        --location="us-central1"
    

    コマンド出力で、生成されたリビジョン ID(r-1 など)を確認します。この ID は、App Lifecycle Manager で SaaS サービスを作成するときに参照します。


App Lifecycle Manager を使用して顧客環境をデプロイする

App Lifecycle Manager を使用して、アプリケーション テンプレートをデプロイ可能なプロダクトに変換し、顧客ごとに専用の環境をプロビジョニングします。

アプリケーション テンプレートをパッケージ化する

テンプレート リビジョンを App Lifecycle Manager に登録して、デプロイ可能な SaaS サービスを作成します。

  1. us-central1 で SaaS サービスを作成します。

    gcloud beta app-lifecycle-manager saas create "saas-run-storage" \
        --location="us-central1" \
        --locations=name="us-central1" \
        --application-template="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app" \
        --application-template-revision="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app/revisions/r-1"
    

    saas-run-storage は、SaaS サービス ID に置き換えます。

  2. 生成されたリリースを一覧表示して、リリース ID、ユニットの種類、入力変数を取得します。

    gcloud beta app-lifecycle-manager releases list \
        --location="us-central1"
    

    App Lifecycle Manager は、複合テンプレートのブループリントを非同期でビルドしてパッケージ化します。リストが空の場合は、数分待ってからコマンドを再実行します。

    このコマンドは、次の情報を出力します。

    • name フィールド(例: projects/PROJECT_ID/locations/us-central1/releases/r-r-1-06c6a0)。末尾のセグメントは RELEASE_ID(r-r-1-06c6a0 など)です。
    • unitKind フィールド(例: projects/PROJECT_ID/locations/us-central1/unitKinds/u-native-components-e97e0c)。末尾のセグメントは UNIT_KIND_ID(u-native-components-e97e0c など)です。

デプロイ サービス アカウントを作成する

App Lifecycle Manager にリソースをプロビジョニングする権限を付与するサービス アカウントを作成します。

  1. アクチュエーション サービス アカウントを作成します。

    gcloud iam service-accounts create "tenant-actuation-sa" \
        --display-name="Tenant Actuation Service Account"
    

    tenant-actuation-sa は、アクチュエーション サービス アカウントの名前に置き換えます。

  2. サービス アカウントのメールアドレスを作成し、App Lifecycle Manager サービス エージェントの ID を取得します。

    ACTUATION_SA="tenant-actuation-sa@PROJECT_ID.iam.gserviceaccount.com"
    ALM_P4SA="service-${PROJECT_NUM}@gcp-sa-saasservicemgmt.iam.gserviceaccount.com"
    INFRA_MANAGER_P4SA="service-${PROJECT_NUM}@gcp-sa-config.iam.gserviceaccount.com"
    
  3. テナント インフラストラクチャの作成と管理に必要なロールを、作動サービス アカウントに付与します。

    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/run.admin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/storage.admin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/iam.serviceAccountAdmin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/config.admin" \
        --condition=None
    
  4. App Lifecycle Manager と Infra Manager のサービス エージェントに、動作用のサービス アカウントの権限を借用する権限を付与します。

    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${ALM_P4SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    
    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${ALM_P4SA}" \
        --role="roles/iam.serviceAccountTokenCreator" \
        --condition=None
    
    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${INFRA_MANAGER_P4SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    

お客様の環境をデプロイする

お客様の環境を作成し、専用インフラストラクチャのデプロイをトリガーします。

  1. 生成されたユニットの種類を使用して、分離されたお客様のテナントを表す環境 Unit を作成します。

    gcloud beta app-lifecycle-manager units create "tenant-1" \
        --location="us-central1" \
        --unit-kind="UNIT_KIND_ID"
    

    tenant-1 は、テナント ユニット ID に置き換えます。

  2. ユニット オペレーションをトリガーして、テナント インフラストラクチャをプロビジョニングします。

    gcloud beta app-lifecycle-manager unit-operations create provision-tenant-1 \
        --location="us-central1" \
        --unit="projects/PROJECT_ID/locations/us-central1/units/tenant-1" \
        --provision \
        --provision-release="RELEASE_ID" \
        --provision-input-variables=variable=project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=project_number,value="${PROJECT_NUM}",type=string \
        --provision-input-variables=variable=actuation_sa,value="${ACTUATION_SA}",type=string \
        --provision-input-variables=variable=cloud-run-comp_project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=cloud-run-comp_region,value="us-central1",type=string \
        --provision-input-variables=variable=cloud-storage-comp_project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=cloud-storage-comp_region,value="us-central1",type=string
    
  3. ユニット オペレーションを記述して、SUCCEEDED に達するまでプロビジョニング ステータスをモニタリングします。

    gcloud beta app-lifecycle-manager unit-operations describe provision-tenant-1 \
        --location="us-central1"
    

お客様の環境全体で更新を自動化する

ロールアウトを使用して、すべてのお客様の環境にアプリケーションの更新を安全にデプロイします。

更新戦略を選択する

更新を顧客環境に配信する方法を定義します。たとえば、すべてを一度にデプロイするか、段階的にデプロイするかを定義します。

  1. RolloutKind を作成して、ユニットのオーケストレーション戦略を定義します。

    gcloud beta app-lifecycle-manager rollout-kinds create "progressive-rollout" \
        --location="us-central1" \
        --unit-kind="projects/PROJECT_ID/locations/us-central1/unitKinds/UNIT_KIND_ID" \
        --rollout-orchestration-strategy="Google.Cloud.Simple.AllAtOnce"
    

    progressive-rollout は、ロールアウトの種類識別子に置き換えます。

アップデートをデプロイして追跡する

ロールアウトを開始し、デプロイが完了するまで進行状況をモニタリングします。

  1. ロールアウトをトリガーして、対象となるテナンシー ユニットにリリースをデプロイします。

    gcloud beta app-lifecycle-manager rollouts create "rollout-v1" \
        --location="us-central1" \
        --rollout-kind="projects/PROJECT_ID/locations/us-central1/rolloutKinds/progressive-rollout" \
        --release="projects/PROJECT_ID/locations/us-central1/releases/RELEASE_ID"
    

    rollout-v1 は、ロールアウトの ID に置き換えます。

  2. ロールアウトを記述して、アクティブな実行を検査し、ステータスが SUCCEEDED に達していることを確認します。

    gcloud beta app-lifecycle-manager rollouts describe "rollout-v1" \
        --location="us-central1"
    

    ロールアウトの出力により、テナンシー ユニットがターゲット テンプレート リビジョンに更新されたことを確認できます。

クリーンアップ

このチュートリアルで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、リソースを含むプロジェクトを削除するか、プロジェクトを維持して個々のリソースを削除します。

プロジェクトを削除する

Google Cloud プロジェクトを削除する:

gcloud projects delete PROJECT_ID

リソースを個別に削除する

チュートリアル リソースを既存のプロジェクトにデプロイした場合は、予期しない課金を防ぐために、依存関係の逆順で個々のリソースを削除します。

  1. お客様の環境インフラストラクチャのプロビジョニングを解除し、完了するまで待ちます。

    gcloud beta app-lifecycle-manager unit-operations create deprovision-tenant-1 \
        --location="us-central1" \
        --unit="projects/PROJECT_ID/locations/us-central1/units/tenant-1" \
        --deprovision
    
    gcloud beta app-lifecycle-manager unit-operations describe deprovision-tenant-1 \
        --location="us-central1"
    
  2. App Lifecycle Manager のお客様環境を削除します。

    gcloud beta app-lifecycle-manager units delete "tenant-1" \
        --location="us-central1" \
        --quiet
    
  3. App Lifecycle Manager のロールアウト リソースとリリース リソースを依存関係の逆順で削除します。

    gcloud beta app-lifecycle-manager rollouts delete "rollout-v1" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager rollout-kinds delete "progressive-rollout" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager releases delete "RELEASE_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager unit-kinds delete "UNIT_KIND_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager saas delete "saas-run-storage" \
        --location="us-central1" \
        --quiet
    
  4. App Design Center のアプリケーション テンプレート、カタログ エントリ、スペースを削除します。

    gcloud design-center spaces application-templates delete "run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces catalogs templates delete "cloud-run-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces catalogs templates delete "cloud-storage-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces delete "default-space" \
        --location="us-central1" \
        --force \
        --quiet
    
  5. Developer Connect Git リポジトリのリンクと接続を削除します。

    gcloud developer-connect connections git-repository-links delete "GIT_REPO_LINK_ID" \
        --connection="CONNECTION_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud developer-connect connections delete "CONNECTION_ID" \
        --location="us-central1" \
        --quiet
    
  6. アクチュエーション用のサービス アカウントを削除します。

    gcloud iam service-accounts delete "${ACTUATION_SA}" \
        --quiet
    

次のステップ