Guida rapida: esegui il deployment di un'app su Cloud Run utilizzando Google Cloud Deploy

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

Questa pagina mostra come utilizzare Google Cloud Deploy per fornire un'immagine di applicazione di esempio denominata hello in una sequenza di due servizi Cloud Run.

In questa guida rapida, procedi nel seguente modo:

  1. Crea una configurazione Skaffold.

  2. Creare file di definizione dei servizi per due servizi Cloud Run.

    Questi file definiscono i servizi e specificano l'immagine container (preconfigurata) di cui eseguire il deployment.

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

  4. Creare un'istanza della pipeline di distribuzione creando una release, che esegue automaticamente il deployment nel primo target.

  5. Promuovi la release nel 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. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

  4. Abilita le API Google 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. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

  9. Abilita le API Google 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 predefinito di Compute Engine disponga di autorizzazioni sufficienti.

    L'account di servizio potrebbe già disporre delle autorizzazioni necessarie. Questi passaggi sono inclusi per i progetti che disattivano la concessione automatica 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 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 per sviluppatori 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 problemi ad aggiungere uno di questi ruoli, contatta l'amministratore del progetto.

Prepara la configurazione Skaffold

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

In questa guida rapida, creerai un file skaffold.yaml, che identifica il manifest di Kubernetes da utilizzare per 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:

    apiVersion: skaffold/v3alpha1
    kind: Config
    metadata:
      name: deploy-run-quickstart
    profiles:
    - name: dev
      manifests:
        rawYaml:
        - run-dev.yaml
    - name: prod
      manifests:
        rawYaml:
        - run-prod.yaml
    deploy:
      cloudrun: {}
    

    Questo file è una configurazione Skaffold minima, che identifica i servizi Cloud Run. Per ulteriori informazioni su questo file, consulta il riferimento skaffold.yaml.

Preparare i servizi Cloud Run

Per questa guida rapida, creerai due diversi servizi Cloud Run nello stesso progetto. Google Cloud Deploy supporta anche il deployment in più progetti. Inoltre, utilizziamo i profili Skaffold per consentire di avere due servizi nello stesso progetto. Quando utilizzi progetti diversi, potresti non aver bisogno di utilizzare i profili Skaffold.

  1. Crea un file denominato run-dev.yaml con il seguente contenuto:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: deploy-qs-dev
    spec:
      template:
        spec:
          containers:
          - image: my-app-image
    

    Questo file definisce un servizio Cloud Run. Come suggerisce il nome deploy-qs-dev, questo è il tuo servizio dev e corrisponderà al primo target nella progressione della pipeline di distribuzione.

  2. Crea un file denominato run-prod.yaml con il seguente contenuto:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: deploy-qs-prod
    spec:
      template:
        spec:
          containers:
          - image: my-app-image
    

    Questo file definisce il servizio prod.

Crea la tua pipeline di distribuzione e i tuoi target

Puoi definire la pipeline e le destinazioni 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 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 pipeline e le destinazioni con il servizio Google 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 della tua applicazione nel primo target.

  3. Conferma la pipeline e i target:

    Nella console Google Cloud, vai alla pagina Pipeline di distribuzione di Google Cloud Deploy per visualizzare l'elenco delle tue 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.

    Pipeline di distribuzione mostrata nella console Google Cloud

Crea una release

Una release è la risorsa centrale di Google Cloud Deploy che rappresenta le modifiche in fase di deployment. La pipeline di distribuzione definisce il ciclo di vita della release. Per i dettagli sul ciclo di vita, consulta Architettura del servizio Google Cloud Deploy.

Esegui questo comando dalla directory deploy-run-quickstart per creare una risorsa release che rappresenti l'immagine container di cui eseguire il deployment:

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

Poiché questa release è la prima (è in corso il deployment nel primo target della progressione), Google Cloud Deploy crea automaticamente anche una risorsa rollout. Il deployment dell'applicazione viene eseguito automaticamente nel primo target nella progressione.

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

    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.

    Ora la release è in coda per il deployment in qsprod. Al termine del deployment, la visualizzazione della pipeline di distribuzione lo mostra come eseguito:

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

Visualizzare i risultati nella console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Pipeline di distribuzione di Google 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 nella pipeline.

    Visualizzazione della pipeline di distribuzione nella console Google Cloud

    Inoltre, la tua release è elencata nella scheda Release nella sezione Dettagli 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 deployment.

    implementazioni 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 sull'autenticazione di Cloud Run per informazioni su come fornire le credenziali e scoprire quale configurazione di Identity and Access Management è necessaria per poter accedere al servizio senza autenticazione.

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 Cloud Run deploy-qs-dev:

    gcloud run services delete deploy-qs-dev --region=us-central1 --project=PROJECT_ID
    
  2. Elimina il servizio deploy-qs-prod:

    gcloud run services delete deploy-qs-prod --region=us-central1 --project=PROJECT_ID
    
  3. Elimina la pipeline di distribuzione, le destinazioni, il rilascio e le implementazioni:

    gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
    
  4. Eliminare i bucket Cloud Storage creati da Google 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!

Passaggi successivi