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:
Crea una configurazione Skaffold.
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.
Definisci la pipeline di distribuzione e i target di deployment di Google Cloud Deploy, che puntano ai due servizi.
Creare un'istanza della pipeline di distribuzione creando una release, che esegue automaticamente il deployment nel primo target.
Promuovi la release nel 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 console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.
-
Abilita le API Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
-
Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.
-
Abilita le API Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Installa Google Cloud CLI.
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:
gcloud init
- 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.
- 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 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 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.
Se hai già installato l'interfaccia a riga di comando, assicurati di eseguire la versione più recente:
gcloud components update
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.
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: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.
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 serviziodev
e corrisponderà al primo target nella progressione della pipeline di distribuzione.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.
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 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.
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.
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
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
.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.
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:
Visualizzare i risultati nella console Google Cloud
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.
Fai clic sul nome della pipeline di distribuzione "my-run-demo-app-1".
La visualizzazione della pipeline mostra l'avanzamento dell'app nella pipeline.
Inoltre, la tua release è elencata nella scheda Release nella sezione Dettagli pipeline di distribuzione.
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 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:
Elimina il servizio Cloud Run
deploy-qs-dev
:gcloud run services delete deploy-qs-dev --region=us-central1 --project=PROJECT_ID
Elimina il servizio
deploy-qs-prod
:gcloud run services delete deploy-qs-prod --region=us-central1 --project=PROJECT_ID
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
Eliminare i bucket Cloud Storage creati da Google Cloud Deploy.
Uno termina con
_clouddeploy
e l'altro è[region].deploy-artifacts.[project].appspot.com
.
È tutto, hai completato questa guida rapida!