Trigger di Cloud Build

Cloud Build utilizza gli attivatori di build per abilitare l'automazione CI/CD. Puoi configurare gli attivatori in modo che ascoltino 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 arrivano nuovi eventi. Puoi anche configurare 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.

Trigger evento del repository

Cloud Build ti consente di eseguire automaticamente le build su eventi del repository come push o richieste pull. Puoi collegare repository esterni, come quelli su GitHub o Bitbucket, a Cloud Build o utilizzare il codice in Cloud Source Repositories per le tue build. Sebbene tu possa collegare qualsiasi repository di origine a Cloud Build, Cloud Build fornisce trigger di eventi di repository specifici che puoi utilizzare per integrare sistemi di gestione del codice sorgente (SCM) specifici. Questa sezione illustra gli attivatori di eventi del repository disponibili.

Trigger di GitHub

Puoi creare trigger di GitHub per eseguire automaticamente le build in risposta a eventi del repository, come push o richieste pull. Puoi visualizzare lo stato della compilazione dell'attivatore su GitHub e nella console Google Cloud. Puoi anche utilizzare l'app GitHub di Cloud Build per connettere e compilare il codice in GitHub. Per saperne di più, consulta Creare 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. Gli attivatori GitHub Enterprise possono essere utilizzati per eseguire build in risposta a push o richieste di pull da un'istanza GitHub Enterprise. Per saperne di più, consulta Creazione di repository da GitHub Enterprise.

Trigger di GitLab Enterprise Edition

Puoi creare attivatori per i repository ospitati su un'istanza di GitLab Enterprise Edition, incluse le istanze ospitate in una rete privata. Gli 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 approfondire, consulta Creazione di repository da GitLab Enterprise Edition.

Attivatori 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 a eventi, consulta Creare repository da Bitbucket Server.

Trigger di Bitbucket Data Center

Puoi creare attivatori per i repository ospitati su un'istanza di Bitbucket Data Center, incluse le istanze ospitate in un ambiente on-premise. Gli attivatori di Bitbucket Data Center possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste pull. Per scoprire di più, consulta Creazione di repository da Bitbucket Data Center.

Trigger di Bitbucket Cloud

Puoi creare trigger per i repository ospitati in Bitbucket Cloud. Gli attivatori di Bitbucket Cloud possono essere utilizzati per eseguire build in risposta a eventi come push di commit o richieste pull. Per scoprire di più, consulta Creazione di repository da Bitbucket Cloud.

Trigger manuali

Puoi creare trigger manuali per eseguire manualmente le build e sostituire i valori delle variabili di sostituzione definiti al momento dell'invocazione prima di eseguire una build. Puoi anche configurare gli attivatori manuali per l'esecuzione in base a una pianificazione. Per saperne di più, consulta Eseguire la compilazione manuale del codice nei repository di origine.

Trigger Pub/Sub

Puoi creare trigger Pub/Sub per eseguire build in risposta a qualsiasi messaggio pubblicato su Pub/Sub. Ad esempio, puoi utilizzare gli attivatori Pub/Sub per la compilazione in risposta ai push delle immagini in Artifact Registry. In questo caso, puoi configurare l'attivatore in modo da utilizzare i filtri per eseguire una compilazione 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 iscriversi a qualsiasi argomento Pub/Sub. Per scoprire di più, consulta Automatizzare le build in risposta agli eventi Pub/Sub.

Trigger webhook

Puoi creare trigger webhook per eseguire build in risposta agli webhook. Gli eventi webhook inviati a un URL personalizzato ti consentono di collegare 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 webhook, puoi anche definire la configurazione di compilazione in linea sul trigger per controllare i repository che il trigger clona durante la compilazione anziché specificare esplicitamente un'origine. Per scoprire di più, consulta Automatizzare le build in risposta agli eventi webhook. Inoltre, per scoprire come utilizzare gli attivatori webhook per creare repository da SCM specifici, consulta Creare repository da Bitbucket Server, Creare repository da Bitbucket Cloud e Creare repository da GitLab.

Funzionalità di attivazione

Gli attivatori Cloud Build offrono funzionalità che ti consentono di avere un controllo granulare sul modo in cui viene eseguita una compilazione. Questa sezione illustra le varie funzionalità associate agli attivatori.

Trigger manuali pianificati

Puoi pianificare gli attivatori manuali per eseguire automaticamente le build in base a una programmazione 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 invocarlo utilizzando Cloud Scheduler. Per scoprire di più, consulta la sezione Pianificare le build.

Filtrare gli eventi

Cloud Build utilizza il Common Expression Language (CEL) con la variabile build nei 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 compilazione nel file di configurazione della build utilizzando qualsiasi campo elencato 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 di compilazione per sostituire valori specifici in fase di compilazione. Ad esempio, potresti voler utilizzare le variabili di sostituzione se un valore non è noto fino al momento della compilazione o se vuoi riutilizzare una richiesta di compilazione esistente con variabili diverse. Cloud Build fornisce sostituzioni predefinite che puoi utilizzare per le compilazioni richiamate dagli trigger, ad esempio le variabili che mappano il nome dell'trigger o 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 utilizzare le espansioni di parametri bash per mettere le lettere in maiuscolo o sostituire una sottostringa. Per scoprire di più, consulta Espansioni dei parametri di Bash.

Associazioni di payload

Puoi memorizzare parte del payload dell'evento dell'attivatore 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 sia dagli eventi push che da quelli pull. Puoi utilizzare le associazioni per accedere a dati aggiuntivi correlati alla tua build, ad esempio l'autore di una richiesta di pull. Per saperne di più, consulta Eseguire il binding del payload.

Approvazioni

Puoi configurare gli attivatori in modo che non eseguano immediatamente una compilazione, ma contrassegnino una compilazione come in attesa fino all'approvazione. Se un utente con autorizzazioni approva una compilazione in attesa, la compilazione viene avviata. Se l'approvazione viene rifiutata, la compilazione non si avvia. Per scoprire come configurare gli attivatori che richiedono l'approvazione, consulta Eseguire il controllo delle build in base all'approvazione.

Crea notifiche di stato

Puoi configurare i notificatori Cloud Build in modo che ascoltino gli aggiornamenti degli eventi di compilazione dall'argomento Pub/Sub cloud-builds. I notificatori possono anche filtrare i messaggi ricevuti dall'argomento e inviare messaggi ai servizi collegati. 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 Cloud Build, come BigQuery, HTTP, Slack o SMTP oppure creare il tuo notificatore.

Passaggi successivi