Trigger di Cloud Build

Cloud Build utilizza i trigger di build per abilitare l'automazione CI/CD. Puoi configurare trigger per ascoltare gli 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 si verificano nuovi eventi. Puoi anche configurare gli attivatori per creare codice a seguito di qualsiasi modifica al repository di codice sorgente o solo in caso di modifiche che soddisfano determinati criteri.

Questa pagina fornisce una panoramica di ciascun tipo di trigger e delle funzionalità associati ai trigger.

Trigger di eventi di repository

Con Cloud Build puoi eseguire automaticamente build su eventi del repository come push o richieste di pull. Puoi connettere repository esterni, come repository in GitHub o Bitbucket, a Cloud Build oppure utilizzare il codice in Cloud Source Repositories per le tue build. Sebbene sia possibile connettere qualsiasi repository di codice sorgente a Cloud Build, Cloud Build fornisce trigger di eventi del repository specifici che puoi utilizzare per integrare specifici sistemi di gestione del codice sorgente (SCM). Questa sezione illustra i trigger di eventi disponibili del repository.

Trigger di GitHub

Puoi creare trigger GitHub per eseguire automaticamente build in risposta a eventi del repository, come push o richieste di pull. Puoi visualizzare lo stato della build del trigger su GitHub e Google Cloud. Puoi anche utilizzare l'app GitHub di Cloud Build per connetterti e creare il 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 pull o push da un'istanza GitHub Enterprise. Per saperne di più, consulta Creazione di repository da GitHub Enterprise.

Trigger di 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 repository GitLab Enterprise Edition. Per scoprire di più, vedi Creazione di repository da GitLab Enterprise Edition.

Trigger di Bitbucket Server

Puoi creare trigger per 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 saperne di più su come creare trigger per l'esecuzione di build in risposta agli eventi, consulta Creazione di repository da Bitbucket Server.

Trigger data center Bitbucket

Puoi creare trigger per repository ospitati su un'istanza di data center Bitbucket, incluse le istanze ospitate in un ambiente on-premise. I trigger di Data Center di Bitbucket possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste di pull. Per ulteriori informazioni, consulta Creazione di repository dal data center Bitbucket.

Trigger di Bitbucket Cloud

Puoi creare trigger per i repository ospitati in Bitbucket Cloud. Bitbucket I trigger Cloud possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste di pull. Per ulteriori informazioni, consulta Creazione di repository da Bitbucket Cloud.

Attivatori manuali

Puoi creare trigger manuali per eseguire manualmente le build e sostituire i valori delle variabili di sostituzione definiti al momento della chiamata, prima dell'esecuzione di una build. Puoi anche configurare trigger manuali in modo che vengano eseguiti in base a una pianificazione. Per scoprire di più, consulta Creare manualmente il codice nei repository di origine.

Trigger di 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 la creazione in risposta al push delle immagini ad Artifact Registry. In questo caso, puoi configurare il trigger in modo che utilizzi i filtri per eseguire una build solo se l'immagine sottoposta a push corrisponde a un tag specifico, ad esempio prod. Inoltre, i trigger di Pub/Sub possono essere configurati per eseguire la sottoscrizione a qualsiasi argomento Pub/Sub. Per saperne di più, consulta Automatizzare le build in risposta agli eventi Pub/Sub.

Trigger webhook

Puoi creare trigger 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, ad esempio Bitbucket.com, Bitbucket Server o GitLab. Quando crei trigger webhook, puoi anche definire la configurazione di compilazione in linea sul trigger per controllare quali repository vengono clonati dal trigger in fase di build anziché specificare esplicitamente un'origine. Per saperne di più, consulta Automatizzare le build in risposta agli eventi webhook. Inoltre, per imparare a utilizzare i trigger 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.

Funzionalità di trigger

I trigger di Cloud Build offrono funzionalità che offrono controllo granulare su come viene eseguita una build. Questa sezione illustra le varie funzionalità associate ai trigger.

Trigger manuali pianificati

Puoi pianificare trigger manuali per eseguire automaticamente le build in base a una pianificazione predefinita. Ad esempio, puoi configurare un trigger pianificato in modo che esegua una build ogni sabato alle 06:00. Per pianificare le build, puoi creare un trigger manuale e richiamare il trigger utilizzando Cloud Scheduler. Per scoprire di più, consulta Pianificare le build.

Applicazione di filtri agli eventi

Cloud Build utilizza Common Expression Language (CEL) con la variabile build, nei campi elencati nella risorsa Build per accedere ai campi associati all'evento di build, come l'ID trigger, l'elenco delle immagini o i valori di sostituzione. Puoi utilizzare la stringa filter per filtrare gli eventi di build nel file di configurazione di compilazione utilizzando uno qualsiasi dei campi elencati nella risorsa Build. Per scoprire di più, consulta Utilizzare CEL per filtrare gli eventi di build

Variabili di sostituzione

Puoi specificare variabili di sostituzione nel file di configurazione della build per sostituire valori specifici al momento della build. 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, come le variabili mappate al nome del trigger o al nome del repository. Puoi anche definire le tue variabili di sostituzione. Per scoprire di più, consulta la sezione 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 usare le espansioni dei parametri bah per usare le maiuscole o sostituire una sottostringa. Per scoprire di più, consulta Espansioni dei parametri in virgola.

Associazioni di payload

Puoi archiviare parte del payload degli eventi del trigger come variabile di sostituzione utilizzando associazioni di payload. Le variabili associate a un payload sono dette 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 scoprire di più, consulta Associazioni di payload.

Approvazioni

Puoi configurare i trigger in modo che non eseguano immediatamente una build, ma contrassegnano una build come in attesa fino all'approvazione. Se un utente con autorizzazioni approva una build in sospeso, viene avviata la build. Se l'approvazione viene negata, la build non viene avviata. Per scoprire come configurare i trigger che richiedono l'approvazione, consulta Bate di build all'approvazione.

Notifiche sullo stato della build

Puoi configurare i notifier di Cloud Build in modo che rimangano in ascolto per gli aggiornamenti degli eventi di build dall'argomento Pub/Sub cloud-builds. I mittenti possono anche filtrare i messaggi ricevuti dall'argomento e inviarli ai servizi connessi. Cloud Build fornisce e gestisce le immagini di notifica di cui è possibile eseguire il deployment nel repository cloud-build-notifiers. Puoi configurare le notifiche utilizzando un notificatore di Cloud Build, ad esempio BigQuery, HTTP, Slack o SFTP, oppure creare un avviso personalizzato.

Passaggi successivi