App Lifecycle Manager サービス アカウント

App Lifecycle Manager を使用すると、Google 管理のサービス エージェント、ユーザー管理の動作用サービス アカウント、オプションのアーティファクト作成サービス アカウントを分離することで、Google Cloud プロジェクト間でシングルテナント デプロイとマルチテナント デプロイを分離できます。必要な Identity and Access Management(IAM)ロールを各サービス アカウントに付与すると、最小権限の原則に従い、ビルド パイプラインとデプロイ パイプラインを保護できます。

App Lifecycle Manager サービス アカウントの概要

App Lifecycle Manager は、Google 管理のサービス アカウントとユーザー管理のサービス アカウントを組み合わせて使用します。

  • App Lifecycle Manager サービス アカウント(Google 管理): このアカウントは、最初の SaaS オファリング リソースを作成した後に自動的に作成されます。これは Google によって管理され、ユニットのプロビジョニング中に他の Google Cloud サービスとやり取りするなど、ユーザーに代わってアクションを実行します。

  • 作動サービス アカウント(ユーザー管理): このサービス アカウントは、ユーザーが作成して管理します。App Lifecycle Manager(Infrastructure Manager 経由)は、このアカウントを使用して、ユニットのプロビジョニングまたは更新時に Terraform 構成を実行します。このアカウントは、Terraform 構成で定義されたリソースを作成および管理するための ID として機能します。作動サービス アカウントの権限は、Terraform 構成が管理するリソースに直接関連付けられています。

    複数のアクチュエーション サービス アカウントを使用できます。テナントごとに専用のアクチュエーション サービス アカウントを使用することをおすすめします。

  • 省略可: アーティファクト作成サービス アカウント(ユーザー管理): このサービス アカウントは、Open Container Initiative(OCI)アーティファクトとしてパッケージ化された Terraform 構成のビルドとアップロードに使用されます。これは多くの場合、Cloud Build サービス アカウントですが、SaaS サービスに適切な権限を持つサービス アカウントであれば、どのサービス アカウントでもかまいません。

App Lifecycle Manager サービス アカウント(Google 管理)

App Lifecycle Manager サービス アカウントは、App Lifecycle Manager がプロジェクト内でオペレーションを実行するために使用する、Google が管理するサービス エージェントです。

このサービス アカウントは、最初の App Lifecycle Manager リソースを作成するときに自動的にプロビジョニングされます。App Lifecycle Manager サービス アカウントは、次の形式で参照されます。

service-PROJECT_NUMBER@gcp-sa-saasservicemgmt.iam.gserviceaccount.com

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

  • PROJECT_NUMBER: プロジェクトの番号。

作動用のサービス アカウント(ユーザー管理)

作動サービス アカウントは、ユーザーが作成する必要があるユーザー管理のサービス アカウントです。App Lifecycle Manager(Infra Manager 経由)は、このサービス アカウントを使用して Terraform 構成を実行します。これは、Terraform 構成で定義されたリソースを作成、変更、削除する ID です。

このサービス アカウントは、プロデューサー プロジェクトまたはテナント プロジェクト内に作成する必要があります。

作動用のサービス アカウントの入力変数

Google Cloud CLI を使用してユニットを作成する場合は、Terraform 構成の Key-Value ペア入力変数として作動サービス アカウントを指定する必要があります。

  • 名前: actuation_sa

  • 変数タイプ: String

  • 変数値: アクチュエーション サービス アカウントのメールアドレス:

    my-actuation-sa@my-identifier.iam.gserviceaccount.com
    

必要な権限

作動サービス アカウントには、Terraform 構成で定義されたリソースを管理するための十分な権限が必要です。少なくとも、次のロールが必要です。

  • roles/iam.serviceAccountTokenCreator: サービス アカウントが認証用のトークンを生成できるようにします。

  • roles/config.admin: Infra Manager リソースに対する完全な制御権を付与します。

  • roles/storage.admin: Cloud Storage の完全な制御を付与します。

作動サービス アカウントには、アプリケーションで使用される特定の Google Cloud リソースを作成して管理する権限も必要です。

次に例を示します。

  • Terraform 構成で Google Kubernetes Engine(GKE)クラスタを作成する場合は、サービス アカウントに適切な GKE ロール(roles/container.admin など)が必要です。

  • Terraform 構成で Compute Engine インスタンスを作成する場合は、サービス アカウントに roles/compute.admin ロールが必要です。

  • Terraform 構成で Cloud SQL インスタンスを作成する場合は、サービス アカウントに適切な Cloud SQL ロール(roles/cloudsql.admin など)が必要です。

Terraform 構成で使用する各 Google Cloud リソースのドキュメントを参照して、必要な権限を確認してください。アプリケーションが機能するために必要な最小権限を付与します。

アーティファクト作成サービス アカウント(ユーザー管理)

アーティファクト作成サービス アカウントは、ビルドシステム(Cloud Build など)を使用して Terraform アーティファクトをパッケージ化し、Artifact Registry にアップロードするために作成するユーザー管理のサービス アカウントです。

このサービス アカウントは、App Lifecycle Manager と作動サービス アカウントとは別のもので、Terraform コードをビルドして、生成されたアーティファクトを Artifact Registry に push します。多くの場合、これは Cloud Build サービス アカウントです。

アーティファクトの手動作成

Terraform アーティファクトを手動でビルドしてアップロードする場合(docker build と docker push を直接使用する場合など)、アーティファクト作成サービス アカウントは必要ありません。

代わりに、独自の認証情報または必要な Artifact Registry 権限を持つサービス アカウントを使用して認証できます。

必要な権限

Cloud Build を使用している場合、通常、Cloud Build サービス アカウントには次のロールが必要です。

  • roles/artifactregistry.writer: アーティファクトを Artifact Registry に push します。

  • roles/artifactregistry.repoAdmin: Artifact Registry リポジトリを管理します。

  • roles/storage.admin: Cloud Storage バケットを管理します。

  • roles/developerconnect.admin: Developer Connect を使用する権限。

  • roles/developerconnect.readTokenAccessor: Developer Connect 読み取りトークンを取得する権限。

  • roles/logging.logWriter: ログを書き込む権限。

  • roles/cloudbuild.builds.builder: Developer Connect を使用して Terraform 構成をデプロイする場合にビルドを実行します。

  • ビルドプロセスに必要なその他の権限(ソースコード リポジトリへのアクセスなど)。

次のステップ