將應用程式以初期測試部署至目標

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

Cloud Deploy 會使用 Skaffold 提供詳細資訊，說明要部署哪些內容，以及如何正確地將這些內容部署至目標。

在本快速入門導覽課程中，您會建立 skaffold.yaml 檔案，用於識別要部署的 Kubernetes 資訊清單或 Cloud Run 服務設定。

1. 開啟終端機視窗。

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

   GKE

   mkdir deploy-canary-quickstart-gke
   cd deploy-canary-quickstart-gke
   

   GKE + Gateway API

   mkdir deploy-canary-quickstart-gke-gatewayapi
   cd deploy-canary-quickstart-gke-gatewayapi
   

   Cloud Run

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

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

   GKE

   apiVersion: skaffold/v4beta7
   kind: Config
   manifests:
     rawYaml:
     - kubernetes.yaml
   deploy:
     kubectl: {}
   

   GKE + Gateway API

   apiVersion: skaffold/v4beta7
   kind: Config
   manifests:
     rawYaml:
     - kubernetes.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta7
   kind: Config
   manifests:
     rawYaml:
     - run.yaml
   deploy:
     cloudrun: {}
   

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

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

4. 建立應用程式資訊清單。

   GKE

   在 deploy-canary-quickstart-gke 目錄中建立名為 kubernetes.yaml 的檔案，並在其中加入下列內容：

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
     namespace: default
   spec:
     selector:
       app: my-app
     ports:
       - protocol: TCP
         port: 80
   

   這個檔案是 Kubernetes 資訊清單，會套用至叢集以部署應用程式。這個資訊清單包含 Canary 部署作業所需的服務和部署資源，以及使用 Gateway API 所需的 HTTPRoute 和 Gateway 資源。

   要部署的容器映像檔會在此處設為預留位置 my-app-image，並在建立版本時替換為特定映像檔。

   GKE + Gateway API

   在 deploy-canary-quickstart-gke-gatewayapi 目錄中建立名為 kubernetes.yaml 的檔案，並在其中加入下列內容：

   kind: Gateway
   apiVersion: gateway.networking.k8s.io/v1beta1
   metadata:
     name: my-gateway
     annotations:
       networking.istio.io/service-type: "ClusterIP"
   spec:
     gatewayClassName: istio
     listeners:
     - name: default
       hostname: "*.example.com"
       port: 80
       protocol: HTTP
       allowedRoutes:
         namespaces:
           from: All
   ---
   kind: HTTPRoute
   apiVersion: gateway.networking.k8s.io/v1beta1
   metadata:
     name: my-httproute
   spec:
     parentRefs:
     - kind: Gateway
       name: my-gateway
     hostnames:
     - "test.example.com"
     rules:
     - backendRefs:
       - name: my-service
         port: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
   spec:
     selector:
       app: my-app
     ports:
     - name: tcp-port
       protocol: TCP
       port: 80
       targetPort: 8080
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   

   這個檔案是 Kubernetes 資訊清單，會套用至叢集以部署應用程式。這個資訊清單包含 Canary 部署作業所需的服務和部署資源，以及使用 Gateway API 所需的 HTTPRoute 和 Gateway 資源。

   要部署的容器映像檔會在此處設為預留位置 my-app-image，並在建立版本時替換為特定映像檔。

   Cloud Run

   在 deploy-canary-quickstart-run 目錄中建立名為 run.yaml 的檔案，並在其中加入下列內容：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: my-canary-run-service
   spec:
     template:
       spec:
         containers:
         - image: my-app-image
   

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

建立推送管道和目標

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

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: prod
    profiles: []
    strategy:
      canary:
        runtimeConfig:
          kubernetes:
            serviceNetworking:
              service: "my-service"
              deployment: "my-deployment"
        canaryDeployment:
          percentages: [50]
          verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: prod
description: prod GKE cluster
gke:
 cluster: projects/PROJECT_ID/locations/us-central1/clusters/canary-quickstart-cluster

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: prod
    profiles: []
    strategy:
      canary:
        runtimeConfig:
          kubernetes:
            gatewayServiceMesh:
              httpRoute: "my-httproute"
              service: "my-service"
              deployment: "my-deployment"
        canaryDeployment:
          percentages: [50]
          verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: prod
