Crea manualmente il codice nei repository di origine

Questa pagina spiega come creare trigger manuali per creare codice nei repository di origine. I trigger manuali possono essere utilizzati per richiamare manualmente le build, con la possibilità di eseguire l'override dei 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 build eseguite solo quando richiami il trigger sui repository connessi. Supponi di dover creare una pipeline per eseguire il deployment del codice sorgente in un ambiente gestione temporanea o di produzione. Potresti voler automatizzare il flusso di lavoro, ma stai cercando di eseguire solo le 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 definiti al momento della chiamata, prima di richiamare una build.

Se vuoi eseguire build dalla directory di lavoro locale anziché un repository ospitato o vuoi inviare build senza creare un trigger, puoi eseguire questo 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 saperne 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 tuo progetto nella parte superiore della pagina e fai clic su Apri.

  3. Fai clic su Crea trigger.

  4. 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 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 alla regione 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 1a generazione o 2a generazione come origine.

    • Revisione: seleziona il ramo o tag da creare quando viene eseguito il trigger manuale.

    • Ramo: imposta un trigger per creare su questo ramo. Devi specificare un valore letterale. Le espressioni regolari non sono attualmente supportate.

    • Tag: imposta un attivatore da utilizzare per questo tag. Devi specificare un valore letterale. Le espressioni regolari non sono attualmente supportate.

    • Configurazione: seleziona il file di configurazione di compilazione che si trova nel repository remoto o crea un file di configurazione di compilazione incorporato da utilizzare 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 nel repository remoto, specifica la posizione del file di configurazione della build, della directory Dockerfile o della directory buildpacks. Se il tipo di configurazione di build è Dockerfile o buildpack, devi 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 build.
        • In linea: se hai selezionato l'opzione di configurazione File di configurazione Cloud Build (yaml o json), 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.

  5. 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:

  1. Apri la pagina Trigger nella console Google Cloud.

    Apri la pagina Attivatori

  2. Individua il trigger nell'elenco.

  3. Fai clic su Esegui trigger.

    Dopo aver fatto clic su Esegui trigger, verrà visualizzato il riquadro Esegui trigger sul lato destro. Se hai specificato campi come il nome di un ramo, il nome del tag o le variabili di sostituzione, potrai eseguire l'override di questi campi al momento della chiamata.

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

    Per eseguire trigger manuali in base alla pianificazione, vedi 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 anche specificare 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 variabile di sostituzione.

Per eseguire trigger manuali in base alla pianificazione, vedi Pianificazione delle build.

Passaggi successivi