Crea repository da GitLab

Cloud Build ti consente di creare trigger per la build da repository ospitati su GitLab, per eseguire build in risposta a eventi come push di commit o richieste di unione associate al tuo repository GitLab.

Questa pagina spiega come abilitare la funzionalità di trigger su un'istanza GitHub. Scopri di più sui trigger di Cloud Build e sui repository Cloud Build.

Prima di iniziare

  • Abilita le API Cloud Build and Secret Manager.

    Abilita le API

Creazione di un trigger GitLab in corso...

Console

Per creare un trigger GitLab utilizzando la console Google Cloud:

  1. Apri la pagina Attivatori:

    Apri la pagina Attivatori

  2. Seleziona il tuo progetto Google Cloud 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 il file di configurazione di compilazione 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 il file di configurazione di compilazione 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 l'evento del repository per richiamare il trigger.

      • Esegui il push a un ramo: imposta il trigger per avviare una build in caso di commit in un ramo specifico.

      • Esegui il push di un nuovo tag: imposta l'attivatore per avviare una build sui commit che contengono un determinato tag.

      • Richiesta di pull: imposta il trigger per avviare una build in caso di commit in una richiesta di unione.

    • Fonte: seleziona 2a generazione come fonte.

      • Repository: seleziona il repository desiderato dall'elenco di repository disponibili. Per connettere un nuovo repository, vedi Connettersi a un repository GitLab.

      • Ramo o Tag: specifica un'espressione regolare con il valore del ramo o del tag da abbinare. Per informazioni sulla sintassi accettabile delle espressioni regolari, consulta la sintassi RE2.

      • Controllo dei commenti: se hai selezionato Richiesta pull come Evento, scegli una delle seguenti opzioni per controllare se il trigger esegue automaticamente una build:

        • Obbligatorio, tranne che per proprietari e collaboratori: quando una richiesta di unione viene creata o aggiornata dal proprietario o da un collaboratore di un repository, le build vengono eseguite automaticamente dal trigger. Se un collaboratore esterno avvia l'azione, le build verranno eseguite solo dopo che un proprietario o un collaboratore commenta /gcbrun sulla richiesta di unione.

        • Obbligatorio: quando una richiesta di unione viene creata o aggiornata da un collaboratore, le build vengono eseguite solo dopo che un proprietario o un collaboratore commenta /gcbrun alla richiesta di unione. Le build vengono eseguite ogni volta che viene apportata una modifica a una richiesta di unione.

        • Non obbligatorio: quando una richiesta di unione viene creata o aggiornata da un collaboratore, le build vengono eseguite automaticamente dai trigger.

    • Configurazione: seleziona il file di configurazione di compilazione che si trova nel repository o configura la build in linea sul trigger.

    • 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, specifica la posizione del file di configurazione della build o della directory Dockerfile e un nome per l'immagine risultante. Se la configurazione è Dockerfile, puoi facoltativamente fornire un timeout per la build. Dopo aver fornito Dockerfile e il nome dell'immagine, vedrai un'anteprima del comando docker build che verrà eseguito dalla tua 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 il tuo trigger GitLab.

gcloud

Per creare trigger GitLab utilizzando i comandi gcloud, esegui questo comando:

gcloud builds triggers create gitlab \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch-pattern=BRANCH_PATTERN # or --tag-pattern=TAG_PATTERN \
  --build-config=BUILD_CONFIG_FILE \
  --region=REGION

Dove:

  • TRIGGER_NAME è il nome del tuo trigger.
  • PROJECT_ID è l'ID del tuo progetto Google Cloud.
  • REGION è la regione del tuo trigger.
  • CONNECTION_NAME è il nome della tua connessione GitLab.
  • REPO_NAME è il nome del tuo repository
  • BRANCH_PATTERN è il nome del ramo nel tuo repository su cui richiamare la build.
  • TAG_PATTERN è il nome del tag nel tuo repository su cui richiamare la build.
  • BUILD_CONFIG_FILE è il percorso del file di configurazione della build.

Condivisione dei dati

I dati inviati a GitLab da Cloud Build ti aiutano a identificare i trigger per nome e a visualizzare i risultati della build nei tuoi repository GitLab.

Attualmente i seguenti dati sono condivisi tra Cloud Build e il tuo host GitLab:

  • ID progetto Google Cloud
  • Nome trigger

Passaggi successivi