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 viene eseguito un nuovo commit il push a un repository o all'avvio di una richiesta di pull esegue automaticamente una build quando arrivano nuovi eventi. Puoi anche configurare per creare il codice a seguito di qualsiasi modifica al repository di codice sorgente o solo modifiche che soddisfano determinati criteri.

Questa pagina fornisce una panoramica di ogni tipo di trigger e funzionalità associati con i trigger.

Trigger di eventi di repository

Cloud Build ti consente di eseguire automaticamente le build sul repository come push o richieste di 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 sia possibile connettere qualsiasi repository di codice sorgente Cloud Build, Cloud Build fornisce un repository specifico trigger di eventi utilizzabili per integrare una gestione di codice sorgente specifica sistemi (SCM). Questa sezione illustra i trigger di eventi disponibili del repository.

Attenzione:a partire dal 17 giugno 2024 Cloud Source Repositories non è disponibile a nuovi clienti. Se la tua organizzazione non ha Cloud Source Repositories usato in precedenza, non puoi abilitare l'API Cloud Source Repositories. I nuovi progetti non connessi a un'organizzazione non possono abilitare la l'API Cloud Source Repositories. Organizzazioni che hanno utilizzato Cloud Source Repositories prima di Il 17 giugno 2024 non è interessato da questa modifica.

Trigger di GitHub

Puoi creare trigger GitHub per eseguire automaticamente build in risposta a di eventi del repository, come push o richieste di pull. Puoi visualizzare lo stato del trigger su GitHub e Google Cloud. Puoi utilizzare anche App GitHub di Cloud Build per connetterti e creare il codice in GitHub. Per saperne di più, vedi Creazione di repository da GitHub.

Trigger di GitHub Enterprise

Puoi creare trigger per repository ospitati su un'istanza GitHub Enterprise, incluse le istanze ospitate in un ambiente on-premise e non raggiungibili su una connessione a internet pubblica. I trigger di GitHub Enterprise possono essere utilizzati per eseguire build in risposta a richieste di push o pull da un'istanza GitHub Enterprise. Per saperne di più, vedi 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. A per saperne di più, consulta 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 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 data center Bitbucket

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. Tu puoi anche configurare trigger manuali esegui una programmazione. Per saperne di più, vedi Crea manualmente il codice nei repository di origine.

Trigger di Pub/Sub

Nota: i trigger Pub/Sub di Cloud Build non sono supportati quando si utilizza Controlli di servizio VPC.

Puoi creare trigger Pub/Sub per eseguire build in risposta qualsiasi messaggio pubblicato su Pub/Sub. Ad esempio, puoi utilizzare Trigger di Pub/Sub per la creazione in risposta ai push delle immagini 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 ai webhook. Gli eventi webhook inviati a un URL personalizzato ti consentono di collegare direttamente e sistemi di gestione del codice sorgente (SCM) esterni, come Bitbucket.com, Bitbucket Server o GitLab in Cloud Build. Quando creando trigger webhook, puoi anche definire la configurazione della build in linea sul tuo trigger per controllare quali repository vengono clonati dal trigger durante la build anziché specificare in modo esplicito un'origine. Per saperne di più, vedi Automatizzare le build in risposta agli eventi webhook. Inoltre, per imparare a utilizzare i trigger webhook per creare repository 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 ti consentono di avere sull'esecuzione di una build. Questa sezione tratta diversi associate ai trigger.

Trigger manuali pianificati

Puoi pianificare trigger manuali per eseguire automaticamente le build su un una pianificazione predefinita. Ad esempio, potresti voler configurare un trigger pianificato di eseguire una build ogni sabato alle 06:00. Per pianificare le build, puoi crea un attivatore manuale e richiamare il trigger utilizzando Cloud Scheduler. Per saperne di più, vedi Pianificare le build.

Applicazione di filtri agli eventi

Cloud Build usa Common Expression Language (CEL) con build, nei campi elencati in Crea risorsa per accedere campi associati all'evento di build, ad esempio l'ID trigger, l'elenco di immagini o 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 apprendere Scopri 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 sostituire valori specifici al momento della creazione. 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 build richiamate dai trigger, ad esempio le variabili mappate al trigger o il 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. Bash le espansioni dei parametri consentono di manipolare le stringhe associate le variabili esistenti. Ad esempio, puoi usare le espansioni dei parametri bash per inserire le lettere maiuscole o sostituire una sottostringa. Per saperne di più, vedi Espansioni dei parametri principali.

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 chiamati "associazioni" e sono disponibili per le build richiamate da eventi push e pull. Puoi utilizzare le associazioni per accedere a dati aggiuntivi relative alla build, ad esempio l'autore di una richiesta di 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 negata, la build non viene avviata. A imparerai a configurare trigger l'approvazione, consulta Si basa sull'approvazione.

Notifiche sullo stato della build

Puoi configurare i notifier di Cloud Build per ascoltare l'evento di build dall'argomento Pub/Sub cloud-builds. I mittenti possono filtra i messaggi ricevuti per l'argomento e invia quelli ai tuoi i servizi di machine learning. Cloud Build fornisce e gestisce il server di notifica di cui è possibile eseguire il deployment immagini nel Repository cloud-build-notifiers. Puoi configurare le notifiche usando un notifier di Cloud Build, ad esempio BigQuery, HTTP Slack oppure SMTP o crea un avviso personalizzato.

Passaggi successivi

• Scopri come creare e gestire i trigger di build.