Questa pagina spiega come creare trigger manuali per creare il codice nei repository di codice sorgente. È possibile usare gli attivatori manuali per richiamare manualmente le build, con la possibilità di sostituire i valori delle variabili di sostituzione definiti in prima di eseguire una build. Puoi anche programmare manualmente vengano eseguiti automaticamente in un momento specifico.
Per scoprire come avviare manualmente le build utilizzando gcloud CLI l'API Cloud Build, vedi Avvio manuale delle build.
Prima di iniziare
-
Abilita l'API Cloud Build.
- Tieni a portata di mano il codice sorgente.
Attivatori manuali
I trigger manuali consentono di configurare build che vengono eseguite solo quando richiami il tuo trigger sui repository connessi. Supponiamo che tu stia creando una pipeline per il deployment del codice sorgente in un ambiente gestione temporanea o di produzione. Potresti voler automatizzare il flusso di lavoro, ma stai cercando solo di eseguire build manualmente. Per farlo, puoi definire trigger manuali.
I trigger manuali consentono di richiamare manualmente le build tramite:
- Recupero del codice sorgente da un repository ospitato con un ramo o tag specificato.
- Parametizzazione della build con sostituzioni che non devono essere trasmesse manualmente ogni volta che esegui una build.
- Override dei valori delle variabili di sostituzione definite al momento della chiamata precedente al richiamando una build.
Se vuoi eseguire build dalla directory di lavoro locale anziché da un repository ospitato
o se vuoi inviare build senza creare un trigger, puoi eseguire questo
gcloud
nella directory di lavoro:
gcloud builds submit --config BUILD_CONFIG SOURCE_CODE
Dove:
- BUILD_CONFIG è il percorso del file di configurazione della build.
- SOURCE_CODE è il percorso o il codice sorgente dell'URL.
Per scoprire di più su come usare il comando gcloud
per avviare manualmente le build
nella tua directory locale, vedi Avvio manuale delle build.
Creazione di trigger manuali
Console
Per creare un attivatore manuale:
Apri la pagina Attivatori:
Seleziona il tuo progetto nella parte superiore della pagina e fai clic su Apri.
Fai clic su Crea trigger.
Inserisci le seguenti impostazioni di trigger:
- Nome: un nome per l'attivatore.
Regione: seleziona la regione per il tuo trigger.
- Se selezioni global come regione, Cloud Build utilizza il valore predefinito pool per eseguire la build.
- Se selezioni una regione non globale e file di configurazione di compilazione associato al trigger specifica un pool privato, Cloud Build utilizza il pool per eseguire la build. In questo caso, la regione specificata nel trigger deve corrispondere alla regione in cui hai creato il pool privato.
- Se selezioni una regione non globale e file di configurazione di compilazione associato al trigger non specifica un pool privato, Cloud Build utilizza il valore predefinito pool per eseguire la build nella stessa regione come trigger.
(Facoltativo) Descrizione: una descrizione dell'attivatore.
Evento: seleziona Chiamata manuale per configurare il trigger in modo da creare eseguito solo quando il trigger viene richiamato manualmente.
Origine: seleziona il repository da creare quando viene eseguito il trigger manuale. Puoi specifica 1a generazione o 2a generazione come origine.
Revisione: seleziona il ramo o tag da creare quando viene attivato manualmente viene eseguito.
Ramo: imposta un trigger per creare su questo ramo. Devi specificare un valore letterale. Al momento, le espressioni regolari non sono supportati.
Tag: imposta un attivatore da utilizzare per questo tag. Devi specificare un valore letterale valore. Le espressioni regolari non sono attualmente supportate.
Configurazione: seleziona il file di configurazione della build che si trova in repository remoto o creare un file di configurazione di compilazione incorporato per la tua build.
- Tipo: seleziona il tipo di configurazione da utilizzare per la build.
- File di configurazione di Cloud Build (yaml o json): Utilizza un file di configurazione di compilazione per la configurazione.
- Dockerfile: utilizza un
Dockerfile
per la configurazione.
Posizione: specifica la posizione per la configurazione.
- Repository: se il file di configurazione si trova nella cartella
repository remoto, fornisci la posizione
file di configurazione della build,
Dockerfile
o la directory buildpacks. Se la configurazione della build è unDockerfile
o un buildpack, dovrai fornire un nome per l'immagine risultante e, facoltativamente, un timeout per creare. Dopo che hai fornitoDockerfile
o buildpack nome dell'immagine, vedrai un'anteprima delladocker build
opack
che verrà eseguito dalla build. - In linea: se hai selezionato File di configurazione Cloud Build (yaml o json) come opzione di configurazione, puoi specificare la configurazione della build in linea. Fai clic su Apri editor per scrivere il file di configurazione della build nella console Google Cloud utilizzando la sintassi YAML o JSON. Fai clic su Fine per salvare la configurazione della build.
- Repository: se il file di configurazione si trova nella cartella
repository remoto, fornisci la posizione
file di configurazione della build,
- Tipo: seleziona il tipo di configurazione da utilizzare per la build.
Fai clic su Crea per creare l'attivatore manuale.
gcloud
Per un elenco completo dei flag, consulta la documentazione di riferimento di gcloud
su come creare attivatori manuali.
Esecuzione di trigger manuali
Console
Per eseguire un trigger manuale utilizzando la console Google Cloud:
Apri la pagina Trigger nella console Google Cloud.
Individua il trigger nell'elenco.
Fai clic su Esegui trigger.
Dopo aver fatto clic su Esegui trigger, verrà visualizzato il riquadro della finestra Esegui trigger. sul lato destro. Se hai specificato campi come il nome di un ramo, tag o variabili di sostituzione, potrai sostituire questi campi al momento della chiamata.
Se hai specificato nuovi valori per la sostituzione, fai clic su Esegui trigger. per eseguire la build.
Per eseguire trigger manuali in base alla programmazione, consulta Pianificazione delle build.
gcloud
Per eseguire un trigger manuale utilizzando lo strumento a riga di comando gcloud
, esegui questo comando:
:
gcloud builds triggers run TRIGGER_NAME \
--region=REGION \
--branch=BRANCH_NAME \
--substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE
Dove:
TRIGGER_NAME
è il nome del tuo trigger.REGION
è la regione per il tuo trigger.BRANCH_NAME
è il nome della tua filiale. Puoi specificare inoltre un tag utilizzando--tag
o un ID di commit utilizzando--sha
.- [Facoltativo]
SUBSTITUTION_VAR
è il nome della variabile per il valore di sostituzione. - [Facoltativo]
SUBSTITUTION_VALUE
è il valore associato alla tua sostituzione .
Per eseguire trigger manuali in base alla pianificazione, vedi Pianificazione delle build.
Passaggi successivi
- Scopri come avviare manualmente le build utilizzando i comandi
gcloud
o l'API Cloud Build. - Scopri come pianificare le build.
- Scopri come creare e gestire gli attivatori.
- Scopri come visualizzare i risultati della build.
- Scopri come risolvere gli errori di build.