Impostare le build in base all'approvazione

Cloud Build ti consente di configurare trigger che non eseguono immediatamente una build, ma la contrassegnano come in attesa di approvazione. Se un utente con autorizzazioni approva una build in attesa, la build verrà avviata. Se l'approvazione viene negata, la build non verrà avviata.

Questa pagina spiega come approvare o rifiutare manualmente le build. Per scoprire come configurare un trigger che richiede l'approvazione, consulta Creazione di un trigger di build.

Prima di iniziare

• Enable the Cloud Build API.

  Enable the API

• Installa Google Cloud CLI.

• Se non l'hai ancora fatto, crea un attivatore di build configurato per richiedere l'approvazione.

Concessione di autorizzazioni

Se un utente ha il ruolo Editor Cloud Build, dispone delle autorizzazioni per aggiornare un trigger in modo che richieda o non richieda l'approvazione. Per saperne di più sulle autorizzazioni di Cloud Build, consulta IAM e autorizzazioni. Per concedere a un utente l'autorizzazione ad approvare le build all'interno del tuo progetto, l'utente deve disporre del ruolo Approvare build Cloud.

Per aggiungere il ruolo Cloud Build Approver:

1. Apri la pagina IAM nella console Google Cloud .

   Apri la pagina IAM

2. Fai clic su Concedi accesso.

   Viene visualizzato il riquadro Concedi l'accesso.

3. Nella sezione Aggiungi entità, aggiungi utenti per concedere loro l'autorizzazione a approvare le build in attesa all'interno del tuo progetto.

   Devi aggiungere una o più entità in questa sezione. Se ti aggiungi come principale, tieni presente che dovrai comunque approvare manualmente una build in attesa se il trigger è controllato da un'approvazione.

4. Nella sezione Assegna ruoli, seleziona Cloud Build > Cloud Build Approver.

Gli utenti che hai specificato ora possono approvare o rifiutare le build in attesa.

Approvazione delle build

gcloud builds approve BUILD_ID \
  --project=PROJECT_ID \
  --url=URL \
  --comment=COMMENT

Rifiuto delle build

gcloud builds reject BUILD_ID \
  --project=PROJECT_ID \
  --url=URL \
  --comment=COMMENT

Ricevere notifiche per le build in attesa di approvazione

Puoi utilizzare i notificatori di Cloud Build per ricevere notifiche sulle build in attesa utilizzando un notificatore gestito da Cloud Build, ad esempio il server Slack o SMTP, oppure creando un notificatore personalizzato.

Per configurare le notifiche:

1. Segui le istruzioni riportate in una delle pagine seguenti per configurare le notifiche per il servizio che preferisci:

   • BigQuery
   • HTTP
   • Slack
   • SMTP
   • Creare un notifier personalizzato

2. Quando configuri le notifiche utilizzando una delle pagine precedenti, devi configurare il sistema di notifica in modo che filtri le build con stato PENDING. In questo modo riceverai notifiche sulle build in attesa di approvazione. Nel seguente file di configurazione del notifier SMTP di esempio, il campo del filtro utilizza Common Expression Language (CEL) per filtrare gli eventi di build con stato PENDING:

   apiVersion: cloud-build-notifiers/v1
   kind: SMTPNotifier
   metadata:
     name: example-smtp-notifier
   spec:
     notification:
       filter: build.status == Build.Status.PENDING
       delivery:
         server: example.gmail.com
         port: 0000
         sender: sender@example.com
         ...
   

   Per visualizzare l'esempio completo, consulta il file di configurazione del sistema di notifica per il sistema di notifica SMTP.

3. Per eseguire il deployment del notifier, esegui il comando gcloud run nel terminale. L'esempio seguente esegue il deployment del notifier SMTP utilizzando Cloud Run.

   gcloud run deploy example.gmail.com \
     --image=us-east1-docker.pkg.dev/gcb-release/cloud-build-notifiers/smtp:latest \
     --update-env-vars=CONFIG_PATH=smtp.yaml, PROJECT_ID=my-project
   

Ora dovresti ricevere notifiche per le build in attesa per il tuo servizio.

Passaggi successivi

• Scopri come creare e gestire i trigger di build.
• Scopri come visualizzare i risultati della build per i trigger di build.