为集成构建 CICD

本教程介绍如何使用配置变量（预览版）自动执行在不同 Google Cloud 项目的不同环境之间升级集成版本的操作。

概览

在本教程中，您将使用配置变量为示例集成自动执行 Application Integration 部署。此示例集成流程会调用 API，并将 API 的响应发布到 Pub/Sub 主题。此示例旨在说明如何使用调用 REST 端点和连接器任务。您可以将示例集成存储在与不同环境和 Google Cloud 项目对应的 GitHub 代码库中。

创建 Pub/Sub 主题

  1. 在 Google Cloud 控制台中，前往 Pub/Sub 主题页面。

    转到“主题”

  2. 点击创建主题。

  3. 在主题 ID 字段中，输入主题 ID。 如需详细了解如何命名主题，请参阅主题、订阅、架构或快照命名指南 。

  4. 保留添加默认订阅选项。

  5. 请勿选择其他选项。

  6. 点击创建主题。

配置 Pub/Sub 连接器

  1. 在 Google Cloud 控制台中，前往 Integration Connectors > 连接页面，然后选择或创建 Google Cloud 项目。

    转到“连接”页面

  2. 点击 + 新建以打开创建连接页面。
  3. 在位置部分中，选择连接的位置。
    1. 区域：从下拉列表中选择一个位置。

      如需查看所有受支持区域的列表，请参阅位置。

    2. 点击下一步。
  4. 在连接详情部分中，完成以下操作：
    1. 连接器：从可用连接器的下拉列表中选择 Pub/Sub。
    2. 连接器版本：从可用版本的下拉列表中选择一个连接器版本。
    3. 在连接名称字段中，输入 pub-sub-connector。
    4. 服务账号：选择具有所需角色的服务账号。
    5. 项目 ID： Google Cloud Pub/Sub 实例所在的项目 ID。
    6. 主题 ID：输入 Pub/Sub 主题的名称。
    7. 点击下一步。
  5. 在身份验证部分中，点击下一步。
  6. 查看：查看您的连接和身份验证详细信息。
  7. 点击创建。

创建新的集成

设置 Application Integration 后，您可以创建新的集成：

  1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

    转到 Application Integration

  2. 点击左侧导航菜单中的集成，打开集成页面。
  3. 点击 Create integration（创建集成），然后在 Create Integration（创建集成）页面中提供以下详细信息：
    1. 集成名称：输入集成的名称。例如 build-cicd。
    2. 说明：（可选）输入集成的说明。例如 Demo integration created for CICD tutorial。
    3. 区域：从已配置的区域列表中选择区域 us-central1。如果您要选择的区域未预配，请参阅预配新区域。如需查看支持的区域列表，请参阅 Application Integration 位置。
    4. 服务账号：如果您已为所在区域启用治理功能，则会显示此字段。 为集成选择服务账号。如需了解如何为区域启用数据治理，请参阅修改区域。
    5. 点击创建。这会在集成编辑器页面中打开集成，您可以在其中添加任务和触发器来构建集成。

创建集成流程

添加 API 触发器和“调用 REST 端点”

如需添加 API 触发器，请执行以下步骤：
  1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

    转到 Application Integration

  2. 在导航菜单中，点击集成

    系统会显示集成列表页面，其中列出了 Google Cloud 项目中的所有可用集成。

  3. 选择 build-cicd 集成。

    这将在集成编辑器中打开集成。

  4. 在集成编辑器导航栏中，依次点击触发器 > API 触发器以添加触发器。
  5. 在集成编辑器导航栏中，依次点击“任务”图标 >“调用 REST 端点”以添加该任务。
  6. 如需添加从 API 触发器元素到调用 REST 端点元素的边缘连接，请将控制点悬停在 API 触发器元素上，然后点击线条并将其拖到调用 REST 端点任务元素上的控制点。

创建配置变量

