Questa pagina spiega come attivare la funzionalità di attivazione su un'istanza Bitbucket Cloud. Scopri di più su trigger di Cloud Build e su repository Cloud Build.
Prima di iniziare
-
Enable the Cloud Build and Secret Manager APIs.
- Segui le istruzioni per collegare un host Bitbucket Cloud.
- Segui le istruzioni riportate in Connettersi a un repository Bitbucket Cloud.
Creare un trigger di Bitbucket Cloud
Crea un trigger Bitbucket Cloud seguendo questa procedura:
Console
Apri la pagina Trigger:
Seleziona il tuo progetto Google Cloud e fai clic su Apri.
Fai clic su Crea trigger.
Inserisci le seguenti impostazioni di attivazione:
Nome: un nome per l'attivatore.
Regione: seleziona la regione per l'attivatore.
- Se 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 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 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.
Invia nuovo tag: imposta l'attivatore in modo da avviare una build sui commit che contengono un determinato tag.
Richiesta di pull: imposta l'attivatore per avviare una compilazione su commit di una richiesta di pull.
Origine: seleziona 2ª gen. come origine.
Repository: dall'elenco dei repository disponibili, seleziona il repository. Per collegare un nuovo repository, consulta Connettersi a un repository Bitbucket Cloud.
Ramo o Tag: specifica un'espressione regolare con il valore del ramo o del tag da soddisfare. Per informazioni sulla sintassi accettabile delle espressioni regolari, consulta la pagina sulla sintassi RE2.
Controllo dei commenti: se hai selezionato Pull request come Evento, scegli una delle seguenti opzioni per controllare se una build viene eseguita automaticamente dall'attivatore:
Obbligatorio tranne che per proprietari e collaboratori: quando una richiesta di pull viene creata o aggiornata da un proprietario o collaboratore del repository, le build vengono eseguite automaticamente dall'attivatore. Se un collaboratore esterno avvia l'azione, le build vengono eseguite solo dopo che un proprietario o un collaboratore ha commentato
/gcbrun
la richiesta di pull.Obbligatorio: quando una richiesta di pull viene creata o aggiornata da qualsiasi collaboratore, le build vengono eseguite solo dopo che un proprietario o un collaboratore ha commentato
/gcbrun
la richiesta di pull. Le build vengono eseguite ogni volta che viene apportata una modifica a una richiesta di pull.Non obbligatorio: quando una richiesta di pull viene creata o aggiornata da qualsiasi collaboratore, le build vengono eseguite automaticamente dagli attivatori.
Configurazione: seleziona il file di configurazione della build nel tuo repository o configura la build in linea nell'attivatore.
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, fornisci 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 specificare un timeout per la build. Dopo aver fornitoDockerfile
e il nome dell'immagine, vedrai un'anteprima del comandodocker build
per la tua 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 della build.
Fai clic su Crea per creare l'attivatore Bitbucket Cloud.
gcloud
Crea un trigger per eventi push del repository utilizzando il seguente comando:
gcloud builds triggers create bitbucket-cloud \
--name=TRIGGER_NAME \
--repository=\
projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
--branch-pattern=".*" --build-config="CONFIG_NAME" \
--region=REGION
Dove:
- TRIGGER-NAME è il nome che vuoi assegnare all'attivatore di compilazione.
- PROJECT_ID è l'ID progetto Google Cloud .
- REGION è la regione per l'attivatore.
- CONNECTION_NAME è il nome della connessione all'host.
- REPO_NAME è il nome del repository collegato in Bitbucket Cloud.
- CONFIG_NAME è il nome del file dello schema di configurazione.
Dopo aver creato l'attivatore, Cloud Build ascolta tutti gli eventi push su tutti i rami. Quando esegui il push di un commit nel repository, viene invocato l'attivatore. Puoi visualizzare i risultati della build nella pagina Cronologia build.
Condivisione dei dati
I dati inviati a Bitbucket Cloud da Cloud Build ti aiutano a identificare gli attivatori per nome e a visualizzare i risultati di compilazione nei tuoi repository Bitbucket Cloud.
I seguenti dati vengono condivisi tra Cloud Build e l'host Bitbucket Cloud:
- ID progettoGoogle Cloud
- Nome trigger
Passaggi successivi
- Scopri come creare e gestire gli attivatori.
- Scopri come avviare manualmente le build.
- Scopri come visualizzare i risultati della build.
- Scopri come eseguire deployment blu/verdi su Compute Engine.