サービス アカウントにロールを付与する

アプリケーションをプレビューしてデプロイするときに、既存のサービス アカウントを使用できます。また、Application Design Center でサービス アカウントを自動的に作成することもできます。

独自のサービス アカウントを使用してアプリケーションをデプロイするには、次のような必要な Identity and Access Management のロールと権限を付与する必要があります。

  • サービス アカウントとユーザー アカウントに IAM ポリシー バインディングを追加します。
  • 各リソースのデプロイに必要なロールをサービス アカウントに付与します。
  • サービス アカウントが作成されたプロジェクトの外部にデプロイするための権限をサービス アカウントに追加します。
  • 組織のポリシーを更新して、あるプロジェクトでサービス アカウントを作成し、それを使用して別のプロジェクトにリソースをデプロイできるようにします。

サービス アカウントを構成する

サービス アカウントを構成する手順は次のとおりです。

  1. サービス アカウントのサービス アカウント ユーザーのロール(roles/iam.serviceAccountUser)を、管理プロジェクトの App Design Center サービス エージェントに付与します。

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
        --member="serviceAccount:service-MANAGEMENT_PROJECT_NUMBER@gcp-sa-designcenter.iam.gserviceaccount.com" \
        --role="roles/iam.serviceAccountUser"
    

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

    • SERVICE_ACCOUNT_EMAIL: サービス アカウントのメールアドレス(my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com など)。
    • SERVICE_ACCOUNT_PROJECT_ID: サービス アカウントを含むプロジェクトのプロジェクト ID。
    • MANAGEMENT_PROJECT_NUMBER: スペースを含む管理プロジェクトのプロジェクト番号。
  2. アプリケーションをデプロイするユーザーに、サービス アカウントの roles/iam.serviceAccountUser ロールを付与します。

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
        --member="user:USER_EMAIL" \
        --role="roles/iam.serviceAccountUser"
    

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

    • SERVICE_ACCOUNT_EMAIL: サービス アカウントのメールアドレス(my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com など)。
    • USER_EMAIL: デプロイを行うユーザーのメールアドレス。
  3. スペースを含む管理プロジェクトで、App Hub 編集者(roles/apphub.editor)と Cloud Infrastructure Manager エージェント(roles/config.agent)のロールをサービス アカウントに付与します。

    gcloud projects add-iam-policy-binding MANAGEMENT_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
        --role="roles/apphub.editor"
    
    gcloud projects add-iam-policy-binding MANAGEMENT_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
        --role="roles/config.agent"
    

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

    • MANAGEMENT_PROJECT_ID: スペースを含む管理プロジェクトのプロジェクト ID。
    • SERVICE_ACCOUNT_EMAIL: サービス アカウントのメールアドレス(my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com など)。
  4. サービス アカウントを含むプロジェクトで、iam.disableCrossProjectServiceAccountUsage 組織のポリシー制約が適用されていないことを確認します。この制約はデフォルトで適用されます。

    組織のポリシーの制約の適用を無効にします。

    gcloud resource-manager org-policies disable-enforce \
        iam.disableCrossProjectServiceAccountUsage \
        --project=SERVICE_ACCOUNT_PROJECT_ID
    

    SERVICE_ACCOUNT_PROJECT_ID は、サービス アカウントを含むプロジェクトのプロジェクト ID に置き換えます。

  5. リソースをデプロイするデプロイ プロジェクトで、サービス アカウントに Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)と、それらのリソースのデプロイに必要なロールを付与します。アプリケーションをデプロイすると、App Design Center に必要なロールが Google Cloud コンソールに表示されます。

    たとえば、デプロイ プロジェクトのサービス アカウントに roles/serviceusage.serviceUsageAdmin ロールと Cloud Run 管理者ロール(roles/run.admin)を付与します。

    gcloud projects add-iam-policy-binding DEPLOYMENT_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
        --role="roles/serviceusage.serviceUsageAdmin"
    
    gcloud projects add-iam-policy-binding DEPLOYMENT_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
        --role="roles/run.admin"
    

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

    • DEPLOYMENT_PROJECT_ID: リソースをデプロイするプロジェクトのプロジェクト ID。
    • SERVICE_ACCOUNT_EMAIL: サービス アカウントのメールアドレス(my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com など)。
  6. App Design Center は、Infrastructure Manager を使用してコンソールにアプリケーションをデプロイします。独自のサービス アカウントを使用して Infra Manager でデプロイするには、複数のプロジェクトにアクセス権を付与するの手順を完了します。

  7. 省略可: デプロイするアプリケーションに、Developer Connect 接続を介してインポートしたプライベート コンポーネントが含まれている場合は、サービス アカウントを含むプロジェクトに対するサービス アカウント トークン作成者のロール(roles/iam.serviceAccountTokenCreator)をサービス アカウントに付与します。

    gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
        --role="roles/iam.serviceAccountTokenCreator"
    

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

    • SERVICE_ACCOUNT_PROJECT_ID: サービス アカウントを含むプロジェクトのプロジェクト ID。
    • SERVICE_ACCOUNT_EMAIL: サービス アカウントのメールアドレス(my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com など)。

次のステップ