Questa pagina spiega come utilizzare Cloud Build per creare, testare ed eseguire il deployment delle applicazioni Go.
Prima di iniziare
Le istruzioni riportate in questa pagina presuppongono che tu abbia familiarità con Go. Inoltre:
-
Abilita le API Cloud Build, Cloud Run, and Artifact Registry.
- Per eseguire i comandi
gcloud
in questa pagina, installa Google Cloud CLI. - Tieni a portata di mano il tuo progetto Go.
- Se vuoi containerizzare la tua app Go con Cloud Build, devi disporre di
Dockerfile
insieme al codice sorgente. - Se vuoi archiviare il container creato in Artifact Registry, crea un repository Docker in Artifact Registry.
- Se vuoi archiviare i log di test in Cloud Storage, crea un bucket in Cloud Storage.
Autorizzazioni IAM richieste
Per archiviare i log di test in Logging, concedi il ruolo di Creatore oggetti Storage (
roles/storage.objectCreator
) per il bucket Cloud Storage all'account di servizio Cloud Build.Per archiviare le immagini create in Artifact Registry, concedi il ruolo Writer (
roles/artifactregistry.writer
) Artifact Registry all'account di servizio Cloud Build.
Per istruzioni sulla concessione di questi ruoli, consulta Concessione di un ruolo utilizzando la pagina IAM.
Configurazione di build Go
L'immagine golang
pubblica di Docker Hub supporta la creazione utilizzando i moduli Go. L'utilizzo di questa immagine come passaggio di build nel file di configurazione di Cloud Build consente di richiamare i comandi go
all'interno dell'immagine. Gli argomenti passati a questo passaggio di build vengono passati
direttamente allo strumento golang
, in modo da poter eseguire qualsiasi comando go
in questa immagine.
Questa sezione illustra un file di configurazione di compilazione di esempio per un'app Go. Include i passaggi di creazione per creare l'app, aggiungere test delle unità e, al termine dei test, containerizzare ed eseguire il deployment dell'app.
Per creare la tua applicazione Go:
Nella directory root del progetto, crea un file di configurazione di Cloud Build denominato
cloudbuild.yaml
.Build and test: se hai definito i test delle unità nella tua applicazione, puoi configurare Cloud Build in modo che esegua i test aggiungendo i seguenti campi in un passaggio di build:
name
: imposta il valore di questo campo sugolang
per utilizzare l'immagine golang di Docker Hub per l'attività.entrypoint
: imposta il valore di questo campo su/bin/bash
. Ciò ti consente di eseguire comandi bash multilinea direttamente dal passaggio di build.args
: il campoargs
di un passaggio di build accetta un elenco di argomenti e li passa all'immagine a cui fa riferimento il camponame
. Nell'esempio seguente, il campoargs
accetta gli argomenti per:- Eseguire il formattatore di log di test per scaricare l'output del log di test.
- Stampa dell'output del log.
- Salvataggio dei risultati del test in
sponge.log
. - Output dei risultati in
sponge.log
in un file XML JUNIT. Il nome del file XML JUNIT viene creato utilizzando la versione breve dell'ID di commit associato alla build. Un passaggio di build successivo salverà i log di questo file in Cloud Storage.
Containerizza l'app: dopo aver aggiunto il passaggio di build per assicurarti che i test siano stati superati, puoi creare l'applicazione. Cloud Build fornisce un'immagine Docker predefinita che puoi utilizzare per containerizzare la tua applicazione Go. Per containerizzare la tua app, aggiungi i seguenti campi in un passaggio di build:
name
: imposta il valore di questo campo sugcr.io/cloud-builders/docker
per utilizzare l'immagine Docker predefinita per l'attività.args
: aggiungi gli argomenti per il comandodocker build
come valori per questo campo.
Il seguente passaggio di build crea l'immagine
myimage
e la tagga con la versione breve del tuo ID commit. Il passaggio di build utilizza sostituzioni per l'ID progetto, il nome del repository e i valori SHA brevi, pertanto questi valori vengono sostituiti automaticamente in fase di creazione. Tieni presente che dovrai creare o disporre di un repository Docker in Artifact Registry per archiviare l'immagine.Esegui il push del container in Artifact Registry: puoi archiviare il container creato in Artifact Registry, un servizio Google Cloud che puoi utilizzare per archiviare, gestire e proteggere gli artefatti della build. Per farlo, in Artifact Registry devi avere un repository Docker esistente. Per configurare Cloud Build per l'archiviazione dell'immagine in un repository Docker di Artifact Registry, aggiungi un passaggio di build con i seguenti campi:
name
: imposta il valore di questo campo sugcr.io/cloud-builders/docker
per utilizzare l'immagine dello strumento di creazionedocker
ufficiale per l'attività.args
: aggiungi gli argomenti per il comandodocker push
come valori di questo campo. Per l'URL di destinazione, inserisci il repository Docker di Artifact Registry in cui vuoi archiviare l'immagine.
Il seguente passaggio di build esegue il push dell'immagine che hai creato nel passaggio precedente ad Artifact Registry:
Esegui il deployment del container in Cloud Run: per eseguire il deployment dell'immagine su Cloud Run, aggiungi un passaggio di build con i seguenti campi:
name
: imposta il valore di questo campo sugoogle/cloud-sdk
per utilizzare l'immagine dell'interfaccia a riga di comando gcloud CLI per richiamare il comandogcloud
ed eseguire il deployment dell'immagine su Cloud Run.args
: aggiungi gli argomenti per il comandogcloud run deploy
come valori di questo campo.
Il seguente passaggio di build esegue il deployment dell'immagine creata in precedenza in Cloud Run:
Salva i log di test in Cloud Storage: puoi configurare Cloud Build in modo che archivi tutti i log di test in Cloud Storage specificando la località di un bucket esistente e il percorso dei log di test.
Il seguente passaggio di build archivia i log di test salvati nel file XML JUNIT in un bucket Cloud Storage:
Lo snippet seguente mostra il file di configurazione di compilazione completo per tutti i passaggi descritti sopra:
Avvia la build utilizzando gcloud CLI o i trigger di build. Quando avvii la build, devi specificare il nome del repository Artifact Registry.
Per specificare il repository Artifact Registry quando avvii la build utilizzando gcloud CLI:
gcloud builds submit --region=us-west2 --config=cloudbuild.yaml \ --substitutions=_REPO_NAME="REPO_NAME"
Sostituisci
REPO_NAME
con il nome del tuo repository Artifact Registry.Per specificare il repository Artifact Registry durante la creazione con trigger di build, specifica il nome del repository Artifact Registry nel campo Variabili di sostituzione durante la creazione del trigger di build.
Passaggi successivi
- Scopri come eseguire deployment blu/verde su Compute Engine.
- Scopri come creare immagini container.
- Scopri come risolvere gli errori di build.