Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Cloud Build te permite configurar activadores que no ejecutan una compilación inmediatamente, sino que marcan una compilación como pendiente hasta que se aprueba. Si un usuario con permisos aprueba una compilación pendiente, esta se iniciará. Si se deniega la aprobación, la compilación no se iniciará.
En esta página se explica cómo aprobar o rechazar compilaciones manualmente.
Para saber cómo configurar un activador que requiera aprobación, consulta el artículo Crear un activador de compilación.
Si un usuario tiene el rol Editor de Cloud Build, puede actualizar un activador para que requiera o no aprobación. Para obtener más información sobre los permisos de Cloud Build, consulta Gestión de identidades y accesos y permisos. Para conceder permiso a un usuario para aprobar compilaciones en tu proyecto, el usuario debe tener el rol Aprobador de Cloud Build.
Para añadir el rol Aprobador de Cloud Build, sigue estos pasos:
En la sección Añadir principales, añade usuarios para darles permiso para aprobar compilaciones pendientes en tu proyecto.
Debes añadir uno o varios principales en esta sección. Si te añades como principal, ten en cuenta que tendrás que aprobar manualmente una compilación pendiente si tu activador está protegido por una aprobación.
En la sección Asignar roles, selecciona Cloud Build > Aprobador de Cloud Build.
Los usuarios que has especificado ahora tienen acceso para aprobar o rechazar compilaciones pendientes.
Aprobar compilaciones
Consola
Para aprobar una compilación pendiente en la consola de Google Cloud , sigue estos pasos:
Abre la página Panel de control de Cloud Build en la Google Cloud consola.
Si tienes compilaciones que aprobar, verás un mensaje en la parte superior de la página con el número de compilaciones que están pendientes de tu aprobación. A la derecha del mensaje, haz clic en Ver compilaciones para ver la lista de compilaciones que están pendientes de tu aprobación.
Haz clic en las casillas de las compilaciones que quieras aprobar.
Puedes seleccionar varias compilaciones para aprobarlas o una sola.
En la parte superior de la página, haz clic en Aprobar para aprobar las compilaciones seleccionadas.
Antes de que empiece la compilación, verás el cuadro de diálogo Aprobar compilación.
En el cuadro de diálogo, puedes añadir un mensaje opcional y una URL que se mostrarán junto con la aprobación de la compilación. Para incluir una URL, haz clic en Mostrar opciones adicionales e introduce una URL.
En el cuadro de diálogo, haz clic en Aprobar para aprobar la compilación.
Una vez que lo apruebes, la compilación se iniciará inmediatamente. Si la política de la organización (constraints/cloudbuild.allowedIntegrations) deniega el acceso al repositorio conectado, la política anulará la aprobación. Para obtener más información, consulta Gate builds on organization policy (Puerta de compilaciones en la política de organización).
gcloud
Para aprobar una compilación pendiente con gcloud commands, ejecuta el siguiente comando en la ventana de tu terminal:
Sustituye los valores de los marcadores de posición de los comandos anteriores por los siguientes:
BUILD_ID es el ID de la compilación que quieres aprobar.
PROJECT_ID es el ID del proyecto.
[Opcional] URL es la URL que contiene información sobre la aprobación, como un enlace a una incidencia de JIRA.
[Opcional] COMMENT es el mensaje que quieres que se muestre
cuando se apruebe la compilación.
Una vez que lo apruebes, la compilación se iniciará inmediatamente. Si se define la política de la organización para definir compilaciones de integraciones permitidas (constraints/cloudbuild.allowedIntegrations), la política anulará la aprobación. Para obtener más información, consulta Aplicar políticas de la organización a los activadores de compilación.
Rechazar compilaciones
Consola
Para rechazar una compilación pendiente en la consola de Google Cloud :
Abre la página Panel de control de Cloud Build en la Google Cloud consola.
Si tienes compilaciones que aprobar, verás un mensaje en la parte superior de la página con el número de compilaciones que están pendientes de tu aprobación. A la derecha del mensaje, haz clic en Ver compilaciones para ver la lista de compilaciones que están pendientes de tu aprobación.
Puedes seleccionar varias compilaciones para rechazarlas o una compilación concreta. Marca las casillas de las compilaciones que quieras rechazar.
Haz clic en Rechazar en la parte superior de la página para rechazar la compilación.
Si rechazas una compilación, no se iniciará.
gcloud
Para rechazar una compilación pendiente con gcloud commands, ejecuta el siguiente comando en la ventana de terminal:
Sustituye los valores de los marcadores de posición de los comandos anteriores por los siguientes:
BUILD_ID es el ID de la compilación que quieres rechazar.
PROJECT_ID es el ID del proyecto.
[Opcional] URL es la URL que contiene información sobre el rechazo, como un enlace a una incidencia de JIRA.
[Opcional] COMMENT es el mensaje que quieres que se muestre
cuando se rechace la compilación.
Si rechazas una compilación, nunca se iniciará.
Recibir notificaciones de compilaciones pendientes de aprobación
Puedes usar notificadores de Cloud Build para recibir notificaciones sobre compilaciones pendientes mediante un notificador mantenido por Cloud Build, como un servidor Slack o SMTP, o bien creando tu propio notificador.
Para configurar las notificaciones, sigue estos pasos:
Sigue las instrucciones de una de las páginas siguientes para configurar las notificaciones del servicio que quieras:
Cuando configures las notificaciones en una de las páginas anteriores, debes configurar tu notificador para que filtre las compilaciones con el estado PENDING.
De esta forma, recibirás notificaciones sobre las compilaciones que estén pendientes de aprobación.
En el siguiente archivo de configuración de notificador SMTP de ejemplo, el campo de filtro usa el lenguaje de expresión común (CEL) para filtrar los eventos de compilación con el estado PENDING:
Para implementar tu notificador, ejecuta el comando gcloud run en tu terminal.
En el siguiente ejemplo se despliega el notificador SMTP mediante Cloud Run.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (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,["Cloud 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 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\nGranting 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\nConsole\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\ngcloud\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\nConsole\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\ngcloud\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\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- 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)"]]
