Compilare manualmente il codice nei repository di origine

Questa pagina spiega come creare attivatori manuali per compilare il codice nei repository di origine. Gli attivatori manuali possono essere utilizzati per invocare manualmente le build, con la possibilità di sostituire i valori delle variabili di sostituzione definiti al momento dell'invocazione prima di eseguire una build. Puoi anche pianificare l'esecuzione automatica degli attivatori manuali in un momento 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

Gli trigger manuali ti consentono di configurare build che vengono eseguite solo quando richiami l'trigger nei 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 solo per eseguire le compilazioni manualmente. A tal fine, puoi definire attivatori manuali.

Gli trigger manuali ti consentono di richiamare manualmente le build:

  • Recupero del codice sorgente da un repository ospitato con un ramo o un tag specificato.
  • Parametrizza la build con sostituzioni che non devono essere passate manualmente ogni volta che esegui una build.
  • Sostituzione dei valori delle variabili di sostituzione definiti al momento dell'invocazione prima di invocare una compilazione.

Se vuoi eseguire le build dalla tua directory di lavoro locale anziché da un repository ospitato o vuoi inviare le build senza creare un attivatore, 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 codice sorgente del percorso o 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 di trigger:

    • Nome: un nome per l'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 all'attivatore specifica un pool privato, Cloud Build utilizza il pool privato per eseguire la build. In questo caso, la regione specificata nell'attivatore deve corrispondere a quella in cui hai creato il pool privato.
      • Se selezioni una regione non globale e il file di configurazione di compilazione associato all'attivatore non specifica un pool privato, Cloud Build utilizza il pool predefinito per eseguire la compilazione nella stessa regione dell'attivatore.

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

    • Evento: seleziona Richiamo manuale per configurare l'attivatore in modo che le compilazioni vengano eseguite solo quando viene richiamato manualmente.

    • Origine: seleziona il repository da compilare quando viene eseguito l'attivatore manuale. Puoi specificare 1ª generazione o 2ª generazione come origine.

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

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

    • Tag: imposta un attivatore per la compilazione in base a questo tag. Devi specificare un valore letterale. Le espressioni regolari non sono attualmente supportate.

    • Configurazione: seleziona il file di configurazione della build nel tuo repository remoto o crea un file di configurazione della build in linea 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 tua configurazione.
        • Dockerfile: utilizza un Dockerfile per la configurazione.

      • Posizione: specifica la posizione della 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 compilazione è Dockerfile o un buildpack, devi fornire un nome per l'immagine risultante e, facoltativamente, un timeout per la compilazione. Dopo aver fornito il nome dell'immagine Dockerfile o del buildpack, vedrai un'anteprima del comando docker build o pack che verrà eseguito durante la compilazione.
        • In linea: se hai selezionato File di configurazione di 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 della configurazione di compilazione nella console Google Cloud utilizzando la sintassi YAML o JSON. Fai clic su Fine per salvare la configurazione di compilazione.

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

gcloud

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

Esecuzione di trigger manuali

Console

Per eseguire un attivatore manuale utilizzando la console Google Cloud :

  1. Apri la pagina Trigger nella console Google Cloud .

    Apri la pagina degli trigger

  2. Individua l'attivatore nell'elenco.

  3. Fai clic su Esegui attivatore.

    Dopo aver fatto clic su Esegui trigger, viene visualizzato il riquadro della finestra Esegui trigger sul lato destro. Se hai specificato campi come il nome di un ramo, il nome di un tag o le variabili di sostituzione, potrai sostituirli al momento dell'invocazione.

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

    Per eseguire gli attivatori manuali in base a pianificazione, consulta Pianificare le 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 per l'attivatore.
  • 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 gli attivatori manuali in base a pianificazione, consulta Pianificare le build.

Passaggi successivi