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 di eventi di repository

Cloud Build ti consente di eseguire automaticamente le build su eventi del repository come push o richieste pull. Puoi connettere repository esterni, come repository in GitHub o Bitbucket, a Cloud Build o utilizzare in Cloud Source Repositories per le tue build. Sebbene tu possa collegare qualsiasi repository di codice sorgente 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 i trigger di eventi disponibili del repository.

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 utilizzare anche App GitHub di Cloud Build per connetterti e creare 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 trigger per repository ospitati su GitLab Enterprise Edition incluse le istanze ospitate in una rete privata. GitLab Enterprise I trigger di versione possono essere usati per eseguire build in risposta a push di commit richieste di pull associate al tuo repository GitLab Enterprise Edition. Per approfondire, consulta Creazione di repository da GitLab Enterprise Edition.

Trigger di Bitbucket Server

Puoi creare trigger per i repository ospitati su un'istanza di Bitbucket Server, incluse le istanze ospitate in un ambiente on-premise. Puoi collegare il tuo Repository Bitbucket Server in Cloud Build più volte con più connessioni host. Per saperne di più su come creare per eseguire build in risposta agli eventi, vedi Creazione di repository da Bitbucket Server.

Trigger di Bitbucket Data Center

Puoi creare trigger per repository ospitati in un data center Bitbucket incluse le istanze ospitate in un ambiente on-premise. Bitbucket I trigger dei data center possono essere utilizzati per eseguire build in risposta a eventi come di eseguire il commit di push o di richieste di pull. Per saperne di più, vedi 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 di eseguire il commit di push o di richieste di pull. Per saperne di più, vedi Creazione di repository da Bitbucket Cloud.

Attivatori manuali

Puoi creare trigger manuali per eseguire manualmente le build ed eseguire l'override definito dei valori delle variabili di sostituzione al momento della chiamata, prima dell'esecuzione di una build. Puoi anche configurare gli attivatori manuali per l'esecuzione in base a una pianificazione. Per saperne di più, consulta Compilare 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 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 che utilizzi i filtri per esegue una build solo se l'immagine sottoposta a push corrisponde a un tag specifico, ad esempio prod. Inoltre, i trigger Pub/Sub possono essere configurati per eseguire la sottoscrizione su qualsiasi argomento Pub/Sub. Per saperne di più, vedi 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 creando trigger webhook, puoi anche definire la configurazione della build in linea sul tuo trigger per controllare quali repository il trigger clona durante la build anziché specificare in modo esplicito un'origine. Per saperne 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

I trigger di Cloud Build offrono funzionalità che ti consentono di avere sull'esecuzione di una build. 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 build in del file di configurazione della build utilizzando uno qualsiasi dei campi elencati Risorsa di creazione. 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 compilazione per sostituire valori specifici in fase di compilazione. Ad esempio, potresti voler utilizza variabili di sostituzione se un valore non è noto fino al momento della build o se Vuoi riutilizzare una richiesta di build esistente con diverse variabili. 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 usare le espansioni dei parametri bash per inserire le lettere maiuscole o sostituire una sottostringa. Per scoprire di più, consulta Espansioni dei parametri di Bash.

Associazioni di payload

Puoi archiviare parte del payload degli eventi del trigger come sostituzione utilizzando associazioni di payload. Le variabili associate a un payload sono chiamate associazioni e sono disponibili per le build richiamate sia dagli eventi push sia da quelli pull. Puoi utilizzare le associazioni per accedere a dati aggiuntivi correlati alla tua build, ad esempio l'autore di una richiesta pull. Per saperne di più, consulta Associazioni di payload.

Approvazioni

Puoi configurare i trigger in modo che non eseguano immediatamente una build, ma contrassegnano una build in attesa fino all'approvazione. Se un utente con autorizzazioni approva una richiesta in sospeso viene avviata la build. Se l'approvazione viene rifiutata, la compilazione non si avvia. A imparerai a configurare trigger l'approvazione, consulta la sezione Gate si basa sull'approvazione.

Notifiche sullo stato della build

Puoi configurare i notificatori Cloud Build in modo che ascoltino gli aggiornamenti degli eventi di compilazione dall'argomento Pub/Sub cloud-builds. I mittenti possono filtra i messaggi ricevuti dall'argomento e invia quelli ai tuoi i servizi di machine learning. 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