如需创建配置变量，请按以下步骤操作：
  1. 在集成编辑器导航栏中，点击 （切换面板）以显示变量窗格。
  2. 点击 +创建。
  3. 在创建变量窗格中执行以下操作：
    1. 对于名称，输入 url。

      Application Integration 会向配置变量添加 `CONFIG_ 前缀。如果您想使用 API 将配置变量添加到集成中，请使用以下格式的配置变量：`CONFIG_CONFIG_VARIABLE_NAME`。如需了解如何下载和上传集成，请参阅上传和下载集成。

    2. 对于变量类型，选择配置变量。
    3. 对于数据类型，请选择字符串。
    4. 点击创建。

      配置变量会显示在变量窗格中。

  4. 重复第 2 步和第 3 步，以添加以下配置变量：
    • 名称：connection_name
    • 变量类型： Config Variable
    • 数据类型： String

添加并配置“调用 REST 端点”任务

如需创建配置变量，请按以下步骤操作：
  1. 在集成编辑器中，点击调用 REST 端点任务以打开任务配置窗格。然后，执行以下操作：
    1. 展开任务输入部分。
    2. 在端点基本网址中，点击变量，然后添加 $`CONFIG_url`$。

添加和配置连接器任务

  1. 在集成编辑器导航栏中，依次点击任务 > 连接器。
  2. 点击配置连接器。
  3. 从区域列表中，选择您在其中创建了 Pub/Sub 连接器的区域。
  4. 在连接字段中，选择您在上一步中创建的 Pub/Sub 连接器。
  5. 在类型部分，选择操作。
  6. 在设置实体/操作部分，针对操作，选择 publishMessage。
  7. 在默认值中，添加配置变量的默认值。
  8. 点击创建。
  9. 在连接器任务配置窗格中，展开连接详情部分，以更新以下字段：
    1. 在连接名称字段中，点击变量，然后选择 $`CONFIG_connection_name`$。

添加数据映射任务

  1. 在集成编辑器导航栏中，依次点击任务 > 数据映射。
  2. 如需添加从调用 REST 端点元素到数据映射元素的边缘连接，请将控制点悬停在调用 REST 端点元素上，然后点击线条并将其拖动到数据映射任务元素上的控制点。
  3. 如需添加从数据映射元素到连接器元素的另一个边缘连接，请将控制点悬停在数据映射元素上，然后点击线条并将其拖动到连接器任务元素上的控制点。
  4. 在数据映射任务配置窗格中，点击打开数据映射编辑器。
  5. 将“调用 REST 端点”任务的输出变量映射到“连接器”任务的输入变量。

发布集成

如需发布集成，请按以下步骤操作：
  1. 如需发布集成，请点击集成编辑器工具栏中的发布。

    系统随即会显示发布集成对话框。

  2. 在发布集成对话框中，为以下配置变量输入值：
    1. url：输入端点网址的名称。
    2. connection_name：输入您在上一步中创建的 Pub/Sub 连接器的名称。
  3. 点击发布。
  4. 成功发布集成后，您可以查看和检查已发布集成的执行日志。如需查看日志，请点击集成编辑器工具栏中的日志。

跨环境推广集成

如需在各个环境中推广集成，您可以使用 integrationcli 工具。该工具是一款开源工具，可让您与 Application Integration API 和 Integration Connectors API 进行交互。借助此工具，您可以管理集成实体，例如集成、身份验证配置等。如需了解如何生成集成框架并应用框架生成的更改，请参阅社区博客中的 integrationcli 简介。

您还可以通过设置 DevOps 流水线（例如使用 Jenkins、GitLab、Cloud Build 等）在不同环境之间升级更改。如需了解详情，请参阅与 Cloud Build 集成。

如果您不想使用 integrationcli，可以手动下载集成并将其上传到新项目。您必须在新项目中手动创建连接器，因为目前无法下载连接器。在新环境中发布集成时，Application Integration 可让您为配置变量输入值。

后续步骤