使用部署参数

准备 Skaffold 配置和清单

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

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

1. 打开一个终端窗口。

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

   GKE

   mkdir deploy-params-gke-quickstart
   cd deploy-params-gke-quickstart
   

   Cloud Run

   mkdir deploy-params-run-quickstart
   cd deploy-params-run-quickstart
   

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

   GKE

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

   Cloud Run

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

   此文件是一个最小型的 Skaffold 配置。在本快速入门中，您需要创建该文件。不过，对于简单的非生产应用，您也可以让 Cloud Deploy 为您创建一个。

   如需详细了解此文件，请参阅 skaffold.yaml 参考文档。

4. 为您的应用创建定义，即为 Cloud Run 创建服务定义，或为 GKE 创建 Kubernetes 清单。

   GKE

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

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
   spec:
     replicas: 1 # from-param: ${replicaCount}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
         annotations:
           commit: defaultShaValue # from-param: ${git-sha}
       spec:
         containers:
         - name: nginx
           image: my-app-image
           env:
           - name: envvar1
             value: default1 # from-param: ${application_env1}
           - name: envvar2
             value: default2 # from-param: ${application_env2}
   

   此文件是 Kubernetes 清单，用于应用到集群以部署应用。要部署的容器映像在此处设置为占位符 my-app-image，在您创建版本时，系统会将其替换为特定映像。

   Cloud Run

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

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: my-parallel-run-service
   spec:
     autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         annotations:
           commit: defaultShaValue # from-param: ${git-sha}
       spec:
         containers:
         - image: my-app-image
           env:
           - name: envvar1
             value: defaultValue1 # from-param: ${application_env1}
           - name: envvar2
             value: defaultValue2 # from-param: ${application_env2}
   

   此文件是一个基本的 Cloud Run 服务定义，用于部署应用。此处将要部署的容器映像设置为占位符 my-app-image，在创建版本时，该占位符会替换为具体映像。

创建交付流水线和目标

您可以在一个文件中或在单独的文件中定义流水线和目标。在本快速入门中，我们将创建一个文件。

1. 创建交付流水线和目标定义：

   GKE

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-params-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: params-prod-multi
       deployParameters:
       - values:
           replicaCount: "2"
         # Apply the deploy parameter replicaCount: "2" to the target with this label
         matchTargetLabels:
           label1: label1
       - values:
           replicaCount: "3"
         # Apply the deploy parameter replicaCount: "3" to the target with this label
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-multi
   description: production clusters
   multiTarget:
     targetIds: [params-prod-a, params-prod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-a
     labels:
       label1: label1
   description: production cluster 1
   deployParameters:
     application_env1: "sampleValue1"
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/deploy-params-cluster-prod1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-b
     labels:
       label2: label2
   description: production cluster 2
   deployParameters:
     application_env2: "sampleValue2"
   gke:
     cluster: projects/PROJECT_ID/locations/us-west1/clusters/deploy-params-cluster-prod2
   

   Cloud Run

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-params-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: params-prod-multi
       deployParameters:
       - values:
           minInstances: "2"
         # Apply the deploy parameter minInstances: "2" to the target with this label
         matchTargetLabels:
           label1: label1
       - values:
           minInstances: "3"
         # Apply the deploy parameter minInstances: "3" to the target with this label
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-multi
   description: production clusters
   multiTarget:
     targetIds: [params-prod-a, params-prod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-a
     labels:
       label1: label1
   description: production cluster 1
   deployParameters:
     application_env1: "sampleValue1"
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: params-prod-b
     labels:
       label2: label2
   description: production cluster 2
   deployParameters:
     application_env2: "sampleValue2"
   run:
     location: projects/PROJECT_ID/locations/us-west1
   

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

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

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

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

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

   打开“交付流水线”页面

   系统会显示您刚刚创建的交付流水线。请注意，即使您在 clouddeploy.yaml 文件中配置了三个目标（一个多目标和两个子目标），目标列中也只列出了 1 个目标。

   

   请注意，列出的唯一目标是多目标 params-prod-multi。子目标不会显示。

创建版本

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

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

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-params-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4 \
   --deploy-parameters="git-sha=f787cac"

一如既往，创建版本后，系统会自动为流水线中的第一个目标创建发布作业（除非使用 --to-target= 指定了特定目标）。在此快速入门中，此目标是多目标，因此 rollout 是两个子目标的“控制器发布作业”，并且交付流水线中没有后续目标。这意味着，在发布版本时，您的应用会部署到所有平台。

在 Google Cloud 控制台中查看结果

现在，您已创建版本，并创建了控制器版本发布和子版本发布，这些子版本发布现已部署到各自的 GKE 集群或 Cloud Run 服务（或正在部署）。

1. 在 Google Cloud 控制台中，前往 Cloud Deploy 交付流水线页面，查看您的 my-parallel-demo-app-1 交付流水线。

   打开“交付流水线”页面

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

   流水线直观显示将显示应用的部署状态。由于流水线中只有一个阶段，因此可视化结果中只显示一个节点。

   

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

3. 点击版本名称 test-release-001。

   您的发布会显示在发布下。您可以点击发布以查看其详细信息，包括部署日志。

   

4. 在版本详情下，选择工件标签页。

   部署参数表格列出了您在清单中配置的所有参数以及您为这些参数提供的值：

   GKE

   

   Cloud Run

   

   除了参数和值之外，该表还会显示每个参数适用于哪个目标。

5. 在版本检查器列中，点击任一目标的查看工件。

6. 点击显示差异，然后为一个目标选择 params-prod-a，为另一个目标选择 params-prod-b。

   系统会显示一个差异，比较两个目标的呈现的清单，包括您指定的值：

   GKE

   

   Cloud Run