Eseguire il deployment di un'app in più destinazioni contemporaneamente

Prepara la configurazione di Skaffold e il manifest dell'applicazione

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

In questa guida rapida, creerai un file skaffold.yaml che identifica il manifest dell'applicazione da utilizzare per eseguire il deployment dell'app di esempio.

1. Apri una finestra del terminale.

2. Crea una nuova directory e accedivi.

   GKE

   mkdir deploy-gke-parallel-quickstart
   cd deploy-gke-parallel-quickstart
   

   Cloud Run

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

3. Crea un file denominato skaffold.yaml con i seguenti contenuti:

   GKE

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - k8s-deployment.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - service.yaml
   deploy:
     cloudrun: {}
   

   Questo file è una configurazione Skaffold minima. Per questa guida rapida, crea il file. Puoi anche chiedere a Cloud Deploy di crearne uno per te per applicazioni semplici non di produzione.

   Per ulteriori informazioni su questo file, consulta le informazioni di riferimento su skaffold.yaml.

4. Crea la definizione per la tua applicazione: una definizione di servizio per Cloud Run o un manifest Kubernetes per GKE.

   GKE

   Crea un file denominato k8s-deployment.yaml con i seguenti contenuti:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
     namespace: default
   spec:
     replicas: 1 # from-param: ${replicaCount}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   

   Questo file è un semplice manifest Kubernetes, che viene applicato al cluster per eseguire il deployment dell'applicazione. L'immagine del container da eseguire il deployment è impostata qui come segnaposto, my-app-image, che viene sostituita con l'immagine specifica quando crei la release.

   Cloud Run

   Crea un file denominato service.yaml con i seguenti contenuti:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: my-parallel-run-service
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
       spec:
         containers:
         - image: my-app-image
   

   Questo file è una semplice definizione del servizio Cloud Run, che viene utilizzata al momento del deployment per creare il servizio Cloud Run. L'immagine del container di cui eseguire il deployment è impostata qui come segnaposto,my-app-image, che viene sostituita con l'immagine specifica quando crei la release.

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. Crea la pipeline di distribuzione e la definizione del target:

   GKE

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           replicaCount: "1"
         matchTargetLabels:
           label1: label1
       - values:
           replicaCount: "2"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production clusters
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production cluster 2
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production cluster 3
   gke:
     cluster: projects/PROJECT_ID/locations/us-west1/clusters/quickstart-cluster-qsprod2
   

   Cloud Run

   Nella directory deploy-run-parallel-quickstart, crea un nuovo file: clouddeploy.yaml, con il seguente contenuto:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           minInstances: "2"
         matchTargetLabels:
           label1: label1
       - values:
           minInstances: "3"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production us-central1
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production us-west1
   run:
     location: projects/PROJECT_ID/locations/us-west1
   

   Tieni presente che questo file include tre target: un target multiplo e due target figli. Puoi anche configurare i target in un file separato anziché con la pipeline di distribuzione.

   Tieni inoltre presente che la pipeline di importazione include deployParameters con le etichette e che i target secondari includono le etichette per corrispondere a questi parametri. In questo modo, se vuoi, puoi passare valori separati a target secondari distinti. Scopri di più.

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 un target multipla composto da due target GKE o Cloud Run, pronta per eseguire il deployment della tua applicazione.

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. Tieni presente che nella colonna Target è elencato un target anche se nel file clouddeploy.yaml hai configurato tre target (un target multiplo e due target secondari).

   

   Tieni presente che l'unico target elencato è il target multiplo qsprod-multi. I target secondari non vengono visualizzati.

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.

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-parallel-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa \
   --to-target=qsprod-multi

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-parallel-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4 \
   --to-target=qsprod-multi

Nota il flag --images=, che viene utilizzato per sostituire il segnaposto (my-app-image) nel manifest o nella definizione del servizio con l'immagine specifica con qualifica SHA. Google consiglia di creare modelli per i manifest in questo modo e di utilizzare nomi di immagini con qualifica SHA al momento della creazione della release.

Come sempre, quando crei una release, viene creato automaticamente un rollout per il primo target della pipeline (o, come in questo caso, un target specifico specificato utilizzando --to-target=). In questa guida rapida, questo target è un target multiplo, quindi rollout è un "rollout del controller" per due target secondari e non sono presenti target successivi nella pipeline di distribuzione. Ciò significa che l'applicazione viene implementata ovunque al momento della creazione dell'implementazione.

Visualizza i risultati nella console Google Cloud

Ora che hai creato la release e le implementazioni del controller e secondarie, queste implementazioni secondarie vengono eseguite (o sono in fase di esecuzione) nei rispettivi cluster GKE o servizi Cloud Run.

1. Nella console Google Cloud, vai alla pagina Pipeline di distribuzione di Cloud Deploy per visualizzare la pipeline di distribuzione my-parallel-demo-app-1.

   Apri la pagina Pipeline di pubblicazione

2. Fai clic sul nome della pipeline di distribuzione "my-parallel-demo-app-1".

   La visualizzazione della pipeline mostra lo stato di deployment dell'app. Poiché la pipeline contiene un solo passaggio, la visualizzazione mostra un solo nodo.

   

   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.