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

准备 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:66e2681aa3099b4e517e4cdcdefff8f2aa45d305007124ccdc09686f6712d018
       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:66e2681aa3099b4e517e4cdcdefff8f2aa45d305007124ccdc09686f6712d018
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo {\"resultStatus\": \"SUCCEEDED\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   

   此文件包含 customActions: 诗节，用于定义自定义呈现操作和自定义部署操作。每项自定义操作都会引用要运行的容器映像以及要在该容器上运行的命令。

   如需详细了解此配置文件，请参阅 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 目录运行以下命令，以创建表示要部署的自定义 Action 的 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 操作的输出的字符串：