在 Cloud Deploy 中自动执行版本提升和发布推进

获取您的项目编号。

您需要提供项目编号才能识别默认服务账号。这对于配置自动化资源至关重要。

1. 运行以下命令以获取项目编号：

   gcloud projects describe PROJECT_ID
   

2. 从命令行输出中复制项目编号，然后将其粘贴到此处。

   您无需将其作为命令运行。将其粘贴到此处可在本快速入门的后续部分中在自动化配置中填充服务账号引用。

   PROJECT_NUMBER
   

准备 Skaffold 配置和应用清单

Cloud Deploy 使用 Skaffold 提供要部署的内容的详细信息，以及如何为您的单独目标正确部署这些内容。

在本快速入门中，您将创建一个 skaffold.yaml 文件，以标识要用于部署示例应用的应用清单。

1. 打开一个终端窗口。

2. 创建一个新目录，并导航至该目录。

   GKE

   mkdir deploy-automation-gke-quickstart
   cd deploy-automation-gke-quickstart
   

   Cloud Run

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

3. 创建名为 skaffold.yaml 且包含以下内容的文件：

   GKE

   apiVersion: skaffold/v4beta7
   kind: Config
   metadata:
     name: gke-automation
   manifests:
     rawYaml:
     - k8s-deployment.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta7
   kind: Config
   metadata:
     name: run-automation
   profiles:
   - name: dev
     manifests:
       rawYaml:
       - run-dev.yaml
   - name: staging
     manifests:
       rawYaml:
       - run-staging.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
     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 清单，用于部署应用。要部署的容器映像在此处设置为占位符 my-app-image，在您创建版本时，该占位符将替换为具体映像。

   Cloud Run

   1. 创建一个名为 run-dev.yaml 的文件，其中包含以下内容：

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

   2. 创建一个名为 run-staging.yaml 的文件，其中包含以下内容：

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

   这些文件是简单的 Cloud Run 服务定义，用于部署应用。此处将要部署的容器映像设置为占位符 my-app-image，在您创建版本时，系统会将其替换为特定映像。

创建交付流水线、目标和自动化操作

您可以在一个文件中或在单独的文件中定义交付流水线和目标。您还可以在单独的文件中定义自动化操作。本快速入门使用一个文件来定义流水线、目标和自动化操作。

1. 创建交付流水线、目标定义和自动化操作：

   GKE

   在 deploy-automation-gke-quickstart 目录中，创建包含以下内容的新文件 clouddeploy.yaml：

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-automation-demo-app-1
   description: Automation demonstration pipeline
   serialPipeline:
     stages:
     - targetId: automation-quickstart-dev
     - targetId: automation-quickstart-staging
       profiles: []
       strategy:
         canary:
           runtimeConfig:
             kubernetes:
               serviceNetworking:
                 service: "my-service"
                 deployment: "my-deployment"
           canaryDeployment:
             percentages: [25]
             verify: false
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: automation-quickstart-dev
   description: Dev cluster to demonstrate deploy automation
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/automation-quickstart-cluster-dev
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: automation-quickstart-staging
   description: Staging cluster to demonstrate deploy automation
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/automation-quickstart-cluster-staging
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Automation
   metadata:
     name: my-automation-demo-app-1/promote
   description: promotes a release
   suspended: false
   serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
   selector:
     targets:
     - id: automation-quickstart-dev
   rules:
   - promoteReleaseRule:
       name: "promote-release"
       wait: 1m
       toTargetId: "@next"
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Automation
   metadata:
     name: my-automation-demo-app-1/advance
   description: advances a rollout
   suspended: false
   serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
   selector:
     targets:
     - id: automation-quickstart-staging
   rules:
   - advanceRolloutRule:
       name: "advance-rollout"
       sourcePhases: ["canary-25"]
       wait: 1m
   

   Cloud Run

   在 deploy-automation-run-quickstart 目录中，创建包含以下内容的新文件 clouddeploy.yaml：

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-automation-demo-app-1
   description: Automation demonstration pipeline
   serialPipeline:
     stages:
     - targetId: automation-quickstart-dev
       profiles: [dev]
     - targetId: automation-quickstart-staging
       profiles: [staging]
       strategy:
         canary:
           runtimeConfig:
             cloudRun:
               automaticTrafficControl: true
           canaryDeployment:
             percentages: [25]
             verify: false
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: automation-quickstart-dev
   description: Dev cluster to demonstrate deploy automation
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: automation-quickstart-staging
   description: Staging cluster to demonstrate deploy automation
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Automation
   metadata:
     name: my-automation-demo-app-1/promote
   description: Promotes a release to the next target
   suspended: false
   serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
   selector:
     targets:
     - id: automation-quickstart-dev
   rules:
   - promoteReleaseRule:
       name: "promote-release"
       wait: 1m
       toTargetId: "@next"
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Automation
   metadata:
     name: my-automation-demo-app-1/advance
   description: advances a rollout
   suspended: false
   serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
   selector:
     targets:
     - id: automation-quickstart-staging
   rules:
   - advanceRolloutRule:
       name: "advance-rollout"
       sourcePhases: ["canary-25"]
       wait: 1m
   

2. 在 Cloud Deploy 服务中注册流水线和目标：

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

   现在，您已经有了包含一个由两个 GKE 或 Cloud Run 目标组成的多目标的流水线，可以部署应用了。

3. 确认您的流水线和目标：

   在 Google Cloud 控制台中，前往 Cloud Deploy 交付流水线页面，查看可用交付流水线的列表。

   打开“交付流水线”页面

   此时将显示您刚刚创建的交付流水线，并且目标列会列出了两个目标。

   

4. 点击流水线名称，打开交付流水线可视化图表和详细信息。

5. 在提交流水线详情下，选择自动化标签页。

   系统会显示您创建的两个自动化操作。

   

创建版本

版本是表示要部署的更改的中央 Cloud Deploy 资源。交付流水线定义该版本的生命周期。如需详细了解该生命周期，请参阅 Cloud Deploy 服务架构。

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-automation-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-automation-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4

默认情况下，当您创建版本时，系统会自动为流水线中的第一个目标创建发布。

由于本快速入门包含两个自动化操作，因此系统会自动执行以下两项操作：

• 在第一个目标中成功部署后，该版本会自动提升到第二个目标。

  自动提升功能需要等待一分钟。

• 在第二个目标（配置了 25% 的 Canary 版）中，第二个自动化操作会将发布范围从 canary-25 推进到 stable。

  对于此首次发布版本，系统会跳过 canary-25 阶段，因为没有可与 Canary 版本进行比较的现有应用版本。发布会自动推进到 stable。

  提前自动化操作会延迟一分钟。

完成所有操作后，应用会成功部署到两个目标平台，而无需您执行任何其他操作。

如果您想详细了解如何运行 Canary 部署策略，可以尝试Canary 快速入门。

在 Google Cloud 控制台中查看结果

您可以在 Google Cloud 控制台中查看结果，包括自动化运行作业。

1. 前往 Cloud Deploy 交付流水线页面，查看您的交付流水线。

   打开“交付流水线”页面

2. 点击交付流水线的名称“my-automation-demo-app-1”。

   流水线直观显示将显示应用的部署状态。如果已过足够的时间，两个目标都会显示绿色。

   

   您的版本列在版本标签页中交付流水线详细信息下。

3. 点击自动化操作运行情况标签页。

   其中包含两个条目，分别对应于您创建的两个自动化操作。您可以点击任一图标来查看相应自动化操作的详细信息。