Trigger di Cloud Build

Cloud Build utilizza i trigger di build per abilitare l'automazione CI/CD. Puoi configurare trigger per rimanere in ascolto per gli eventi in entrata, ad esempio l'invio di un nuovo commit a un repository o l'avvio di una richiesta di pull, per poi eseguire automaticamente una build quando arrivano nuovi eventi. Puoi anche configurare gli attivatori per creare codice su qualsiasi modifica al repository di codice sorgente o solo su modifiche che corrispondono a determinati criteri.

Questa pagina fornisce una panoramica di ogni tipo di trigger e delle funzionalità associate.

Trigger di eventi del repository

Cloud Build consente di eseguire automaticamente le build su eventi del repository, come push o richieste di pull. Puoi connettere a Cloud Build repository esterni, come repository in GitHub o Bitbucket, o 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 specifici del repository che puoi utilizzare per integrare specifici sistemi di gestione del codice sorgente (SCM). Questa sezione illustra i trigger di eventi del repository disponibili.

Trigger GitHub

Puoi creare trigger GitHub per eseguire automaticamente le build in risposta a eventi del repository, come push o richieste di pull. Puoi visualizzare lo stato della build del trigger in GitHub e nella console Google Cloud. Puoi anche utilizzare l'app GitHub di Cloud Build per connetterti e creare codice in GitHub. Per scoprire di più, consulta Creazione di repository da GitHub.

Trigger di GitHub Enterprise

Puoi creare trigger per i repository ospitati su un'istanza GitHub Enterprise, comprese le istanze ospitate in un ambiente on-premise e non raggiungibili tramite una connessione a internet pubblica. I trigger GitHub Enterprise possono essere usati 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 trigger per i repository ospitati su un'istanza GitLab Enterprise Edition, incluse le istanze ospitate in una rete privata. I trigger GitLab Enterprise Edition possono essere utilizzati per eseguire build in risposta a push o pull di richieste associate al tuo repository GitLab Enterprise Edition. Per scoprire 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 repository Bitbucket Server a Cloud Build più volte utilizzando più connessioni host. Per scoprire di più su come creare attivatori per l'esecuzione delle build in risposta agli eventi, consulta Creazione di repository da Bitbucket Server.

Trigger di Bitbucket Data Center

Puoi creare trigger per i repository ospitati in un'istanza di data center Bitbucket, 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 o richieste di 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. I trigger di Bitbucket Cloud possono essere utilizzati per eseguire build in risposta a eventi come i push di commit o le richieste di pull. Per scoprire di più, consulta Creazione di repository da Bitbucket Cloud.

Attivatori manuali

Puoi creare trigger manuali per eseguire le build manualmente e sostituire i valori della variabile 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 scoprire di più, consulta Creare manualmente il codice nei repository di codice sorgente.

Trigger Pub/Sub

Puoi creare trigger Pub/Sub per eseguire le build in risposta a qualsiasi messaggio pubblicato su Pub/Sub. Ad esempio, puoi utilizzare i trigger Pub/Sub per la creazione in risposta ai push delle immagini in Artifact Registry. In questo caso, puoi configurare l'attivatore in modo che utilizzi i filtri per eseguire una build solo se l'immagine push corrisponde a un tag specifico, ad esempio prod. Inoltre, i trigger Pub/Sub possono essere configurati per la sottoscrizione a qualsiasi argomento Pub/Sub. Per scoprire di più, consulta Automatizzare le build in risposta agli eventi Pub/Sub.

Trigger webhook

Puoi creare trigger per i webhook per eseguire le build in risposta ai webhook. Gli eventi webhook inviati a un URL personalizzato 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 della build in linea nel trigger per controllare i repository clonati dal trigger in fase di build, anziché specificare esplicitamente un'origine. Per scoprire di più, consulta Automatizzare le build in risposta agli eventi webhook. Inoltre, per imparare a usare 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 forniscono funzionalità che offrono un controllo dettagliato sull'esecuzione di una build. Questa sezione illustra le varie funzionalità associate ai trigger.

Attivatori manuali pianificati

Puoi pianificare i trigger manuali in modo che eseguano automaticamente le build in base a una pianificazione predefinita. Ad esempio, puoi configurare un trigger pianificato per l'esecuzione di una build ogni sabato alle 6:00. Per pianificare le build, puoi creare un trigger manuale e richiamarlo utilizzando Cloud Scheduler. Per scoprire di più, consulta Pianificare le build.

Filtrare gli 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, come 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 scoprire di più, consulta Utilizzare CEL per filtrare gli eventi di build.

Variabili di sostituzione

Puoi specificare le variabili di sostituzione nel file di configurazione della build per sostituire valori specifici al momento della creazione. Ad esempio, potresti voler usare le 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 le variabili mappate al nome del trigger o al nome del repository. Puoi anche definire variabili di sostituzione personalizzate. Per scoprire di più, consulta Sostituire i valori delle variabili.

Espansioni dei parametri Bash

Puoi applicare l'espansione dei parametri bash ai valori delle variabili di sostituzione. Le espansioni dei parametri Bash ti consentono di manipolare le stringhe associate alle variabili esistenti. Ad esempio, puoi usare le espansioni dei parametri bash per scrivere in maiuscolo o sostituire una sottostringa. Per scoprire di più, consulta Espansioni dei parametri Bash.

Associazioni di payload

Puoi archiviare parte del payload degli eventi del trigger come variabile di sostituzione utilizzando le associazioni di payload. Le variabili associate a un payload sono definite associazioni e sono disponibili per le build richiamate dagli eventi sia push che 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 li 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 rifiutata, la build non viene avviata. Per scoprire come configurare gli attivatori che richiedono l'approvazione, consulta Le build di Gate all'approvazione.

Notifiche sullo stato della build

Puoi configurare i notificatori di Cloud Build per rimanere in ascolto degli aggiornamenti degli eventi di build dall'argomento cloud-builds di Pub/Sub. I uploader possono anche filtrare i messaggi ricevuti dall'argomento e inviare i 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 notificatore di Cloud Build, come BigQuery, HTTP, Slack o Gmail, oppure creare il tuo notificatore.

Passaggi successivi