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 distribuire un modello immagine dell'applicazione denominata hello a una sequenza di due Cloud Run o due job Cloud Run.

In questa guida rapida, imparerai a:

1. Crea una configurazione Skaffold

2. Creare file di configurazione per due servizi Cloud Run oppure due job.

   Questi file definiscono i servizi o i job e specificano i valori (predefiniti) immagini container di cui eseguire il deployment.

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

4. Crea un'istanza per la tua pipeline di distribuzione creando una release, che automaticamente nel primo target.

5. Promuovi la release al secondo target.

6. Visualizza entrambe le implementazioni nella console Google Cloud.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

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

gcloud components update

12. Assicurati che l'account di servizio Compute Engine predefinito abbia autorizzazioni sufficienti.

    L'account di servizio potrebbe già disporre delle autorizzazioni necessarie. Questi passaggi sono inclusi per i progetti che disattivano la concessione automatica di ruoli account di servizio.

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 l'account di servizio di esecuzione predefinito actAs 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 di 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 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, creerai un file skaffold.yaml, che identifica le Definizione del servizio o del job Cloud Run da utilizzare per il deployment di esempio.

1. Apri una finestra del terminale.

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

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

3. 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 Servizi o job Cloud Run. Per ulteriori informazioni su questo file, consulta il riferimento skaffold.yaml.

Preparare 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 più progetti. Inoltre, usiamo con i profili Skaffold. è possibile avere due servizi o job nello stesso progetto. Quando utilizzi in progetti diversi, potresti non aver bisogno di usare 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 nome deploy-run-service-dev implica che questo è il tuo servizio dev, corrisponde al primo target nell'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, si tratta del tuo servizio prod e corrisponde al secondo target nella progressione 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 nome deploy-run-job-dev implica che questo è il tuo job dev e corrisponde a il 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 nome deploy-run-job-prod implica che 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. Nel di 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
   

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

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 destinazioni, pronta per il deployment dell'applicazione il primo obiettivo.

3. Conferma la pipeline e i target:

   Nella console Google Cloud, vai a Cloud Deploy Pagina Pipeline di distribuzione per visualizzare l'elenco della distribuzione disponibile pipeline di dati.

   Apri la pagina Pipeline di distribuzione

   Viene visualizzata la pipeline di importazione appena creata e i due target sono elencati nella colonna Target.

   

Crea una release

Una release è la risorsa centrale di Cloud Deploy che rappresenta delle modifiche implementate. La pipeline di distribuzione definisce il relativo ciclo di vita . Consulta: Architettura del servizio Cloud Deploy per maggiori dettagli sul ciclo di vita.

Esegui questo comando dalla directory deploy-run-quickstart per creare un'istanza Risorsa release che rappresenta 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=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. L'applicazione è il deployment automatico nel primo target nella progressione.

Promuovi la release

Nota: dopo aver creato la release, potresti dover attendere qualche minuto prima di procedere 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 avanzamento della pipeline di distribuzione. In questo caso, dimostra che la release è stata di cui è stato eseguito il deployment nel target run-qsdev.

   

2. Nel primo target nella visualizzazione della pipeline di distribuzione, fai clic su Promuovi.

   Viene mostrata la finestra di dialogo Promuovi release. Mostra i dettagli del target a cui promuovi l'account.

3. Fai clic su Promuovi.

   La release è ora in coda per il deployment in run-qsprod. Durante il deployment viene completato, la visualizzazione della pipeline di distribuzione mostra l'esecuzione del deployment:

   

Visualizza i risultati nella console Google Cloud

1. Nella console Google Cloud, vai a Cloud Deploy Pagina Pipeline di distribuzione 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 sarà elencata nella scheda Uscite della sezione Pipeline di pubblicazione dettagli.

3. Fai clic sul nome della release, test-release-001.

   Le implementazioni vengono visualizzate in Implementazioni. Puoi fare clic su un'implementazione per visualizzarne tra cui il log di deployment.

   

Accesso al servizio Cloud Run

Per impostazione predefinita, devi eseguire l'autenticazione per poter accedere alle nuove immagini create dai servizi Cloud Run. Guarda la documentazione di Cloud Run Panoramica dell'autenticazione per scoprire come fornire le credenziali e scoprire cos'è la 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 per le 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 la pipeline di distribuzione, i target, la release e le implementazioni:

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

4. 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 Cloud Storage

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 procedure per il deployment in Cloud Run

• Scopri come gestire i manifest.

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