Crea ed esegui il push di un'immagine Docker con Cloud Build
Scopri come iniziare a utilizzare Cloud Build creando un'immagine Docker ed eseguendo il push dell'immagine ad Artifact Registry. Artifact Registry fornisce una singola posizione per la gestione di pacchetti privati e immagini container Docker.
Prima creerai l'immagine utilizzando un Dockerfile
, che è il file di configurazione di Docker, quindi creerai la stessa immagine utilizzando il file di configurazione di Cloud Build.
Per seguire le istruzioni dettagliate direttamente per questa attività nell'editor di Cloud Shell, fai clic su Procedura guidata:
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.
-
Abilita le API Cloud Build and Artifact Registry.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
-
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.
-
Abilita le API Cloud Build and Artifact Registry.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
Prepara i file di origine da creare
Hai bisogno di un codice sorgente di esempio per pacchettizzare in un'immagine container. In questa sezione, creerai uno script shell semplice e un comando Dockerfile
. Dockerfile
è un documento di testo contenente le istruzioni per creare un'immagine in Docker.
Apri una finestra del terminale.
Crea una nuova directory denominata
quickstart-docker
e accedi alla directory:mkdir quickstart-docker cd quickstart-docker
Crea un file denominato
quickstart.sh
con il seguente contenuto:Crea un file denominato
Dockerfile
con il seguente contenuto:Nella finestra del terminale, esegui questo comando per rendere eseguibile
quickstart.sh
:chmod +x quickstart.sh
Crea un repository Docker in Artifact Registry
Crea un nuovo repository Docker denominato
quickstart-docker-repo
nella localitàus-west2
con la descrizione "Docker repository" (Repository Docker):gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \ --location=us-west2 --description="Docker repository"
Verifica che il repository sia stato creato:
gcloud artifacts repositories list
Vedrai
quickstart-docker-repo
nell'elenco dei repository visualizzati.
Crea un'immagine utilizzando Dockerfile
Cloud Build ti consente di creare un'immagine Docker utilizzando un elemento
Dockerfile
. Non è necessario un file di configurazione Cloud Build separato.
Per creare usando un Dockerfile
:
Recupera l'ID progetto Cloud eseguendo questo comando:
gcloud config get-value project
Esegui questo comando dalla directory contenente
quickstart.sh
eDockerfile
:gcloud builds submit --region=us-west2 --tag us-west2-docker.pkg.dev/project-id/quickstart-docker-repo/quickstart-image:tag1
Una volta completata la build, visualizzerai un output simile al seguente:
DONE
------------------------------------------------------------------------------------------------------------------------------------
ID CREATE_TIME DURATION SOURCE IMAGES STATUS
545cb89c-f7a4-4652-8f63-579ac974be2e 2020-11-05T18:16:04+00:00 16S gs://gcb-docs-project_cloudbuild/source/1604600163.528729-b70741b0f2d0449d8635aa22893258fe.tgz us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1 SUCCESS
Hai appena creato un'immagine Docker denominata quickstart-image
utilizzando Dockerfile
e ne hai eseguito il push ad Artifact Registry.
Crea un'immagine utilizzando un file di configurazione della build
In questa sezione utilizzerai un file di configurazione di Cloud Build per creare la stessa immagine Docker di cui sopra. Il file di configurazione della build indica a Cloud Build di eseguire attività in base alle tue specifiche.
Nella stessa directory contenente
quickstart.sh
eDockerfile
, crea un file denominatocloudbuild.yaml
con il seguente contenuto. Questo è il file di configurazione della build. Al momento della creazione, Cloud Build sostituisce automaticamente$PROJECT_ID
con il tuo ID progetto.Avvia la build eseguendo questo comando:
gcloud builds submit --region=us-west2 --config cloudbuild.yaml
Una volta completata la build, visualizzerai un output simile al seguente:
DONE
------------------------------------------------------------------------------------------------------------------------------------
ID CREATE_TIME DURATION SOURCE IMAGES STATUS
046ddd31-3670-4771-9336-8919e7098b11 2020-11-05T18:24:02+00:00 15S gs://gcb-docs-project_cloudbuild/source/1604600641.576884-8153be22c94d438aa86c78abf11403eb.tgz us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1 SUCCESS
Hai appena creato quickstart-image
utilizzando il file di configurazione della build e hai eseguito il push dell'immagine ad Artifact Registry.
Visualizza i dettagli della build
Apri la pagina Cloud Build nella console Google Cloud.
Seleziona il progetto e fai clic su Apri.
Viene visualizzata la pagina Cronologia build:
Nel menu a discesa Regione, seleziona
us-west2
per visualizzare le build in quella regione.Fai clic su una build.
Viene visualizzata la pagina Dettagli build.
Per visualizzare gli artefatti della build, in Riepilogo build, fai clic su Artefatti build.
Verrà visualizzato un output simile al seguente:
Da questa pagina puoi scaricare il log di build e visualizzare i dettagli dell'immagine in Artifact Registry.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi:
Apri la pagina Artifact Registry nella console Google Cloud.
Seleziona il progetto e fai clic su Apri.
Seleziona quickstart-docker-repo.
Fai clic su Elimina.
Hai eliminato il repository che hai creato nell'ambito di questa guida rapida.
Passaggi successivi
- Scopri come eseguire un'immagine Docker.
- Scopri come creare un file di configurazione della build di base.
- Scopri come eseguire il deployment utilizzando Cloud Build.
- Scopri come creare applicazioni Node.js.
- Scopri come creare applicazioni Java.
- Scopri come creare applicazioni Go.