Crea manualmente il codice nei repository di origine

Questa pagina spiega come creare trigger manuali per la creazione di codice nei repository di codice sorgente. I trigger manuali possono essere utilizzati per richiamare le build manualmente, con la possibilità di sostituire i valori delle variabili di sostituzione definiti al momento della chiamata prima di eseguire una build. Puoi anche pianificare gli attivatori manuali in modo che vengano eseguiti automaticamente a un orario specifico.

Per scoprire come avviare manualmente le build utilizzando gcloud CLI o l'API Cloud Build, consulta Avvio manuale delle build.

Prima di iniziare

  • Attiva l'API Cloud Build.

    Abilita l'API

  • Tieni a portata di mano il codice sorgente.

Attivatori manuali

I trigger manuali consentono di configurare le build che vengono eseguite solo quando lo richiami sui repository connessi. Supponiamo che tu stia creando una pipeline per eseguire il deployment del codice sorgente in un ambiente di gestione temporanea o produzione. Potresti voler automatizzare il flusso di lavoro, ma stai cercando di eseguire le build manualmente. A tale scopo, puoi definire attivatori manuali.

I trigger manuali consentono di richiamare manualmente le build tramite:

  • Recupero del codice sorgente da un repository ospitato con un ramo o un tag specificato.
  • Parametrizzare la build con sostituzioni che non devono essere passate manualmente ogni volta che esegui una build.
  • Override dei valori delle variabili di sostituzione definiti al momento della chiamata prima di chiamare una build.

Se vuoi eseguire build dalla directory di lavoro locale anziché da un repository ospitato o vuoi inviare build senza creare un trigger, puoi eseguire il seguente comando 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 utilizzare il comando gcloud per avviare manualmente le build nella directory locale, consulta Avvio manuale delle build.

Creazione di trigger manuali

Console

Per creare un attivatore manuale:

  1. Apri la pagina Attivatori:

    Apri la pagina Attivatori

  2. Seleziona il progetto nella parte superiore della pagina e fai clic su Apri.

  3. Fai clic su Crea trigger.

  4. Inserisci le seguenti impostazioni di attivazione:

    • Nome: il nome dell'attivatore.

    • Regione: seleziona la regione per l'attivatore.

      • Se selezioni globale come regione, Cloud Build utilizza il pool predefinito per eseguire la build.
      • Se selezioni una regione non globale e il file di configurazione della build associato al trigger specifica un pool privato, Cloud Build utilizza il pool privato per eseguire la build. In questo caso, la regione specificata nel trigger deve corrispondere a quella in cui hai creato il pool privato.
      • Se selezioni una regione non globale e il file di configurazione della build associato al trigger non specifica un pool privato, Cloud Build utilizza il pool predefinito per eseguire la build nella stessa regione del trigger.

    • (Facoltativo) Descrizione: una descrizione dell'attivatore.

    • Evento: seleziona Chiamata manuale per configurare il trigger in modo che le build vengano eseguite solo quando il trigger viene richiamato manualmente.

    • Origine: seleziona il repository da creare quando viene eseguito il trigger manuale. Puoi specificare la prima generazione o la seconda generazione come origine.

    • Revisione: seleziona il ramo o il tag da creare quando viene eseguito l'attivatore manuale.

    • Ramo: imposta un trigger per creare su questo ramo. Devi specificare un valore letterale. Al momento, le espressioni regolari non sono supportate.

    • Tag: imposta un attivatore da utilizzare in questo tag. Devi specificare un valore letterale. Al momento, le espressioni regolari non sono supportate.

    • Configurazione: seleziona il file di configurazione della build che si trova nel repository remoto o crea un file di configurazione di compilazione incorporato da utilizzare per la 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 tua configurazione.
        • Dockerfile: utilizza un Dockerfile per la configurazione.

      • Posizione: specifica la località per la configurazione.

        • Repository: se il file di configurazione si trova nel repository remoto, fornisci la posizione del file di configurazione della build, della directory Dockerfile o della directory buildpacks. Se il tipo di configurazione della build è Dockerfile o un buildpack, dovrai fornire un nome per l'immagine risultante e, facoltativamente, un timeout per la build. Dopo aver fornito il nome dell'immagine Dockerfile o buildpack, vedrai un'anteprima del comando docker build o pack che verrà eseguito dalla tua build.
        • In linea: se hai selezionato File di configurazione di Cloud Build (yaml o json) come opzione di configurazione, puoi specificare la configurazione di compilazione 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.

  5. Fai clic su Crea per creare l'attivatore manuale.

gcloud

Per un elenco completo dei flag, consulta la documentazione di riferimento gcloud su come creare attivatori manuali.

Esecuzione di trigger manuali

Console

Per eseguire un trigger manuale utilizzando la console Google Cloud:

  1. Apri la pagina Attivatori nella console Google Cloud.

    Apri la pagina Trigger

  2. Individua l'attivatore nell'elenco.

  3. Fai clic su Esegui trigger.

    Dopo aver fatto clic su Esegui trigger, sul lato destro vedrai la finestra Esegui trigger. Se hai specificato campi come nome ramo, nome tag o variabili di sostituzione, potrai eseguire l'override di questi campi al momento della chiamata.

    Se hai specificato nuovi valori di variabile per la sostituzione, fai clic su Esegui trigger per eseguire la build.

    Per eseguire i trigger manuali in base alla pianificazione, 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 dell'attivatore.
  • REGION è la regione per il trigger.
  • BRANCH_NAME è il nome del ramo. Puoi anche specificare un tag utilizzando --tag o un ID commit utilizzando --sha.
  • [Facoltativo]SUBSTITUTION_VAR è il nome della variabile per il valore di sostituzione.
  • [Facoltativo] SUBSTITUTION_VALUE è il valore associato alla variabile di sostituzione.

Per eseguire i trigger manuali in base alla programmazione, consulta Pianificazione delle build.

Passaggi successivi