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 definiti 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

  • Abilita l'API Cloud Build.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'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. Ad esempio, crei una pipeline per il deployment del codice sorgente in un ambiente di staging o di produzione. Potresti voler automatizzare il flusso di lavoro, ma solo per 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 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 del trigger:

    • Nome: un nome per l'attivatore.

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

    • Generazione del repository: seleziona 2ª gen..

    • Branch o Tag: imposta una delle seguenti opzioni:

      • Branch: imposta un trigger per la creazione su questo ramo. Devi specificare un valore letterale. Le espressioni regolari non sono supportate.
      • Tag: imposta un trigger per la creazione in base a questo tag. Devi specificare un valore letterale. 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 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 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 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 di compilazione inline. 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 il trigger manuale.

gcloud

Per creare un attivatore manuale:

  1. Apri una finestra del terminale.

  2. Esegui il seguente comando gcloud per creare un trigger di build nel tuo progetto:

    gcloud builds triggers create manual \
  --region=REGION \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch=BRANCH_NAME \
  --build-config=BUILD_CONFIG_FILE \
  --service-account=SERVICE_ACCOUNT

Dove:

  • REGION è la regione del trigger.
  • TRIGGER_NAME è il nome del trigger.
  • PROJECT_ID è l'ID progetto Google Cloud .
  • CONNECTION_NAME è il nome della connessione host.
  • REPO_NAME è il nome del repository.
  • BRANCH_NAME è il nome della filiale. Puoi anche specificare un tag utilizzando --tag o un ID commit utilizzando --sha.
  • BUILD_CONFIG_FILE è il percorso del file di configurazione della build. Puoi anche specificare un file di configurazione di compilazione incorporato utilizzando --inline-config o un Dockerfile utilizzando --dockerfile, --dockerfile-dir e dockerfile-image.
  • SERVICE_ACCOUNT è l'indirizzo email associato al tuo account di servizio. Se non includi questo flag, viene utilizzato un service account predefinito.

Per un elenco completo dei flag, consulta la documentazione di riferimento gcloud su 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 l'attivatore 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 il nome di un ramo, il nome di un tag o variabili di sostituzione, potrai ignorare questi campi al momento dell'invocazione.

    Se il trigger utilizza un repository con più di 500 rami o tag, alcuni potrebbero non essere presenti nei suggerimenti. Puoi comunque inserire manualmente il nome di un ramo o di un tag.

    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, vedi 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 del trigger.
  • REGION è la regione del trigger.
  • BRANCH_NAME è il nome della filiale. Puoi anche specificare un tag utilizzando --tag o un ID commit utilizzando --sha.
  • SUBSTITUTION_VAR (facoltativo) è il nome della variabile per il valore di sostituzione.
  • SUBSTITUTION_VALUE (facoltativo) è il valore associato alla variabile di sostituzione.

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

Passaggi successivi