Crea repository da GitLab

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

Questa pagina spiega come attivare la funzionalità di trigger in un'istanza GitLab. Scopri di più sui trigger di Cloud Build e sui repository Cloud Build.

Prima di iniziare

  • Enable the Cloud Build and Secret Manager APIs.

    Enable the APIs

Creazione di un trigger GitLab in corso...

Console

Per creare un trigger GitLab utilizzando la console Google Cloud:

  1. Apri la pagina Trigger:

    Apri la pagina Trigger

  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 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 valore predefinito pool per eseguire la build nella stessa regione come trigger.

    • (Facoltativo) Descrizione: una descrizione per l'attivatore.

    • Evento: seleziona l'evento del repository per richiamare l'attivatore.

      • Push a un ramo: imposta l'attivatore per avviare una build quando vengono eseguiti commit a un determinato ramo.

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

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

    • Fonte: seleziona 2a generazione come fonte.

      • Repository: dall'elenco dei repository disponibili, seleziona quello che ti interessa. Per collegare un nuovo repository, consulta Connettersi a un repository GitLab.

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

      • Controllo dei commenti: se hai selezionato Pull request come Evento, scegli una delle seguenti opzioni per controllare se una build verrà eseguita automaticamente dall'attivatore:

        • Obbligatorio, tranne che per proprietari e collaboratori: quando viene eseguita un'unione una richiesta viene creata o aggiornata da un proprietario o un collaboratore del repository, le build verranno eseguite automaticamente dal trigger. Se un server inizia l'azione, le build verranno eseguite solo dopo 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 verranno eseguite solo dopo che un proprietario dei commenti del collaboratore /gcbrun sulla richiesta di unione. Le compilazioni 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 qualsiasi collaboratore, le build vengono eseguite automaticamente dagli attivatori.

    • Configurazione: seleziona il file di configurazione della build che si trova in al tuo repository o configurare la build in linea il 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 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 Git, fornisci la posizione file di configurazione della build o Dockerfile e un nome per l'immagine risultante. Se la configurazione è Dockerfile, puoi facoltativamente specificare 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 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 di configurazione della build nell' Console Google Cloud con la sintassi YAML o JSON. Fai clic su Fine per e salvare la configurazione della build.

  5. Fai clic su Crea per creare il tuo trigger GitLab.

gcloud

Per creare gli attivatori GitLab utilizzando i comandi gcloud, esegui il seguente 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 della filiale su cui richiamare la build.
  • TAG_PATTERN è il nome del tag nel repo per invocare la compilazione.
  • 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 gli trigger per nome e a visualizzare i risultati di compilazione nei tuoi repository GitLab.

I seguenti dati sono attualmente condivisi tra Cloud Build e il tuo host GitLab:

  • ID progetto Google Cloud
  • Nome trigger

Passaggi successivi