Memberikan peran ke akun layanan Anda

Saat melihat pratinjau dan men-deploy aplikasi, Anda dapat menggunakan akun layanan yang ada, atau Application Design Center dapat membuat akun layanan secara otomatis.

Untuk men-deploy aplikasi menggunakan akun layanan Anda sendiri, Anda harus memberikan peran dan izin Identity and Access Management yang diperlukan, termasuk yang berikut ini:

  • Tambahkan binding kebijakan IAM ke akun layanan dan akun pengguna.
  • Berikan peran yang diperlukan kepada akun layanan untuk men-deploy setiap resource.
  • Tambahkan izin ke akun layanan untuk men-deploy di luar project tempat akun layanan dibuat.
  • Perbarui kebijakan organisasi Anda agar Anda dapat membuat akun layanan di satu project dan menggunakannya untuk men-deploy resource di project lain.

Mengonfigurasi akun layanan Anda

Untuk mengonfigurasi akun layanan Anda, lakukan hal berikut:

  1. Berikan peran Service Account User (roles/iam.serviceAccountUser) di akun layanan Anda kepada agen layanan App Design Center dari project pengelolaan:

    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"
    

    Ganti kode berikut:

    • SERVICE_ACCOUNT_EMAIL: Email akun layanan Anda, seperti my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
    • SERVICE_ACCOUNT_PROJECT_ID: Project ID untuk project yang berisi akun layanan Anda.
    • MANAGEMENT_PROJECT_NUMBER: Nomor project dari project pengelolaan yang berisi ruang Anda.
  2. Berikan peran roles/iam.serviceAccountUser di akun layanan Anda kepada pengguna yang men-deploy aplikasi:

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

    Ganti kode berikut:

    • SERVICE_ACCOUNT_EMAIL: Email akun layanan Anda, seperti my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
    • USER_EMAIL: Alamat email pengguna yang melakukan deployment.
  3. Pada project pengelolaan yang berisi ruang Anda, berikan peran App Hub Editor (roles/apphub.editor) dan Cloud Infrastructure Manager Agent (roles/config.agent) ke akun layanan Anda:

    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"
    

    Ganti kode berikut:

    • MANAGEMENT_PROJECT_ID: Project ID dari project pengelolaan yang berisi ruang Anda.
    • SERVICE_ACCOUNT_EMAIL: Email akun layanan Anda, seperti my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
  4. Dalam project yang berisi akun layanan Anda, pastikan batasan kebijakan organisasi iam.disableCrossProjectServiceAccountUsage tidak diterapkan. Batasan ini diterapkan secara default.

    Nonaktifkan penerapan batasan kebijakan organisasi:

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

    Ganti SERVICE_ACCOUNT_PROJECT_ID dengan project ID dari project yang berisi akun layanan Anda.

  5. Pada project deployment tempat Anda men-deploy resource, berikan peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin) dan peran yang diperlukan untuk men-deploy resource tersebut kepada akun layanan Anda. App Design Center menampilkan peran yang diperlukan di konsol Google Cloud saat Anda men-deploy aplikasi.

    Misalnya, berikan peran roles/serviceusage.serviceUsageAdmin dan peran Admin Cloud Run (roles/run.admin) ke akun layanan Anda di project deployment:

    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"
    

    Ganti kode berikut:

    • DEPLOYMENT_PROJECT_ID: Project ID dari project tempat Anda men-deploy resource.
    • SERVICE_ACCOUNT_EMAIL: Email akun layanan Anda, seperti my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
  6. App Design Center menggunakan Infrastructure Manager untuk men-deploy aplikasi di konsol. Untuk menggunakan akun layanan Anda sendiri untuk men-deploy dengan Infra Manager, selesaikan langkah-langkah di Memberikan akses di beberapa project.

  7. Opsional: Jika aplikasi yang Anda deploy berisi komponen pribadi yang Anda impor melalui koneksi Developer Connect, berikan peran Service Account Token Creator (roles/iam.serviceAccountTokenCreator) kepada akun layanan Anda di project yang berisi akun layanan Anda:

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

    Ganti kode berikut:

    • SERVICE_ACCOUNT_PROJECT_ID: Project ID dari project yang berisi akun layanan Anda.
    • SERVICE_ACCOUNT_EMAIL: Email akun layanan Anda, seperti my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.

Langkah berikutnya