Crea 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 programmare manualmente vengano eseguiti automaticamente 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.

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 di gestione temporanea o di produzione. Potresti voler automatizzare il flusso di lavoro, ma solo per eseguire le compilazioni 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 un tag specificato.
  • Parametrizza la build con sostituzioni che non devono essere passate 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 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 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:

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

    • Nome: un nome per l'attivatore.

    • Regione: seleziona la regione per l'attivatore.

      • Se selezioni global come regione, Cloud Build utilizza il valore predefinito pool 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 per l'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 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 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 per la configurazione.

        • Repository: se il file di configurazione si trova nel percorso repository remoto, fornisci la posizione file di configurazione della build, Dockerfile o la directory buildpacks. Se la configurazione della build è un Dockerfile o un buildpack, dovrai fornire un nome per l'immagine risultante e, facoltativamente, un timeout per creare. 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 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 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.

Eseguire 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 degli trigger

  2. Individua l'attivatore nell'elenco.

  3. Fai clic su Esegui trigger.

    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 i 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 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 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 gli attivatori manuali in base a pianificazione, consulta Pianificare le build.

Passaggi successivi