定义和使用自定义目标类型

准备 Skaffold 配置

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

在本快速入门中，您将创建一个 skaffold.yaml 文件，用于定义表示自定义目标类型渲染和部署操作的自定义操作。

请注意，本快速入门中提供的自定义操作实际上不会将任何应用部署到运行时。渲染操作和部署操作都会将结果文件上传到 Cloud Storage，以履行 Cloud Deploy 与用户定义的渲染和部署之间的自定义目标合同。

1. 打开一个终端窗口。

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

   mkdir custom-target-quickstart
   cd custom-target-quickstart
   

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

   apiVersion: skaffold/v4beta7
   kind: Config
   customActions:
   - name: custom-render
     containers:
     - name: render
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo "Sample manifest rendered content" > manifest.txt
           gcloud storage cp manifest.txt $CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt
           echo {\"resultStatus\": \"SUCCEEDED\", \"manifestFile\": \"$CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   - name: custom-deploy
     containers:
     - name: deploy
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo {\"resultStatus\": \"SUCCEEDED\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   

   此文件包含 customActions: stanza，用于定义自定义渲染操作和自定义部署操作。每个自定义操作都引用一个要运行的容器映像，以及要在该容器上运行的命令。

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

创建交付流水线、自定义目标类型和目标

您可以在一个文件中或在单独的文件中定义交付流水线、自定义目标类型和目标。在本快速入门中，您将创建一个包含所有这三项内容的单个文件。

1. 在 custom-target-quickstart 目录中，创建一个新文件 clouddeploy.yaml，其中包含以下内容：

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: custom-targets-pipeline
   serialPipeline:
     stages:
     - targetId: sample-env
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: sample-env
   customTarget:
     customTargetType: basic-custom-target
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: CustomTargetType
   metadata:
     name: basic-custom-target
   customActions:
     renderAction: custom-render
     deployAction: custom-deploy
   

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

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

   您现在有了一个交付流水线，其中包含一个目标。这是使用自定义目标类型的目标，并且此流水线不会将应用部署到运行时。

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

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

   打开“交付流水线”页面

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

   

创建版本

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

从 custom-target-quickstart 目录运行以下命令，以创建表示要部署的自定义操作的 release 资源：

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=custom-targets-pipeline

与所有版本一样（除非它们包含 --disable-initial-rollout），Cloud Deploy 还会自动创建部署资源。并且会执行该发布的所有阶段，包括渲染和部署。

在 Google Cloud 控制台中查看结果

几分钟后，部署即会完成。在这种情况下，由于这两个自定义操作是将字符串回显到文件并上传到 Cloud Storage 的命令，因此不会将任何内容部署到任何目标运行时。

不过，您可以查看该文件以及其中的字符串：

1. 在 Google Cloud 控制台中，导航到 Cloud Deploy 交付流水线页面，以查看您的交付流水线 (custom-targets-pipeline)。

   打开“交付流水线”页面

2. 点击交付流水线的名称 (custom-targets-pipeline)。

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

   

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

3. 点击发布版本名称。

   系统会显示发布版本详情页面。

4. 点击工件标签页。

5. 在目标制品下，点击查看制品链接。

   系统会显示呈现的清单文件。在本例中，该文件是您在 skaffold.yaml 配置文件中定义的自定义渲染操作的输出，其中包含字符串“Sample manifest rendered content”。

   

6. 查找此版本创建的 Cloud Storage 存储分区。

   打开“Cloud Storage 浏览器”页面

   系统会显示存储分区页面，其中显示了为此版本创建的两个存储分区。一个存储桶包含交付流水线配置文件和渲染的 skaffold.yaml。另一个包含自定义操作配置为创建的输出文件。

7. 点击名称以 us-central1.deploy-artifacts 开头的存储桶...

   

8. 点击名称以 custom-targets-pipeline- 开头的文件夹，然后点击 test-release-001 文件夹。

9. 点击名称为您的发布名称的文件夹，该名称应为 test-release-001-to-sample-env-0001。

10. 点击显示的文件夹（即 UUID），然后点击 custom-output 文件夹。

11. 点击 results.json，然后点击经过身份验证的网址字段中的超链接网址。

    此文件包含您在 skaffold.yaml 中配置为 custom-deploy 操作输出的字符串：