Cloud Run accetta le immagini container create con qualsiasi strumento in grado di compilarle, a condizione che rispettino il contratto del container.
In particolare, il codice deve rimanere in ascolto delle richieste HTTP sulla porta definita dalla variabile di ambiente PORT
. Questa variabile di ambiente PORT
viene inserita automaticamente da Cloud Run nel container.
Questa pagina descrive diversi modi per creare immagini contenitore:
- Utilizzo di un Dockerfile
- Utilizzo dei buildpack di Google Cloud
Prima di iniziare
Per eseguire alcuni dei comandi in questa pagina, devi disporre di Google Cloud CLI.
Crea un repository in un registry dei container supportato. Per creare un repository Artifact Registry, esegui:
gcloud artifacts repositories create REPOSITORY \ --repository-format=docker \ --location=LOCATION \ --description="DESCRIPTION" \ --immutable-tags \ --async
Puoi configurare Docker per ottenere l'accesso ad Artifact Registry utilizzando l'assistente alle credenziali gcloud CLI
gcloud auth configure-docker LOCATION-docker.pkg.dev
Creazione utilizzando un Dockerfile
Prima di compilare le origini in un'immagine container ("containerizzazione") localmente con Docker o Cloud Build, è necessario che sia presente un Dockerfile insieme alle origini. Gli esempi Hello World contengono applicazioni di esempio e Dockerfile in molte lingue popolari.
Se utilizzi i file Dockerfile, puoi utilizzare uno dei seguenti metodi per la compilazione:
- Esegui la compilazione utilizzando Cloud Build
- Esegui il build in locale utilizzando Docker
Creazione di pacchetti con Cloud Build
Puoi creare l'immagine su Google Cloud utilizzando Cloud Build:
Vai alla cartella contenente le origini e il Dockerfile.
Esegui il comando:
gcloud builds submit --tag IMAGE_URL
Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.
Per suggerimenti su come migliorare il rendimento delle build, consulta Accelerare le build
Creazione di build in locale ed esecuzione di push utilizzando Docker
Se hai installato Docker localmente, puoi utilizzare docker build
anziché Cloud Build o i buildpack di Google Cloud.
Per creare l'immagine container utilizzando Docker:
Vai alla cartella contenente le origini e
Dockerfile
.Esegui il comando:
docker build . --tag IMAGE_URL
Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.Tieni presente che se utilizzi un Mac con Apple Silicon, devi specificare
--platform linux/amd64
nella riga di comando.Esegui il push dell'immagine container in un registry dei container supportato:
docker push IMAGE_URL
Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.
Per escludere i file locali da questa procedura, segui le istruzioni per il
file di configurazione .dockerignore
.
Creazione utilizzando i buildpack di Google Cloud
I buildpack di Google Cloud sono un insieme di buildpack compatibili con CNCF che compilano il codice sorgente in immagini container progettate per essere eseguite sulle piattaforme di container di Google Cloud, incluso Cloud Run.
Per un elenco delle lingue supportate, consulta la documentazione dei buildpack di Google Cloud.
Creazione con i buildpack di Google Cloud utilizzando Cloud Build
Per eseguire il build con i buildpack di Google Cloud:
Vai alla cartella contenente le origini.
Esegui il comando:
gcloud builds submit --pack image=IMAGE_URL
Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.Attendi il completamento della build.
Creazione con i buildpack di Google Cloud utilizzando la riga di comando pack
Per eseguire il build utilizzando il comando pack:
Se non lo hai ancora fatto, installa Docker.
Se non lo hai ancora fatto, installa
pack
.Vai alla cartella contenente le origini.
Esegui il seguente comando per eseguire la compilazione ed eseguire il push nel tuo registry dei container supportato:
pack build --publish IMAGE_URL
Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.Attendi il completamento di
pack
.
Per ulteriori informazioni, leggi le istruzioni riportate in Creazione di un'applicazione.
Passaggi successivi
- Dopo aver creato il container, puoi eseguire il test localmente prima di eseguire il deployment in Cloud Run. Per saperne di più, consulta Testare un servizio Cloud Run localmente.
- Per scoprire di più sul contratto che i container devono rispettare per essere dipiazzati in Cloud Run, consulta Contratto del contenitore.
- Per eseguire il deployment dei container creati in Cloud Run, segui la sezione Eseguire il deployment dei servizi.
- Per automatizzare le build e i deployment dei tuoi servizi Cloud Run usando i trigger di Cloud Build, configura il deployment continuo.
- Per eseguire build di container ottimali per l'applicazione Java, consulta Creazione di container Java con Jib.