Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Cloud Build permite-lhe configurar acionadores que não executam imediatamente uma compilação, mas marcam uma compilação como pendente até ser aprovada. Se um utilizador com autorizações aprovar uma compilação pendente, a compilação é iniciada. Se a aprovação for recusada,
a compilação não é iniciada.
Esta página explica como pode aprovar ou rejeitar compilações manualmente.
Para saber como configurar um acionador que requer aprovação, consulte o artigo Criar um acionador de compilação.
Se um utilizador tiver a função de editor do Cloud Build, tem autorizações para atualizar um acionador de modo a exigir ou não aprovação. Para saber mais
acerca das autorizações do Cloud Build, consulte o artigo IAM e
autorizações. Para conceder a um utilizador autorização para aprovar compilações no seu projeto, o utilizador tem de ter a função Aprovador do Cloud Build.
Na secção Adicionar responsáveis, adicione utilizadores para lhes conceder autorização para
conceder aprovação para compilações pendentes no seu projeto.
Tem de adicionar um ou mais responsáveis nesta secção. Se se adicionar como diretor, tenha em atenção que continua a ter de aprovar manualmente uma compilação pendente se o seu acionador estiver protegido por uma aprovação.
Na secção Atribuir funções, selecione Cloud Build > Aprovador do Cloud Build.
Os utilizadores que especificou têm agora acesso para aprovar ou rejeitar compilações pendentes.
Aprovar compilações
Consola
Para aprovar uma compilação pendente na consola Google Cloud :
Abra a página Painel de controlo do Cloud Build na Google Cloud consola.
Se tiver compilações para aprovar, é apresentada uma mensagem na parte superior da página
com o número de compilações a aguardar a sua aprovação. À direita da mensagem,
clique em Ver compilações para ver a lista de compilações que aguardam a sua aprovação.
Clique nas caixas de verificação das compilações que quer aprovar.
Pode selecionar várias compilações para aprovar ou uma compilação individual para aprovar.
Na parte superior da página, clique em Aprovar para aprovar as compilações selecionadas.
Antes de iniciar a compilação, é apresentada a caixa de diálogo Aprovar compilação.
Na caixa de diálogo, pode adicionar uma mensagem opcional e um URL a apresentar juntamente com a aprovação da compilação. Para incluir um URL, clique em
Mostrar opções adicionais para introduzir um URL.
Na caixa de diálogo, clique em Aprovar para aprovar a compilação.
Depois de aprovar, a compilação é iniciada imediatamente. Se a política da organização (constraints/cloudbuild.allowedIntegrations) negar o acesso ao repositório ligado, a política substitui a aprovação. Para saber mais, consulte o artigo O Gate baseia-se na política da organização.
gcloud
Para aprovar uma compilação pendente através do gcloud commands, execute o seguinte comando na janela do terminal:
Substitua os valores dos marcadores de posição nos comandos acima pelo seguinte:
BUILD_ID é o ID da versão que quer
aprovar.
PROJECT_ID é o ID do seu projeto.
[Opcional] URL é o URL que contém informações
sobre a aprovação, como um link para um pedido de assistência do JIRA.
[Opcional] COMMENT é a mensagem que quer apresentar
após a aprovação da compilação.
Depois de aprovar, a compilação é iniciada imediatamente. Se a política da organização
para definir compilações para integrações permitidas
(constraints/cloudbuild.allowedIntegrations) estiver definida, a política
substitui a aprovação. Para saber mais, consulte o artigo Aplicar a política da organização para criar acionadores.
Rejeitar compilações
Consola
Para rejeitar uma compilação pendente na consola Google Cloud :
Abra a página Painel de controlo do Cloud Build na Google Cloud consola.
Se tiver compilações para aprovar, é apresentada uma mensagem na parte superior da página
com o número de compilações a aguardar a sua aprovação. À direita da mensagem,
clique em Ver compilações para ver a lista de compilações que aguardam a sua aprovação.
Pode selecionar várias compilações para rejeitar ou uma compilação individual para rejeitar. Clique nas caixas de verificação das compilações que quer rejeitar.
Clique em Rejeitar na parte superior da página para rejeitar a compilação.
Se rejeitar uma compilação, esta não é iniciada.
gcloud
Para rejeitar uma compilação pendente através do gcloud commands, execute o seguinte comando na janela do terminal:
Substitua os valores dos marcadores de posição nos comandos acima pelo seguinte:
BUILD_ID é o ID da compilação que quer rejeitar.
PROJECT_ID é o ID do seu projeto.
[Opcional] URL é o URL que contém informações
sobre a rejeição, como um link para um pedido de assistência do JIRA.
[Opcional] COMMENT é a mensagem que quer apresentar
após a rejeição da compilação.
Se rejeitar uma compilação, esta nunca é iniciada.
Receber notificações de compilações que aguardam aprovação
Pode usar notificadores do Cloud Build para receber notificações sobre compilações pendentes através de um notificador mantido pelo Cloud Build, como o servidor Slack ou SMTP, ou criar o seu próprio notificador.
Para configurar as notificações:
Siga as instruções numa das seguintes páginas para configurar as notificações para o serviço pretendido:
Quando configurar notificações através de uma das páginas acima, tem de
configurar o seu notificador para filtrar compilações com o estado PENDING.
Esta opção envia-lhe notificações sobre compilações que aguardam aprovação.
No seguinte exemplo de ficheiro de configuração do notificador SMTP, o campo de filtro usa o Idioma de expressão comum (IEC) para filtrar eventos de compilação com um estado PENDING:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)"]]