description: prod GKE cluster
gke:
 cluster: projects/PROJECT_ID/locations/us-central1/clusters/canary-quickstart-cluster

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: prod
    profiles: []
    strategy:
      canary:
        runtimeConfig:
          cloudRun:
            automaticTrafficControl: true
        canaryDeployment:
          percentages: [50]
          verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: prod
description: prod Run Service
run:
  location: projects/PROJECT_ID/locations/us-central1

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

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

   您現在已建立管道，並為初期測試版本策略設定一個目標。

2. 確認管道和目標：

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

   開啟「Delivery pipelines」頁面

   系統會顯示您剛建立的推送管道，並在「目標」欄中列出您設定的目標。

   

建立版本

版本是代表待部署變更的集中式 Cloud Deploy 資源。發布管道會定義該版本的生命週期。如要進一步瞭解這個生命週期，請參閱 Cloud Deploy 服務架構。

如要建立代表要部署的容器映像檔的 release 資源，請從 deploy-canary-quickstart-gke、deploy-canary-quickstart-gke-gatewayapi 或 deploy-canary-quickstart-run 目錄執行下列指令：

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

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

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-canary-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a

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

建立發布版本時，Cloud Deploy 也會自動建立推出資源，以便立即部署至單一目標 prod。

我們跳過穩定階段

在這個第一個版本中，我們略過 Canary 階段，並部署至 100% (穩定階段)。這是因為應用程式先前未部署，因此無法計算 50% 的 Pod (適用於 GKE)，也無法計算服務的流量分配方式 (適用於 Cloud Run)。Pod (GKE) 或修訂版本 (Cloud Run) 尚未存在。

跳過 Canary 階段後，我們現在可以開始穩定階段，將流量提升至 100%。之後，我們會建立另一個版本，並執行初期測試版。

在實際情況中，您通常會在應用程式已在執行的情況下執行 Canary 部署，因此很少會略過這個階段。

在 Google Cloud 控制台中查看版本

您已建立第一個版本，因此系統會建立發布作業，您可以在 Google Cloud 控制台中查看版本和發布作業。您也可以查看 pipeline 視覺化圖表，瞭解版本目前的狀態。

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

   開啟「Delivery pipelines」頁面

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

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

   

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

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

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

   

   請注意，推出狀態為「待提前」，而管道示意圖中顯示的目標有「提前至穩定版」的連結。

將推出階段推進至下一個階段

在第一個版本發布後，系統略過了初期測試階段，並等待開始「穩定」階段，以便將應用程式部署至 100%：

1. 在管道示意圖中，按一下「前往穩定版」。

2. 系統提示時，按一下「繼續」確認。

幾分鐘後，現在已進入「穩定」階段，應用程式已部署到 100%。

執行初期測試部署

由於第一個版本略過了初期測試階段，我們現在會建立另一個版本，這次會執行初期測試部署。

1. 如要建立新的 release，請從 deploy-canary-quickstart-gke、deploy-canary-quickstart-gke-gatewayapi 或 deploy-canary-quickstart-run 目錄執行下列指令：

   GKE

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

   GKE + Gateway API

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

   Cloud Run

   gcloud deploy releases create test-release-002 \
     --project=PROJECT_ID \
     --region=us-central1 \
     --delivery-pipeline=my-canary-demo-app-1 \
     --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a
   

   幾分鐘後，系統會建立推行作業，這次會執行 Canary 階段：

   

   第一階段推出作業完成後，推出作業就會進入初期測試版本階段：

   

   也就是說，應用程式現在已部署至 50%。對於以服務網路為基礎的 GKE，會部署至一半的 pod。以 Gateway API 為基礎的 GKE 和 Cloud Run 流量會分配 50%。

2. 按一下「開始推廣」，然後在系統提示時按一下「開始」。

   這會將推出作業推進至「穩定」階段，並將應用程式部署至 100%。