Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit Cloud Build können Sie Trigger konfigurieren, die keinen Build sofort ausführen, sondern einen Build bis zur Genehmigung als ausstehend markieren. Wenn ein Nutzer mit Berechtigungen einen ausstehenden Build genehmigt, wird der Build gestartet. Wenn die Genehmigung verweigert wird, wird der Build nicht gestartet.
Auf dieser Seite wird erläutert, wie Sie Builds manuell genehmigen oder ablehnen können.
Informationen zum Konfigurieren eines Triggers, der eine Genehmigung erfordert, finden Sie unter Build-Trigger erstellen.
Falls dies noch nicht geschehen, erstellen Sie einen Build-Trigger, der so konfiguriert ist, dass eine Genehmigung erforderlich ist.
Berechtigungen gewähren
Wenn ein Nutzer die Rolle Cloud Build-Bearbeiter hat, kann er festlegen, ob ein Trigger eine Genehmigung erfordert oder nicht. Weitere Informationen zu Cloud Build-Berechtigungen finden Sie unter IAM und Berechtigungen. Um einem Nutzer die Berechtigung zum Genehmigen von Builds in Ihrem Projekt zu erteilen, muss der Nutzer die Rolle Cloud Build-Genehmiger haben.
So fügen Sie die Rolle Cloud Build-Genehmiger hinzu:
Öffnen Sie in der Google Cloud Console die Seite IAM.
Fügen Sie im Bereich Hauptkonten hinzufügen Nutzer hinzu, um ihnen die Berechtigung zu erteilen, ausstehende Builds in Ihrem Projekt zu genehmigen.
In diesem Abschnitt müssen Sie ein oder mehrere Hauptkonten hinzufügen. Wenn Sie sich als Hauptkonto hinzufügen, müssen Sie dennoch einen ausstehenden Build manuell genehmigen, wenn Ihr Trigger durch eine Genehmigung gesteuert wird.
Wählen Sie im Abschnitt Rollen zuweisen die Option Cloud Build > Cloud Build-Genehmiger aus.
Die von Ihnen angegebenen Nutzer haben jetzt Zugriff auf die Genehmigung oder Ablehnung von ausstehenden Builds.
Builds genehmigen
Console
So genehmigen Sie einen ausstehenden Build in der Google Cloud -Konsole:
Öffnen Sie in der Google Cloud Console die Seite Cloud Build-Dashboard.
Wenn Sie die Builds genehmigen müssen, wird oben auf der Seite eine Meldung mit der Anzahl der Builds angezeigt, die Sie genehmigen müssen. Klicken Sie rechts neben der Nachricht auf Builds ansehen, um die Liste der Builds aufzurufen, die Sie genehmigen müssen.
Klicken Sie auf die Kästchen der Builds, die Sie genehmigen möchten.
Sie können mehrere Builds auswählen, die genehmigt werden sollen, oder einen einzelnen Build, der genehmigt werden soll.
Klicken Sie oben auf der Seite auf Genehmigen, um die ausgewählten Builds zu genehmigen.
Vor dem Start des Builds wird das Dialogfeld Build genehmigen angezeigt.
Im Dialogfeld können Sie eine optionale Nachricht und eine URL hinzufügen, die zusammen mit der Genehmigung des Builds angezeigt wird. Zum Hinzufügen einer URL klicken Sie auf Zusätzliche Optionen anzeigen, um eine URL einzugeben.
Klicken Sie im Dialogfeld auf Genehmigen, um den Build zu genehmigen.
Sobald Sie ihn genehmigt haben, startet der Build sofort. Wenn die Organisationsrichtlinie (constraints/cloudbuild.allowedIntegrations) den Zugriff auf das verbundene Repository verweigert, wird die Genehmigung durch die Richtlinie überschrieben. Weitere Informationen finden Sie unter Builds auf Organisationsrichtlinien abstimmen.
gcloud
Führen Sie den folgenden Befehl im Terminalfenster aus, um einen ausstehenden Build mit gcloud commands zu genehmigen:
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
BUILD_ID ist die ID des Builds, den Sie genehmigen möchten.
PROJECT_ID ist die Projekt-ID.
[Optional] URL ist die URL, die Informationen zur Genehmigung enthält, z. B. einen Link zu einem JIRA-Ticket.
[Optional] COMMENT ist die Nachricht, die nach der Genehmigung des Builds angezeigt werden soll.
Sobald Sie ihn genehmigt haben, startet der Build sofort. Wenn die Organisationsrichtlinie zum Definieren von Builds für zulässige Integrationen (constraints/cloudbuild.allowedIntegrations) festgelegt ist, wird die Genehmigung durch die Richtlinie überschrieben. Weitere Informationen finden Sie unter Organisationsrichtlinie auf Build-Trigger anwenden.
Builds ablehnen
Console
So lehnen Sie einen ausstehenden Build in der Google Cloud -Konsole ab:
Öffnen Sie in der Google Cloud Console die Seite Cloud Build-Dashboard.
Wenn Sie die Builds genehmigen müssen, wird oben auf der Seite eine Meldung mit der Anzahl der Builds angezeigt, die Sie genehmigen müssen. Klicken Sie rechts neben der Nachricht auf Builds ansehen, um die Liste der Builds aufzurufen, die Sie genehmigen müssen.
Sie können mehrere Builds auswählen, die abgelehnt werden sollen, oder einen einzelnen Build, der abgelehnt werden soll. Klicken Sie auf die Kästchen der Builds, die Sie ablehnen möchten.
Klicken Sie oben auf der Seite auf Ablehnen, um den Build abzulehnen.
Wenn Sie einen Build ablehnen, wird der Build nicht gestartet.
gcloud
Führen Sie den folgenden Befehl in Ihrem Terminalfenster aus, um einen ausstehenden Build mit gcloud commands abzulehnen:
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
BUILD_ID ist die ID des Builds, den Sie ablehnen möchten.
PROJECT_ID ist die Projekt-ID.
[Optional] URL ist die URL, die Informationen zur Ablehnung enthält, z. B. einen Link zu einem JIRA-Ticket.
[Optional] COMMENT ist die Nachricht, die nach der Ablehnung des Builds angezeigt werden soll.
Wenn Sie einen Build ablehnen, wird der Build nie gestartet.
Benachrichtigungen für Builds erhalten, die auf Genehmigung warten
Sie können Cloud Build-Notifier verwenden, um Benachrichtigungen über ausstehende Builds zu erhalten. Verwenden Sie dazu einen von Cloud Build verwalteten Notifier, z. B. Slack oder SMTP-Server. Sie können aber auch Ihren eigenen Notifier erstellen.
So konfigurieren Sie Benachrichtigungen:
Folgen Sie der Anleitung auf einer der folgenden Seiten, um Benachrichtigungen für Ihren gewünschten Dienst zu konfigurieren:
Wenn Sie Benachrichtigungen mit einer der oben genannten Seiten konfigurieren, müssen Sie den Notifier so konfigurieren, dass Builds mit dem Status PENDING gefiltert werden.
Dadurch werden Sie Benachrichtigungen zu Builds erhalten, die auf die Genehmigung warten.
In der folgenden Beispiel-SMTP-Notifier-Konfigurationsdatei verwendet das Filterfeld Common Expression Language (CEL), um Build-Ereignisse mit dem Status PENDING zu filtern:
Führen Sie den Befehl gcloud run in Ihrem Terminal aus, um den Notifier bereitzustellen.
Im folgenden Beispiel wird der SMTP-Notifier mit Cloud Run bereitgestellt.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eCloud Build allows builds to be marked as pending, requiring manual approval before they start.\u003c/p\u003e\n"],["\u003cp\u003eUsers with the Cloud Build Approver role can approve or reject pending builds, either through the Google Cloud console or using gcloud commands.\u003c/p\u003e\n"],["\u003cp\u003eApproving a build initiates the build process immediately, while rejecting a build prevents it from ever starting.\u003c/p\u003e\n"],["\u003cp\u003eNotifications for pending builds can be configured through Cloud Build notifiers, allowing users to be alerted when builds are awaiting approval, and can be set up through services such as BigQuery, HTTP, Slack, SMTP and others.\u003c/p\u003e\n"],["\u003cp\u003eUsers will need to create a build trigger configured to require approval before they can approve or reject pending builds.\u003c/p\u003e\n"]]],[],null,["# Gate builds on approval\n\nCloud Build enables you to configure triggers that do not\nimmediately execute a build but instead mark a build as pending\nuntil approved. If a user with permissions approves a pending\nbuild, the build will start. If the approval is denied,\nthe build will not start.\n\nThis page explains how you can manually approve or reject builds.\nTo learn how to configure a trigger that requires approval, see [Creating a build trigger](/build/docs/automating-builds/create-manage-triggers#console).\n| **Note:** You can't approve or reject pending builds older than 2 months. For details, see [Troubleshooting](/build/docs/troubleshooting#pending_build).\n\nBefore you begin\n----------------\n\n-\n\n\n Enable the Cloud Build API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=cloudbuild.googleapis.com&redirect=https://cloud.google.com/build/docs/automating-builds/approve-builds)\n\n\u003c!-- --\u003e\n\n- Install [Google Cloud CLI](/sdk/docs/install-sdk).\n\n | **Note:** If you've already installed gcloud CLI previously, make sure you have the latest available version by running `gcloud components update`.\n- If you have not already, [create a build trigger](/build/docs/automating-builds/create-manage-triggers#console) configured to require approval.\n\n### Granting permissions\n\nIf a user has the **Cloud Build Editor role** , the user has\npermissions to update a trigger to require or not require approval. To learn more\nabout Cloud Build permissions, see [IAM and\npermissions](/build/docs/iam-roles-permissions). In order to grant\na user permission to approve builds within your project, the user\nmust have the **Cloud Build Approver** role.\n\nTo add the **Cloud Build Approver** role:\n\n1. Open the **IAM** page in the Google Cloud console.\n\n [Open the IAM page](https://console.cloud.google.com/iam-admin/iam)\n2. Click **Grant access**.\n\n You will see the **Grant access** panel.\n3. In the **Add principals** section, add users to give them permission to\n grant approval for pending builds within your project.\n\n You *must* add one or more principals in this section. If you add yourself as\n a principal, note that you will still need to manually approve a pending\n build if your trigger is gated by an approval.\n4. In the **Assign roles** section, select **Cloud Build** \\\u003e **Cloud Build Approver**.\n\nThe users you specified now have access to approve or reject pending builds.\n\nApproving builds\n----------------\n\n### Console\n\nTo approve a pending build in the Google Cloud console:\n\n1. Open the **Cloud Build Dashboard** page in the Google Cloud console.\n\n [Open the Cloud Build Dashboard page](https://console.cloud.google.com/cloud-build/dashboard)\n2. If you have builds to approve, you will see a message at the top of the page\n with the number of builds awaiting your approval. To the right of the message,\n click **View Builds** to view the list of builds awaiting your approval.\n\n3. Click on the checkboxes of the builds you'd like to approve.\n You can select multiple builds to approve or one individual build to\n approve.\n\n4. At the top of the page, click **Approve** to approve your selected builds.\n\n5. Before the build starts, you will see the **Approve build** dialog box.\n In the dialog box, you can add an optional message and a URL to be\n displayed along with the build's approval. To include a URL, click\n **Show additional options** to enter a URL.\n\n6. In the dialog box, click **Approve** to approve the build.\n\nOnce you approve, the build will start immediately. If the organization\npolicy\n(`constraints/cloudbuild.allowedIntegrations`) denies access to\nthe connected repository, the policy will\noverride the approval. To learn more, see [Gate builds on organization policy](/build/docs/securing-builds/gate-builds-organization-policy).\n\n### gcloud\n\nTo approve a pending build using `gcloud commands`, run the following command\nin your terminal window: \n\n gcloud builds approve \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --url=\u003cvar translate=\"no\"\u003eURL\u003c/var\u003e \\\n --comment=\u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e\n\nReplace the placeholder values in the above commands with the following:\n\n- \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e is the ID of the build you'd like to approve.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is your project ID.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eURL\u003c/var\u003e is the URL containing information about the approval, such as a link to a JIRA ticket.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e is the message you want displayed upon approval of the build.\n\nOnce you approve, the build will start immediately. If the organization\npolicy to define builds for allowed integrations\n(`constraints/cloudbuild.allowedIntegrations`) is set, the policy will\noverride the approval. To learn more, see [Applying organization\npolicy to build triggers](/build/docs/securing-builds/apply-organization-policy-triggers).\n\nRejecting builds\n----------------\n\n### Console\n\nTo reject a pending build in the Google Cloud console:\n\n1. Open the **Cloud Build Dashboard** page in the Google Cloud console.\n\n [Open the Cloud Build Dashboard page](https://console.cloud.google.com/cloud-build/dashboard)\n2. If you have builds to approve, you will see a message at the top of the page\n with the number of builds awaiting your approval. To the right of the message,\n click **View Builds** to view the list of builds awaiting your approval.\n\n3. You can select multiple builds to reject or one individual build to\n reject. Click on the checkboxes of the builds you'd like to reject.\n\n4. Click **Reject** at the top of the page to reject the build.\n\nIf you reject a build, the build will not start.\n\n### gcloud\n\nTo reject a pending build using `gcloud commands`, run the following command\nin your terminal window: \n\n gcloud builds reject \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --url=\u003cvar translate=\"no\"\u003eURL\u003c/var\u003e \\\n --comment=\u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e\n\nReplace the placeholder values in the above commands with the following:\n\n- \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e is the ID of the build you'd like to reject.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is your project ID.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eURL\u003c/var\u003e is the URL containing information about the rejection, such as a link to a JIRA ticket.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e is the message you want displayed upon rejection of the build.\n\nIf you reject a build, the build will never start.\n\nReceiving notifications for builds waiting for approval\n-------------------------------------------------------\n\nYou can use Cloud Build notifiers to receive notifications about\npending builds using a Cloud Build maintained notifier,\nsuch as [Slack](/build/docs/configuring-notifications/configure-slack) or [SMTP](/build/docs/configuring-notifications/configure-smtp) server, or by\n[creating your own notifier](/build/docs/configuring-notifications/create-notifier).\n\nTo configure notifications:\n\n1. Follow the instructions on one of following pages to\n configure notifications for your desired service:\n\n - [BigQuery](/build/docs/configuring-notifications/configure-bigquery)\n - [HTTP](/build/docs/configuring-notifications/configure-http)\n - [Slack](/build/docs/configuring-notifications/configure-slack)\n - [SMTP](/build/docs/configuring-notifications/configure-smtp)\n - [Creating your own notifier](/build/docs/configuring-notifications/create-notifier)\n2. When configuring notifications using one of the pages above, you must\n configure your notifier to filter builds with a *PENDING* status.\n This will send you notifications on builds waiting for approval.\n In the following example SMTP notifier configuration file, the filter field\n uses [Common Expression Language](https://github.com/google/cel-spec) (CEL) to filter build events with a PENDING status:\n\n apiVersion: cloud-build-notifiers/v1\n kind: SMTPNotifier\n metadata:\n name: example-smtp-notifier\n spec:\n notification:\n filter: build.status == Build.Status.PENDING\n delivery:\n server: example.gmail.com\n port: 0000\n sender: sender@example.com\n ...\n\n To view the full example, see the [notifier configuration file for the SMTP notifier](https://github.com/GoogleCloudPlatform/cloud-build-notifiers/blob/master/smtp/smtp.yaml.example).\n3. To deploy your notifier, run the `gcloud run` command in your terminal.\n The following example deploys the SMTP notifier using Cloud Run.\n\n gcloud run deploy example.gmail.com \\\n --image=us-east1-docker.pkg.dev/gcb-release/cloud-build-notifiers/smtp:latest \\\n --update-env-vars=CONFIG_PATH=smtp.yaml, PROJECT_ID=my-project\n\nYou should now receive notifications for pending builds to your service.\n\nWhat's next\n-----------\n\n- Learn how to [create and manage build triggers](/build/docs/automating-builds/create-manage-triggers).\n- Learn how to [view build results for build triggers](/build/docs/view-build-results#viewing_build_results_for_build_triggers)"]]
