Esegui il deployment di un'app in Cloud Run utilizzando Cloud Deploy
Questa pagina mostra come utilizzare Cloud Deploy per inviare un'immagine dell'applicazione di esempio denominata hello
a una sequenza di due servizi Cloud Run o due job Cloud Run.
In questa guida rapida, imparerai a:
Creare una configurazione Skaffold
Creare file di configurazione per due servizi Cloud Run o due job.
Questi file definiscono i servizi o i job e specificano le immagini container (predefinite) di cui eseguire il deployment.
Definisci la pipeline di distribuzione di Cloud Deploy e i target di deployment, che puntano ai due servizi o ai due job.
Crea l'istanza della tua pipeline di distribuzione creando una release, che esegue automaticamente il deployment nella prima destinazione.
Promuovi la release al secondo target.
Visualizza entrambe le implementazioni nella console Google Cloud.
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 console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
-
Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
- Assicurati che l'account di servizio Compute Engine predefinito disponga di autorizzazioni sufficienti.
L'account di servizio potrebbe già disporre delle autorizzazioni necessarie. Questi passaggi sono inclusi per i progetti che disabilitano le concessioni automatiche dei ruoli per gli account di servizio predefiniti.
- Aggiungi il ruolo
clouddeploy.jobRunner
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/clouddeploy.jobRunner"
- Concedi all'account di servizio di esecuzione predefinito
actAs
l'autorizzazione per eseguire il deployment dei carichi di lavoro in Cloud Run:gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/iam.serviceAccountUser" \ --project=PROJECT_ID
- Aggiungi le autorizzazioni sviluppatore Cloud Run:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/run.developer"
Se hai difficoltà ad aggiungere uno di questi ruoli, contatta l'amministratore del progetto.
Se hai già installato l'interfaccia a riga di comando, assicurati di eseguire la versione più recente:
gcloud components update
Prepara la configurazione Skaffold
Cloud Deploy utilizza Skaffold per fornire i dettagli su cosa eseguire il deployment e su come eseguirne correttamente il deployment per i tuoi target separati.
Per questa guida rapida, creerai un file skaffold.yaml
che identifica il servizio o la definizione del job Cloud Run da utilizzare per eseguire il deployment dell'app di esempio.
Apri una finestra del terminale.
Crea una nuova directory, denominata
deploy-run-quickstart
, e accedi alla directory.mkdir deploy-run-quickstart cd deploy-run-quickstart
Crea un file denominato
skaffold.yaml
con il seguente contenuto:Servizi
apiVersion: skaffold/v3alpha1 kind: Config metadata: name: deploy-run-quickstart profiles: - name: dev manifests: rawYaml: - run-service-dev.yaml - name: prod manifests: rawYaml: - run-service-prod.yaml deploy: cloudrun: {}
Job
apiVersion: skaffold/v3alpha1 kind: Config metadata: name: deploy-run-quickstart profiles: - name: dev manifests: rawYaml: - run-job-dev.yaml - name: prod manifests: rawYaml: - run-job-prod.yaml deploy: cloudrun: {}
Questo file è una configurazione Skaffold minima, che identifica i servizi o i job Cloud Run. Consulta il riferimento
skaffold.yaml
per ulteriori informazioni su questo file.
Prepara i servizi o i job Cloud Run
Per questa guida rapida, creerai due servizi Cloud Run diversi o due job Cloud Run nello stesso progetto. Cloud Deploy supporta inoltre il deployment in più progetti. Inoltre, utilizziamo i profili Skaffold per consentire di avere due servizi o job nello stesso progetto. Quando utilizzi progetti diversi, potrebbe non essere necessario utilizzare i profili Skaffold.
Servizi
Crea un file denominato
run-service-dev.yaml
con il seguente contenuto:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: deploy-run-service-dev spec: template: spec: containers: - image: my-app-image
Questo file definisce un servizio Cloud Run. Come suggerisce il nome
deploy-run-service-dev
, questo è il tuo serviziodev
e corrisponde al primo target nel avanzamento della pipeline di distribuzione.Crea un file denominato
run-service-prod.yaml
con il seguente contenuto:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: deploy-run-service-prod spec: template: spec: containers: - image: my-app-image
Questo file definisce un altro servizio Cloud Run e, come suggerisce il nome
deploy-run-service-prod
, questo è il tuo servizioprod
e corrisponde al secondo target nell'avanzamento della pipeline di distribuzione.
Job
Crea un file denominato
run-job-dev.yaml
con il seguente contenuto:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: deploy-run-job-dev spec: template: spec: template: spec: containers: - image: my-app-image
Questo file definisce un job Cloud Run. Come suggerisce il nome
deploy-run-job-dev
, questo è il tuo jobdev
e corrisponde al primo target nell'avanzamento della pipeline di distribuzione.Crea un file denominato
run-job-prod.yaml
con il seguente contenuto:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: deploy-run-job-prod spec: template: spec: template: spec: containers: - image: my-app-image
Questo file definisce un altro job Cloud Run. Come suggerisce il nome
deploy-run-job-prod
, questo è il tuo jobprod
e corrisponde al secondo target nell'avanzamento della pipeline di distribuzione.
Crea i target e la pipeline di distribuzione
Puoi definire la pipeline e i target in un file o in file separati. In questa guida rapida, crei un singolo file.
Nella directory
deploy-run-quickstart
, crea un nuovo file:clouddeploy.yaml
con il seguente contenuto:apiVersion: deploy.cloud.google.com/v1 kind: DeliveryPipeline metadata: name: my-run-demo-app-1 description: main application pipeline serialPipeline: stages: - targetId: run-qsdev profiles: [dev] - targetId: run-qsprod profiles: [prod] --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: run-qsdev description: Cloud Run development service run: location: projects/PROJECT_ID/locations/us-central1 --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: run-qsprod description: Cloud Run production service run: location: projects/PROJECT_ID/locations/us-central1
Registra la tua pipeline e i tuoi target con il servizio Cloud Deploy:
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
Ora hai una pipeline con destinazioni pronta per eseguire il deployment dell'applicazione nella tua prima destinazione.
Conferma la pipeline e i target:
Nella console Google Cloud, vai alla pagina pipeline di distribuzione di Cloud Deploy per visualizzare l'elenco delle pipeline di distribuzione disponibili.
Apri la pagina Pipeline di distribuzione
Viene visualizzata la pipeline di distribuzione appena creata e le due destinazioni sono elencate nella colonna Target.
Crea una release
Una release è la risorsa Cloud Deploy centrale che rappresenta le modifiche di cui viene eseguito il deployment. La pipeline di distribuzione definisce il ciclo di vita di quella release. Consulta Architettura del servizio Cloud Deploy per i dettagli su quel ciclo di vita.
Esegui questo comando dalla directory deploy-run-quickstart
per creare una risorsa release
che rappresenti l'immagine container di cui eseguire il deployment:
Servizi
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-run-demo-app-1 \
--images=my-app-image=gcr.io/cloudrun/hello@sha256:98cdb98c2d97a67d5e9183beedfec98ca9d5967acd874409b4800bf4d1a51710
Job
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-run-demo-app-1 \
--images=my-app-image=us-docker.pkg.dev/cloudrun/container/job@sha256:d7c33651fbad911a9a0a0c16f2f9b3a79f0b9e3e89afb205603af706067feac5
Come per tutte le release (a meno che non includano --disable-initial-rollout
), Cloud Deploy crea automaticamente anche una risorsa implementazione. Viene eseguito automaticamente il deployment dell'applicazione nella prima destinazione della fase di avanzamento.
Promuovi la release
Nella pagina pipeline di distribuzione, fai clic sulla pipeline
my-run-demo-app-1
.Apri la pagina Pipeline di distribuzione
La pagina Dettagli pipeline di distribuzione mostra una rappresentazione grafica dell'avanzamento della pipeline di distribuzione. In questo caso, mostra che è stato eseguito il deployment della release nella destinazione
run-qsdev
.Sul primo target nella visualizzazione della pipeline di distribuzione, fai clic su Promuovi.
Viene visualizzata la finestra di dialogo Promuovi release. Mostra i dettagli del target che stai promuovendo.
Fai clic su Promuovi.
La release è ora in coda per il deployment in
run-qsprod
. Una volta completato il deployment, la visualizzazione della pipeline di distribuzione lo mostra come deployment:
Visualizza i risultati nella console Google Cloud
Nella console Google Cloud, vai alla pagina pipeline di distribuzione di Cloud Deploy per visualizzare la pipeline di distribuzione my-run-demo-app-1.
Fai clic sul nome della pipeline di distribuzione "my-run-demo-app-1".
La visualizzazione della pipeline mostra l'avanzamento dell'app attraverso la pipeline.
La tua release è elencata nella scheda Release in Dettagli della pipeline di pubblicazione.
Fai clic sul nome della release
test-release-001
.Le implementazioni vengono visualizzate in Implementazioni. Puoi fare clic su un'implementazione per visualizzarne i dettagli, incluso il log di deployment.
Accesso al servizio Cloud Run
Per impostazione predefinita, devi eseguire l'autenticazione per accedere ai servizi Cloud Run appena creati. Consulta la Panoramica dell'autenticazione di Cloud Run per scoprire come fornire le credenziali e quale configurazione di Identity and Access Management è richiesta per accedere al servizio senza autenticazione. Questo non si applica ai job Cloud Run.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
Elimina il servizio o il job Cloud Run
deploy-qs-dev
:Servizi
gcloud run services delete deploy-run-service-dev --region=us-central1 --project=PROJECT_ID
Job
gcloud run jobs delete deploy-run-job-dev --region=us-central1 --project=PROJECT_ID
Elimina il servizio
deploy-qs-prod
:Servizi
gcloud run services delete deploy-run-service-prod --region=us-central1 --project=PROJECT_ID
Job
gcloud run jobs delete deploy-run-job-prod --region=us-central1 --project=PROJECT_ID
Elimina pipeline di distribuzione, destinazioni, release e implementazioni:
gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
Elimina i bucket Cloud Storage creati da Cloud Deploy.
Una termina con
_clouddeploy
e l'altra è[region].deploy-artifacts.[project].appspot.com
.
È tutto. Hai completato questa guida rapida.