Dienstkonto Rollen zuweisen

Wenn Sie Anwendungen in der Vorschau ansehen und bereitstellen, können Sie ein vorhandenes Dienstkonto verwenden oder das Application Design Center kann automatisch ein Dienstkonto erstellen.

Wenn Sie Anwendungen mit Ihrem eigenen Dienstkonto bereitstellen möchten, müssen Sie die erforderlichen IAM-Rollen (Identity and Access Management) und ‑Berechtigungen gewähren, einschließlich der folgenden:

  • Fügen Sie dem Dienstkonto und dem Nutzerkonto IAM-Richtlinienbindungen hinzu.
  • Weisen Sie dem Dienstkonto die Rollen zu, die für die Bereitstellung der einzelnen Ressourcen erforderlich sind.
  • Fügen Sie dem Dienstkonto Bereitstellungsberechtigungen außerhalb des Projekts hinzu, in dem das Dienstkonto erstellt wurde.
  • Aktualisieren Sie Ihre Organisationsrichtlinien, damit Sie ein Dienstkonto in einem Projekt erstellen und damit Ressourcen in einem anderen Projekt bereitstellen können.

Dienstkonto konfigurieren

So konfigurieren Sie Ihr Dienstkonto:

  1. Weisen Sie dem App Design Center-Dienst-Agenten des Verwaltungsprojekts die Rolle Dienstkontonutzer (roles/iam.serviceAccountUser) für Ihr Dienstkonto zu:

    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"
    

    Ersetzen Sie Folgendes:

    • SERVICE_ACCOUNT_EMAIL: Die E-Mail-Adresse Ihres Dienstkontos, z. B. my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
    • SERVICE_ACCOUNT_PROJECT_ID: Die Projekt-ID des Projekts, das Ihr Dienstkonto enthält.
    • MANAGEMENT_PROJECT_NUMBER: Die Projektnummer des Verwaltungsprojekts, das Ihren Space enthält.
  2. Weisen Sie dem Nutzer, der die Anwendung bereitstellt, die Rolle roles/iam.serviceAccountUser für Ihr Dienstkonto zu:

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

    Ersetzen Sie Folgendes:

    • SERVICE_ACCOUNT_EMAIL: Die E-Mail-Adresse Ihres Dienstkontos, z. B. my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
    • USER_EMAIL: Die E-Mail-Adresse des Nutzers, der die Bereitstellung ausführt.
  3. Weisen Sie Ihrem Dienstkonto im Verwaltungsprojekt, das Ihren Bereich enthält, die Rollen „App Hub-Bearbeiter“ (roles/apphub.editor) und „Cloud Infrastructure Manager-Agent“ (roles/config.agent) zu:

    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"
    

    Ersetzen Sie Folgendes:

    • MANAGEMENT_PROJECT_ID: Die Projekt-ID des Verwaltungsprojekts, das Ihren Space enthält.
    • SERVICE_ACCOUNT_EMAIL: Die E-Mail-Adresse Ihres Dienstkontos, z. B. my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
  4. Achten Sie darauf, dass die Einschränkung der Organisationsrichtlinie iam.disableCrossProjectServiceAccountUsage im Projekt mit Ihrem Dienstkonto nicht erzwungen wird. Diese Einschränkung wird standardmäßig erzwungen.

    Deaktivieren Sie die Erzwingung der Einschränkung der Organisationsrichtlinie:

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

    Ersetzen Sie SERVICE_ACCOUNT_PROJECT_ID durch die Projekt-ID des Projekts, das Ihr Dienstkonto enthält.

  5. Weisen Sie Ihrem Dienstkonto im Bereitstellungsprojekt, in dem Sie Ressourcen bereitstellen, die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) und die Rollen zu, die für die Bereitstellung dieser Ressourcen erforderlich sind. Im App Design Center werden die erforderlichen Rollen in der Google Cloud Console angezeigt, wenn Sie Anwendungen bereitstellen.

    Weisen Sie Ihrem Dienstkonto im Bereitstellungsprojekt beispielsweise die Rolle roles/serviceusage.serviceUsageAdmin und die Rolle „Cloud Run-Administrator“ (roles/run.admin) zu:

    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"
    

    Ersetzen Sie Folgendes:

    • DEPLOYMENT_PROJECT_ID: Die Projekt-ID des Projekts, in dem Sie Ressourcen bereitstellen.
    • SERVICE_ACCOUNT_EMAIL: Die E-Mail-Adresse Ihres Dienstkontos, z. B. my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.
  6. Das App Design Center verwendet Infrastructure Manager, um Anwendungen in der Console bereitzustellen. Wenn Sie Ihr eigenes Dienstkonto für die Bereitstellung mit Infra Manager verwenden möchten, führen Sie die Schritte unter Zugriff über mehrere Projekte hinweg gewähren aus.

  7. Optional: Wenn die Anwendung, die Sie bereitstellen, private Komponenten enthält, die Sie über eine Developer Connect-Verbindung importiert haben, weisen Sie Ihrem Dienstkonto die Rolle „Dienstkonto-Token-Ersteller“ (roles/iam.serviceAccountTokenCreator) für das Projekt zu, das Ihr Dienstkonto enthält:

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

    Ersetzen Sie Folgendes:

    • SERVICE_ACCOUNT_PROJECT_ID: Die Projekt-ID des Projekts, das Ihr Dienstkonto enthält.
    • SERVICE_ACCOUNT_EMAIL: Die E-Mail-Adresse Ihres Dienstkontos, z. B. my-service-account@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com.

Nächste Schritte