Trigger di Cloud Build

Cloud Build utilizza i trigger di build per abilitare l'automazione CI/CD. Puoi configurare trigger per l'ascolto degli eventi in arrivo, ad esempio quando un nuovo commit viene eseguito in push a un repository o quando viene avviata una richiesta di pull, quindi esegue automaticamente una build quando arrivano nuovi eventi. Puoi anche configurare trigger per creare codice su qualsiasi modifica al repository di codice sorgente o solo su modifiche che soddisfano determinati criteri.

Questa pagina fornisce una panoramica di ogni tipo di attivatore e delle funzionalità associate agli attivatori.

Trigger eventi repository

Cloud Build ti consente di eseguire automaticamente build su eventi di repository come push o pull delle richieste. Puoi connettere repository esterni, come GitHub in GitHub o Bitbucket, a Cloud Build o utilizzare codice in Cloud Source Repositories per le tue build. Anche se puoi connettere qualsiasi repository di codice sorgente a Cloud Build, Cloud Build fornisce trigger di eventi specifici del repository che puoi utilizzare per integrare facilmente specifici sistemi di gestione del codice sorgente (SCM). Questa sezione si occupa dei trigger di eventi del repository disponibili.

Trigger di GitHub

Puoi creare trigger GitHub per eseguire automaticamente build in risposta a eventi di repository, come push o pull delle richieste. Puoi visualizzare lo stato della build del trigger su GitHub e sulla console. Puoi anche utilizzare l'app GitHub di Cloud Build per connetterti e creare codice in GitHub. Per saperne di più, vedi 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 Internet pubblica. I trigger di GitHub Enterprise possono essere utilizzati per eseguire build in risposta a push o pull di richieste da un'istanza GitHub Enterprise. Per saperne di più, vedi Creare repository da GitHub Enterprise.

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

Trigger di data center Bitbucket

Puoi creare trigger per i repository ospitati su un'istanza di data center di Bitbucket, incluse le istanze ospitate in un ambiente on-premise. I trigger di Data center Bitbucket possono essere utilizzati per eseguire le 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.

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 di eseguire una build. Puoi anche configurare gli attivatori manuali in modo che vengano eseguiti secondo una pianificazione. Per scoprire di più, consulta Creare manualmente il 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 trigger Pub/Sub per la creazione in risposta a push di immagini ad Artifact Registry. In questo caso, puoi configurare il trigger in modo che utilizzi filtri per eseguire una build solo se l'immagine di cui esegui il push corrisponde a un tag specifico, ad esempio prod. Inoltre, gli attivatori 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.

Attivatori 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 sistemi esterni e sistemi di gestione del codice sorgente esterni (SCM), ad esempio Bitbucket.com, Bitbucket Server o GLaLab a Cloud Build. Quando crei trigger webhook, puoi anche definire la configurazione della build in linea con il tuo trigger per controllare quali repository clona il trigger durante la build, anziché specificare esplicitamente un'origine. Per scoprire 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 attivazione

I trigger di Cloud Build offrono funzionalità che offrono un controllo granulare sulle modalità di esecuzione di una build. In questa sezione vengono illustrate le varie funzionalità associate agli attivatori.

Pianificazione degli attivatori manuali

Puoi pianificare 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 6:00. Per pianificare le build, puoi creare un trigger manuale e richiamare il trigger utilizzando Cloud Scheduler. Per scoprire di più, consulta Programmare 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 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 qualsiasi campo elencato nella risorsa Build. Per ulteriori informazioni, consulta Utilizzare la tecnologia 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 le variabili di sostituzione se un valore è sconosciuto 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 da trigger, ad esempio la mappatura delle variabili al nome del trigger o al nome del repository. Puoi anche definire variabili di sostituzione personalizzate. Per ulteriori informazioni, consulta la sezione Sostituzione dei valori delle variabili.

Espansioni parametri Bash

Puoi applicare espansioni del parametro bash ai valori delle variabili di sostituzione. Le espansioni del parametro Bash consentono di manipolare le stringhe associate alle variabili esistenti. Ad esempio, puoi utilizzare le espansioni dei parametri bash per scrivere in maiuscolo o sostituire una sottostringa. Per ulteriori informazioni, consulta Espansioni dei parametri della lavagna.

Associazioni 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 denominate associazioni e sono disponibili per le build richiamate sia da eventi push che pull. Puoi utilizzare le associazioni per accedere a dati aggiuntivi relativi alla tua build, come l'autore di una richiesta di pull. Per ulteriori informazioni, consulta la sezione Associazioni payload.

Approvazione delle build

Puoi configurare i trigger in modo che non vengano eseguiti immediatamente, ma possono invece essere contrassegnati come in sospeso fino all'approvazione. Se un utente con autorizzazioni approva una build in sospeso, questa viene avviata. Se l'approvazione viene rifiutata, la build non viene avviata. Per informazioni su come configurare i trigger che richiedono l'approvazione, consulta la pagina relativa alle build del certificato all'approvazione.

Notifiche sullo stato della build

Puoi configurare i notificatori di Cloud Build per ascoltare gli aggiornamenti degli eventi dall'argomento cloud-builds di Pub/Sub. I rilevatori possono anche filtrare i messaggi ricevuti dall'argomento e inviarli al servizio desiderato. Cloud Build fornisce e mantiene le immagini dei notificatori di cui è possibile eseguire il deployment nel repository cloud-build-notifiers. Puoi configurare le notifiche utilizzando un notificatore Cloud Build, ad esempio BigQuery, HTTP, Slack o SMTP oppure crea il tuo notificatore.

Passaggi successivi