同時將應用程式部署至多個目標

準備 Skaffold 設定和應用程式資訊清單

Cloud Deploy 會使用 Skaffold，為您提供詳細資訊，說明要部署哪些內容，以及如何為個別目標正確部署。

在本快速入門導覽課程中，您會建立 skaffold.yaml 檔案，用來識別用於部署範例應用程式的應用程式資訊清單。

1. 開啟終端機視窗。

2. 建立新目錄並前往該目錄。

   GKE

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

   Cloud Run

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

3. 建立名為 skaffold.yaml 的檔案，並在當中加入下列內容：

   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: {}
   

   這個檔案是基本 Skaffold 設定。在本快速入門導覽課程中，您會建立檔案。不過，您也可以讓 Cloud Deploy 為您建立一個，用於簡單的非正式版應用程式。

   如要進一步瞭解此檔案，請參閱 skaffold.yaml 參考資料。

4. 建立應用程式定義，也就是 Cloud Run 的服務定義或 GKE 的 Kubernetes 資訊清單。

   GKE

   建立名為 k8s-deployment.yaml 的檔案，並在其中加入下列內容：

   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
   

   這個檔案是簡單的 Kubernetes 資訊清單，會套用至叢集以部署應用程式。要部署的容器映像檔會在此處設為預留位置 my-app-image，您在建立版本時，系統會將其替換為特定映像檔。

   Cloud Run

   建立名為 service.yaml 的檔案，並在其中加入下列內容：

   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
   

   這個檔案是簡單的 Cloud Run 服務定義，會在部署時用於建立 Cloud Run 服務。要部署的容器映像檔會在此處設為預留位置 my-app-image，並在建立版本時替換為特定映像檔。

建立推送管道和目標

您可以在一個檔案或個別檔案中定義管道和目標。在本快速入門導覽課程中，您將建立單一檔案。

1. 建立推送管道和目標定義：

   GKE

   在 deploy-gke-parallel-quickstart 目錄中建立新檔案 clouddeploy.yaml，並加入下列內容：

   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

   在 deploy-run-parallel-quickstart 目錄中建立新檔案 clouddeploy.yaml，並加入下列內容：

   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
   

   請注意，這個檔案包含三個目標：多目標和兩個子目標。您也可以在個別檔案中設定目標，而非使用發布管道。

   請注意，提交管道包含 deployParameters 和標籤，而子目標則包含標籤，以便與這些參數相符。這樣一來，您可以視需要將個別值傳遞至個別子目標。瞭解詳情。

2. 使用 Cloud Deploy 服務註冊管道和目標：

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

   您現在擁有一個管道，其中包含一個多目標，包含兩個 GKE 或 Cloud Run 目標，可部署應用程式。

3. 確認管道和目標：

   在 Google Cloud 控制台中，前往 Cloud Deploy 的「Delivery pipelines」(推送管道) 頁面，查看可用的推送管道清單。

   開啟「Delivery pipelines」頁面

   畫面上會顯示您剛剛建立的提交管道。請注意，即使您在 clouddeploy.yaml 檔案中設定了三個目標 (一個多目標和兩個子目標)，但「目標」欄中只會列出一個目標。

   

   請注意，列出的唯一目標是多目標 qsprod-multi。不會顯示子目標。

建立版本

版本是代表待部署變更的集中式 Cloud Deploy 資源。發布管道會定義該版本的生命週期。如要進一步瞭解這個生命週期，請參閱 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:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a \
   --to-target=qsprod-multi

請注意 --images= 旗標，您可以使用該旗標將資訊清單或服務定義中的預留位置 (my-app-image) 替換為特定 SHA 合格映像檔。Google 建議您以這種方式建立資訊清單範本，並在建立版本時使用 SHA 合格圖片名稱。

如往常，建立版本時，系統會自動為管道中的第一個目標 (或在本例中，使用 --to-target= 指定的特定目標) 建立推出作業。在這個快速入門課程中，這個目標是多目標，因此 rollout 是兩個子目標的「控制器推出作業」，且推送管道中沒有後續目標。這表示應用程式會在建立推行計畫時部署到所有地方。

在 Google Cloud 控制台中查看結果

您已建立版本，並建立了控制器推出作業和子推出作業，因此這些子推出作業現在已部署 (或正在部署) 至各自的 GKE 叢集或 Cloud Run 服務。

1. 在 Google Cloud 控制台中，前往 Cloud Deploy 的「Delivery pipelines」(推送管道) 頁面，查看「my-parallel-demo-app-1」推送管道。

   開啟「Delivery pipelines」頁面

2. 按一下推送管道名稱「my-parallel-demo-app-1」。

   管道示意圖會顯示應用程式的部署狀態。由於管道中只有一個階段，因此視覺化資訊只會顯示一個節點。

   

   你的版本會列在「發布管道詳細資料」下方的「版本」分頁中。

3. 按一下版本名稱 test-release-001。

   推出計畫會顯示在「推出計畫」下方。您可以按一下推行內容，查看詳細資料，包括部署記錄。