서비스 계정에 역할 부여

애플리케이션을 미리 보고 배포할 때 기존 서비스 계정을 사용하거나 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. 리소스를 배포하는 배포 프로젝트에서 서비스 계정에 서비스 사용량 관리자 역할(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).

다음 단계