Cloud Build utilizza i trigger di build per abilitare l'automazione CI/CD. Puoi configurare i trigger in modo che rimangano in ascolto degli eventi in arrivo, ad esempio quando viene eseguito il push di un nuovo commit in un repository o quando viene avviata una richiesta di pull, quindi eseguire automaticamente una build quando arrivano nuovi eventi. Puoi anche configurare i trigger per creare build dal codice per ogni modifica al repository di codice sorgente o solo in caso di modifiche che soddisfano determinati criteri.
Questa pagina fornisce una panoramica di ogni tipo di trigger e delle funzionalità associate ai trigger.
Trigger di eventi del repository
Cloud Build ti consente di eseguire automaticamente le build in base agli eventi del repository, come push o richieste di pull. Puoi connettere repository esterni, come quelli in GitHub o Bitbucket, a Cloud Build o utilizzare il codice in Cloud Source Repositories per le tue build. Sebbene tu possa connettere qualsiasi repository di origine a Cloud Build, Cloud Build fornisce trigger di eventi del repository specifici che puoi utilizzare per integrare sistemi di gestione del codice sorgente (SCM) specifici. Questa sezione illustra i trigger di eventi del repository disponibili.
Trigger GitHub
Puoi creare trigger GitHub per eseguire automaticamente le build in risposta agli eventi del repository, come push o richieste di pull. Puoi visualizzare lo stato della build del trigger su GitHub e nella console Google Cloud . Puoi anche utilizzare l'app GitHub di Cloud Build per connetterti e creare codice in GitHub. Per saperne di più, consulta Creazione di repository da GitHub.
Trigger di GitHub Enterprise
Puoi creare trigger per i repository ospitati su un'istanza GitHub Enterprise, incluse le istanze ospitate in un ambiente on-premise e non raggiungibili tramite una connessione a internet pubblica. I trigger di GitHub Enterprise possono essere utilizzati per eseguire build in risposta a richieste di push o pull da un'istanza di GitHub Enterprise. Per saperne di più, consulta Creazione di repository da GitHub Enterprise.
Trigger GitLab Enterprise Edition
Puoi creare trigger per i repository ospitati su un'istanza GitLab Enterprise Edition, incluse le istanze ospitate in una rete privata. I trigger di GitLab Enterprise Edition possono essere utilizzati per eseguire build in risposta a push di commit o richieste di pull associate al tuo repository GitLab Enterprise Edition. Per saperne di più, consulta Creazione di repository da GitLab Enterprise Edition.
Trigger di Bitbucket Server
Puoi creare trigger per i repository ospitati su un'istanza Bitbucket Server, incluse le istanze ospitate in un ambiente on-premise. Puoi connettere il tuo repository Bitbucket Server a Cloud Build più volte con più connessioni host. Per scoprire di più su come creare trigger per eseguire build in risposta agli eventi, consulta Creazione di repository da Bitbucket Server.
Trigger di Bitbucket Data Center
Puoi creare trigger per i repository ospitati su un'istanza Bitbucket Data Center, incluse le istanze ospitate in un ambiente on-premise. I trigger di Bitbucket Data Center possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste di pull. Per saperne di più, consulta Creazione di repository da Bitbucket Data Center.
Trigger di Bitbucket Cloud
Puoi creare trigger per i repository ospitati in Bitbucket Cloud. I trigger di Bitbucket Cloud possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste di pull. Per saperne di più, consulta Creazione di repository da Bitbucket Cloud.
Trigger di Secure Source Manager
Puoi creare trigger per i repository ospitati in Secure Source Manager. I trigger di Secure Source Manager possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste di pull. Per scoprire di più, consulta Crea un file di trigger in Secure Source Manager.
Trigger manuali
Puoi creare trigger manuali per eseguire le build manualmente ed eseguire l'override dei valori delle variabili di sostituzione definiti al momento della chiamata prima di eseguire una build. Puoi anche configurare i trigger manuali in modo che vengano eseguiti in base a una pianificazione. Per saperne di più, consulta Crea manualmente il codice nei repository di codice sorgente.
Trigger Pub/Sub
Puoi creare trigger Pub/Sub per eseguire build in risposta a qualsiasi messaggio pubblicato su Pub/Sub. Ad esempio, puoi utilizzare i trigger Pub/Sub per creare build in risposta ai push di immagini su Artifact Registry. In questo caso, puoi configurare il trigger in modo che utilizzi i filtri per eseguire una build solo se l'immagine di cui è stato eseguito il push corrisponde a un tag specifico, ad esempio prod.
Inoltre, i trigger Pub/Sub possono essere configurati per sottoscrivere qualsiasi argomento Pub/Sub. Per saperne di più, consulta Automatizza le build in risposta agli eventi Pub/Sub.
Trigger webhook
Puoi creare trigger di webhook per eseguire build in risposta ai webhook. Gli eventi webhook inviati a un URL personalizzato ti consentono di connettere direttamente a Cloud Build sistemi esterni e sistemi di gestione del codice sorgente (SCM) esterni, come Bitbucket.com, Bitbucket Server o GitLab. Quando crei trigger di webhook, puoi anche definire la configurazione di compilazione in linea sul trigger per controllare quali repository vengono clonati dal trigger durante la compilazione, anziché specificare esplicitamente un'origine. Per saperne di più, consulta Automatizza le build in risposta agli eventi webhook. Inoltre, per scoprire come utilizzare i trigger di webhook per creare repository da SCM specifici, consulta Creazione di repository da Bitbucket Server, Creazione di repository da Bitbucket Cloud e Creazione di repository da GitLab.
Trigger per i repository collegati a Developer Connect
Developer Connect ti consente di connettere prodotti esterni o strumenti per sviluppatori non Google a Google Cloud utilizzando passaggi e app standardizzati. Puoi configurare trigger che eseguono build da repository connessi tramite Developer Connect per i seguenti SCM:
- Bitbucket Cloud
- Bitbucket Data Center
- Bitbucket Server
- GitHub
- GitHub Enterprise
- GitLab
- GitLab Enterprise Edition
Funzionalità di attivazione
I trigger di Cloud Build offrono funzionalità che ti consentono di controllare in modo granulare l'esecuzione di una build. Questa sezione illustra le varie funzionalità associate ai trigger.
Trigger manuali pianificati
Puoi pianificare i trigger manuali per eseguire automaticamente le build in base a una pianificazione predefinita. Ad esempio, potresti voler configurare un trigger pianificato per eseguire una build ogni sabato alle 06:00. Per pianificare le build, puoi creare un trigger manuale e richiamarlo utilizzando Cloud Scheduler. Per saperne di più, consulta Pianifica build.
Filtro degli eventi
Cloud Build utilizza il Common Expression Language (CEL) con la variabile build sui campi elencati nella risorsa Build per accedere ai campi associati all'evento di build, ad esempio l'ID trigger, l'elenco di immagini o i valori di sostituzione. Puoi utilizzare la stringa filter per filtrare gli eventi di build nel file di configurazione della build utilizzando qualsiasi campo elencato nella risorsa Build. Per saperne di più, consulta Utilizza CEL per filtrare gli eventi di build.
Variabili di sostituzione
Puoi specificare variabili di sostituzione nel file di configurazione di compilazione per sostituire valori specifici in fase di compilazione. Ad esempio, potresti voler utilizzare variabili di sostituzione se un valore non è noto fino al momento della build o se vuoi riutilizzare una richiesta di build esistente con variabili diverse. Cloud Build fornisce sostituzioni predefinite che puoi utilizzare per le build richiamate dai trigger, ad esempio variabili che mappano al nome del trigger o del repository. Puoi anche definire le tue variabili di sostituzione. Per saperne di più, consulta Sostituzione dei valori delle variabili.
Espansioni dei parametri bash
Puoi applicare le espansioni dei parametri bash ai valori delle variabili di sostituzione. Le espansioni dei parametri bash consentono di manipolare le stringhe associate alle variabili esistenti. Ad esempio, puoi utilizzare le espansioni dei parametri bash per scrivere le lettere in maiuscolo o sostituire una sottostringa. Per scoprire di più, consulta Espansioni dei parametri Bash.
Associazioni di payload
Puoi archiviare parte del payload dell'evento del trigger come variabile di sostituzione utilizzando le associazioni del payload. Le variabili associate a un payload sono chiamate associazioni e sono disponibili per le build richiamate da eventi push e pull. Puoi utilizzare le associazioni per accedere a dati aggiuntivi relativi alla tua build, ad esempio l'autore di una richiesta di pull. Per saperne di più, consulta Associazioni di payload.
Approvazioni
Puoi configurare i trigger in modo che non eseguano immediatamente una build, ma la contrassegnino come in attesa fino all'approvazione. Se un utente con le autorizzazioni approva una build in attesa, la build viene avviata. Se l'approvazione viene negata, la build non viene avviata. Per scoprire come configurare i trigger che richiedono l'approvazione, consulta Controlla le build in base all'approvazione.
Notifiche sullo stato della build
Puoi configurare gli strumenti di notifica di Cloud Build in modo che ascoltino gli aggiornamenti degli eventi di build da Pub/Sub
nell'argomento cloud-builds predefinito o in un argomento definito dall'utente.
Gli utenti che inviano notifiche possono anche filtrare i messaggi ricevuti dall'argomento e inviare messaggi ai servizi connessi. Cloud Build fornisce e gestisce immagini di notifica di cui è possibile eseguire il deployment nel repository cloud-build-notifiers.
Puoi configurare le notifiche utilizzando un notifier di Cloud Build, ad esempio BigQuery, HTTP, Slack o SMTP, oppure creare il tuo notifier.
Service account per i trigger di build
Quando un trigger richiama una build, Cloud Build esegue i passaggi di build utilizzando un account di servizio. A seconda della configurazione del trigger e delle impostazioni della policy dell'organizzazione del progetto, le build richiamate dai trigger possono utilizzare uno dei seguenti service account:
- Service account specificato dall'utente
(
ACCOUNT_NAME@PROJECT_ID.): consigliato. Sei tu a creare e gestire questo account di servizio e a concedere solo le autorizzazioni di Identity and Access Management (IAM) necessarie per la build del trigger. - Service account predefinito Compute Engine
(
PROJECT_NUMBER-compute@): il service account di build predefinito per i progetti che hanno eseguito la prima build dopo la modifica del account di servizio predefinito, a meno che non sia limitato dalle policy dell'organizzazione. In questi progetti, devi selezionare esplicitamente un account di servizio (un service account specificato dall'utente o il account di servizio predefinito di Compute Engine) durante la creazione o l'aggiornamento di un trigger. - Service account Cloud Build legacy (
PROJECT_NUMBER@cloudbuild.): utilizzato come account di servizio di build predefinito nei progetti che hanno eseguito build prima della modifica del account di servizio predefinito o nelle organizzazioni che hanno disattivato la modifica. In questi progetti, se il camposerviceAccountdi un trigger non viene specificato, il trigger utilizza per impostazione predefinita il account di servizio Cloud Build legacy.
Prima di concedere i ruoli IAM per i passaggi di build di un trigger, verifica quale account di servizio è configurato sul trigger. Per le istruzioni, consulta Identifica il account di servizio da configurare.
Passaggi successivi
- Scopri come creare e gestire i trigger di build.
- Scopri come configurare i service account specificati dall'utente.