Compilare manualmente il codice nei repository di origine

Questa pagina spiega come creare trigger manuali per compilare il codice nei repository di origine. Gli attivatori manuali possono essere utilizzati per richiamare le build manualmente, con la possibilità di sostituire i valori delle variabili di sostituzione definite al momento della chiamata prima di eseguire una build. Puoi anche programmare trigger manuali per l'esecuzione automatica 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

  • Enable the Cloud Build API.

    Enable the API

  • Tieni a portata di mano il codice sorgente.

Trigger manuali

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

I trigger manuali ti consentono di richiamare manualmente le build:

  • 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.
  • Eseguire l'override dei valori delle variabili di sostituzione definite al momento dell'invocazione prima di invocare una build.

Se vuoi eseguire le build dalla tua directory di lavoro locale anziché da un repository ospitato o vuoi inviare le build senza creare un trigger, puoi eseguire il seguente comando gcloud nella tua 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 Trigger:

    Apri la pagina Trigger

  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 del trigger:

    • Nome: un nome per il trigger.

    • Regione: seleziona la regione per il trigger.

      • 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 del trigger.

    • Evento: seleziona Richiamo 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 1ª generazione o 2ª generazione come origine.

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

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

    • Tag: imposta un trigger da creare in questo tag. Devi specificare un valore letterale. Le espressioni regolari non sono attualmente supportate.

    • Configurazione: seleziona il file di configurazione della build che si trova nel repository remoto o crea un file di configurazione della build 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 della build 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, fornisci la posizione del file di configurazione della build, della directory Dockerfile o della directory dei buildpack. Se il tipo di configurazione della build è Dockerfile o un 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 del buildpack, vedrai un'anteprima del comando docker build o pack che verrà eseguito dalla build.
        • Inline: se hai selezionato File di configurazione di Cloud Build (yaml o json) come opzione di configurazione, puoi specificare la configurazione della build inline. Fai clic su Apri editor per scrivere il file della configurazione di compilazione 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 il trigger manuale.

gcloud

Per un elenco completo dei flag, consulta il riferimento gcloud per scoprire come creare trigger 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 dei trigger

  2. Individua il trigger nell'elenco.

  3. Fai clic su Esegui attivatore.

    Dopo aver fatto clic su Esegui attivatore, vedrai il riquadro della finestra Esegui attivatore sul lato destro. Se hai specificato campi come un nome di ramo, un nome di tag o variabili di sostituzione, potrai ignorare questi campi al momento dell'invocazione.

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

    Per eseguire trigger manuali in base a una pianificazione, consulta la sezione Pianificazione delle build.

gcloud

Per eseguire un trigger manuale utilizzando lo strumento a riga di comando gcloud, esegui il seguente 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 del trigger.
  • BRANCH_NAME è il nome della tua filiale. 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 trigger manuali in base a una pianificazione, consulta la sezione Pianificazione delle build.

Passaggi successivi