Esegui il deployment di un'app in Cloud Run utilizzando Cloud Deploy

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:

1. Creare una configurazione Skaffold

2. 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.

3. Definisci la pipeline di distribuzione di Cloud Deploy e i target di deployment, che puntano ai due servizi o ai due job.

4. Crea l'istanza della tua pipeline di distribuzione creando una release, che esegue automaticamente il deployment nella prima destinazione.

5. Promuovi la release al secondo target.

6. Visualizza entrambe le implementazioni nella console Google Cloud.

Prima di iniziare

1. 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.

2. Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto e rimuovere tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.

   Abilita le API

5. Installa Google Cloud CLI.

6. Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

   gcloud init

   Nota: puoi eseguire gcloud CLI nella console Google Cloud senza installare Google Cloud CLI. Per eseguire l'interfaccia alla gcloud CLI nella console Google Cloud, utilizza Cloud Shell.

7. Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto e rimuovere tutte le risorse associate.

   Vai al selettore progetti

8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

9. Abilita le API Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.

   Abilita le API

10. Installa Google Cloud CLI.

11. Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

    gcloud init

    Nota: puoi eseguire gcloud CLI nella console Google Cloud senza installare Google Cloud CLI. Per eseguire l'interfaccia alla gcloud CLI nella console Google Cloud, utilizza Cloud Shell.

Se hai già installato l'interfaccia a riga di comando, assicurati di eseguire la versione più recente:

gcloud components update

12. 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.

1. Aggiungi il ruolo clouddeploy.jobRunner:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/clouddeploy.jobRunner"
   

2. 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)")[e-mail] \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/iam.serviceAccountUser" \
       --project=PROJECT_ID
   

3. Aggiungi le autorizzazioni sviluppatore Cloud Run:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/run.developer"
   

   Se hai difficoltà ad aggiungere uno di questi ruoli, contatta l'amministratore del progetto.

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.

1. Apri una finestra del terminale.

2. Crea una nuova directory, denominata deploy-run-quickstart, e accedi alla directory.

   mkdir deploy-run-quickstart
   cd deploy-run-quickstart
   

3. 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

1. 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 servizio dev e corrisponde al primo target nel avanzamento della pipeline di distribuzione.

2. 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 servizio prod e corrisponde al secondo target nell'avanzamento della pipeline di distribuzione.

Job

1. 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 job dev e corrisponde al primo target nell'avanzamento della pipeline di distribuzione.

2. 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 job prod 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.

1. 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
   

   Nota: in questo file, i target sono inclusi nella pipeline di distribuzione, ma puoi definire i target in un file separato o in più file separati.

2. 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.

3. 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

Nota: dopo aver creato la release, potresti dover attendere alcuni minuti prima di continuare con questo passaggio.

1. 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.

   

2. 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.

3. 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

1. Nella console Google Cloud, vai alla pagina pipeline di distribuzione di Cloud Deploy per visualizzare la pipeline di distribuzione my-run-demo-app-1.

   Apri la pagina Pipeline di distribuzione

2. 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.

3. 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.

1. 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
   

2. 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
   

3. Elimina pipeline di distribuzione, destinazioni, release e implementazioni:

   gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
   

4. Elimina i bucket Cloud Storage creati da Cloud Deploy.

   Una termina con _clouddeploy e l'altra è [region].deploy-artifacts.[project].appspot.com.

   Apri la pagina del browser di Cloud Storage

È tutto. Hai completato questa guida rapida.

Passaggi successivi

• Scopri di più su Cloud Deploy.

• Apprendi le nozioni di base sul deployment delle applicazioni.

• Leggi l'articolo sulle istruzioni per il deployment in Cloud Run.

• Scopri come gestire i file manifest.

• Scopri come combinare gli strumenti CI/CD di Google Cloud per sviluppare e distribuire il software in modo efficace su GKE.