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

Questa pagina mostra come utilizzare Cloud Deploy per fornire un'immagine dell'applicazione di esempio denominata hello in 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.
Definire la pipeline di distribuzione e i target di deployment di Cloud Deploy, che puntano ai due servizi o ai due job.
Crea un'istanza della 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 pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

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

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

Abilita le API

Installa Google Cloud CLI.

Per initialize gcloud CLI, esegui questo comando:

gcloud init

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

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

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

Abilita le API

Installa Google Cloud CLI.

Per initialize gcloud CLI, esegui questo comando:

gcloud init

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

gcloud components update

Assicurati che l'account di servizio Compute Engine predefinito abbia le autorizzazioni sufficienti.
L'account di servizio potrebbe avere già le 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 di sviluppo 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.

Prepara la configurazione Skaffold

Cloud Deploy utilizza Skaffold per fornire i dettagli su cosa eseguire il deployment e come eseguirne il deployment correttamente per i target separati.

Per questa guida rapida, creerai un file skaffold.yaml che identifica il servizio Cloud Run o la definizione del job 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/v4beta7
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/v4beta7
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 la documentazione di riferimento skaffold.yaml per ulteriori informazioni su questo file.

Prepara i servizi o i job Cloud Run

Per questa guida rapida, creerai due diversi servizi Cloud Run o due job Cloud Run nello stesso progetto. Cloud Deploy supporta anche il deployment in più progetti. Inoltre, utilizziamo i profili Skaffold per rendere possibile avere due servizi o job nello stesso progetto. Quando usi progetti diversi, potrebbe non essere necessario usare 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 servizio dev e corrisponde al primo target nel progresso 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 suggerito dal nome deploy-run-service-prod, questo è il servizio prod 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 job dev e corrisponde al primo target nel tuo 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 job prod e corrisponde al secondo target nell'avanzamento della pipeline di distribuzione.

Crea la pipeline di distribuzione e i target

Puoi definire la pipeline e i target in un file o in file separati. In questa guida rapida, creerai 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 pipeline e i 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 il deployment dell'applicazione nel tuo primo target.
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 Destinazioni.

Crea una release

Una release è la risorsa centrale di Cloud Deploy che rappresenta le modifiche di cui viene eseguito il deployment. La pipeline di distribuzione definisce il ciclo di vita di quella release. Per i dettagli sul ciclo di vita, consulta Architettura del servizio Cloud Deploy.

Esegui questo comando dalla directory deploy-run-quickstart per creare una risorsa release che rappresenti l'immagine del 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=us-docker.pkg.dev/cloudrun/container/hello@sha256:6063adf8f687702b4065151acddba6781c47bc602167eb9f3bec8aebc9ce95cc

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 di implementazione. Viene eseguito automaticamente il deployment dell'applicazione nella prima destinazione della progressione.

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 dei dettagli della 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.
Per il 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 a cui stai effettuando la promozione.
Fai clic su Promuovi.

La release è ora in coda per il deployment in run-qsprod. Al termine del deployment, la visualizzazione della pipeline di distribuzione ne mostra il 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.

Apri la pagina Pipeline di distribuzione
Fai clic sul nome della pipeline di distribuzione "my-run-demo-app-1".

La visualizzazione della pipeline mostra l'avanzamento dell'app nella pipeline.

La 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 scoprire quale configurazione di Identity and Access Management è necessaria 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 la pipeline di distribuzione, i target, il rilascio e le implementazioni:

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

Eliminare i bucket Cloud Storage creati da Cloud Deploy.

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

Apri la pagina del browser di Cloud Storage

È tutto. Hai completato questa guida rapida.

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

Prima di iniziare

Prepara la configurazione Skaffold

Servizi

Job

Prepara i servizi o i job Cloud Run

Servizi

Job

Crea la pipeline di distribuzione e i target

Crea una release

Servizi

Job

Promuovi la release

Visualizza i risultati nella console Google Cloud

Accesso al servizio Cloud Run

Esegui la pulizia

Servizi

Job

Servizi

Job

Passaggi successivi