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

Prepara la configurazione di Skaffold

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

Per questa guida rapida, crea un file skaffold.yaml che identifica il servizio o la definizione di 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 i seguenti contenuti:

   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. Per ulteriori informazioni su questo file, consulta il riferimento skaffold.yaml.

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 su più progetti. Inoltre, utilizziamo profili Skaffold per consentire di avere due servizi o job nello stesso progetto. Quando utilizzi diversi progetti, potresti non dover utilizzare i profili Skaffold.

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.

1. Nella directory deploy-run-quickstart, crea un nuovo file: clouddeploy.yaml, con i seguenti contenuti:

   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
   

2. 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 target, pronta per eseguire il deployment della tua applicazione nel primo target.

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 pubblicazione

   Viene visualizzata la pipeline di importazione appena creata e i due target sono elencati 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 della release. Per informazioni dettagliate sul ciclo di vita, consulta la sezione Architettura del servizio Cloud Deploy.

Esegui il seguente comando dalla directory deploy-run-quickstart per creare una risorsa release che rappresenti l'immagine del contenitore da eseguire:

 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:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4

 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

Nota il flag --images=, che viene utilizzato per sostituire il segnaposto (my-app-image) nella definizione del servizio o del job con l'immagine specifica con qualifica SHA. Google consiglia di creare modelli per le definizioni di servizi e job in questo modo e di utilizzare nomi di immagini qualificati con SHA durante la creazione della release.

Come per tutte le release (a meno che non includano --disable-initial-rollout), Cloud Deploy crea automaticamente anche una risorsa di implementazione. L'applicazione viene implementata automaticamente nel primo target della progressione.

Promuovi la release

1. Nella pagina Pipeline di pubblicazione, fai clic sulla pipeline my-run-demo-app-1.

   Apri la pagina Pipeline di pubblicazione

   La pagina Dettagli pipeline di distribuzione mostra una rappresentazione grafica dell'avanzamento della pipeline di distribuzione. In questo caso, indica che la release è stata eseguita nel target 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 pubblico di destinazione per il quale stai promuovendo.

3. Fai clic su Promuovi.

   La release è ora in coda per il deployment in run-qsprod. Al termine del deployment, la visualizzazione della pipeline di importazione lo mostra come di seguito:

   

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 pubblicazione

2. 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 tua uscita è elencata nella scheda Uscite in Dettagli della pipeline di distribuzione.

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

   

Accedere al servizio Cloud Run

Per impostazione predefinita, devi autenticarti 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 è necessaria per accedere al servizio senza autenticazione. Questo non vale per i job Cloud Run.