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.

    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
  7. Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

    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
  12. Se hai già installato l'interfaccia a riga di comando, assicurati di eseguire la versione più recente:

    gcloud components update
    

  13. 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)")-compute@developer.gserviceaccount.com \
          --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)")-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
      

    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)")-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 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
    
  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.

    Pipeline di distribuzione mostrata nella console Google Cloud

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

  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.

    visualizzazione della pipeline di distribuzione nella console Google Cloud

  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:

    visualizzazione della pipeline di distribuzione nella console Google Cloud, che mostra la release di cui è stato eseguito il deployment in produzione.

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.

    visualizzazione della pipeline di distribuzione nella console Google Cloud

    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.

    lanci nella console Google Cloud

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