本教程介绍如何使用配置变量(预览版)自动促进不同 Google Cloud 项目中不同环境之间的集成。
概览
在本教程中,您将使用示例集成的配置变量自动执行 Application Integration 部署。此示例集成流程调用 API 并将来自该 API 的响应发布到 Pub/Sub 主题。本示例演示了如何使用调用 REST 端点和连接器任务。您可以将示例集成存储在与不同环境和 Google Cloud 项目对应的 GitHub 代码库中。目标
本教程介绍了如何在集成中完成以下任务:
- 创建集成。
- 创建配置变量并在集成中使用它们。
- 将您的集成提升到其他环境。
费用
在本教程中,您将使用 Google Cloud 的以下可计费组件:
本教程中的说明介绍了如何将资源使用量保持在 Google Cloud 免费云功能和试用优惠的限制范围内。
完成本文档中描述的任务后,您可以通过删除所创建的资源来避免继续计费。如需了解详情,请参阅清理。
准备工作
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
启用 Secret Manager API, Connectors API API。
-
创建服务帐号:
-
在 Google Cloud 控制台中,转到创建服务帐号页面。
转到“创建服务帐号” - 选择您的项目。
-
在服务帐号名称字段中,输入一个名称。Google Cloud 控制台会根据此名称填充服务帐号 ID 字段。
在服务帐号说明字段中,输入说明。例如,
Service account for quickstart
。 - 点击创建并继续。
-
将 Pub/Sub Publisher (
roles/pubsub.publisher
) 角色授予服务帐号。如需授予该角色,请找到选择角色列表,然后选择 Pub/Sub Publisher (
roles/pubsub.publisher
)。 - 点击继续。
-
点击完成以完成服务帐号的创建过程。
-
-
在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
启用 Secret Manager API, Connectors API API。
-
创建服务帐号:
-
在 Google Cloud 控制台中,转到创建服务帐号页面。
转到“创建服务帐号” - 选择您的项目。
-
在服务帐号名称字段中,输入一个名称。Google Cloud 控制台会根据此名称填充服务帐号 ID 字段。
在服务帐号说明字段中,输入说明。例如,
Service account for quickstart
。 - 点击创建并继续。
-
将 Pub/Sub Publisher (
roles/pubsub.publisher
) 角色授予服务帐号。如需授予该角色,请找到选择角色列表,然后选择 Pub/Sub Publisher (
roles/pubsub.publisher
)。 - 点击继续。
-
点击完成以完成服务帐号的创建过程。
-
创建 Pub/Sub 主题
在 Google Cloud 控制台中,转到 Pub/Sub 主题页面。
点击创建主题。
在主题 ID 字段中,输入主题 ID。 如需详细了解如何为主题命名,请参阅主题、订阅、架构或快照命名准则 。
保留添加默认订阅选项。
请勿选择其他选项。
点击创建主题。
配置 Pub/Sub 连接器
- 在 Google Cloud 控制台中,转到 Integration Connectors > Connections 页面,然后选择或创建 Google Cloud 项目。
- 点击 + 新建以打开创建连接页面。
- 在位置部分,选择连接的位置。
- 区域:从下拉列表中选择一个位置。
如需查看所有受支持区域的列表,请参阅位置。
- 点击下一步。
- 区域:从下拉列表中选择一个位置。
- 在 Connection Details 部分中,完成以下操作:
- 连接器:从可用连接器的下拉列表中选择 Pub/Sub。
- 连接器版本:从可用版本的下拉列表中选择连接器版本。
- 在连接名称字段中,输入
pub-sub-connector
。 - 服务账号:选择具有所需角色的服务账号。
- 项目 ID:Pub/Sub 实例所在的 Google Cloud 项目的 ID。
- 主题 ID:输入 Pub/Sub 主题的名称。
- 点击下一步。
- 在 Authentication 部分中,点击下一步。
- 查看:查看您的连接和身份验证详细信息。
- 点击创建。
创建新的集成
设置 Application Integration 后,您可以创建新的集成:
- 在 Google Cloud 控制台中,前往 Application Integration 页面。
- 在导航菜单中,点击 Integrations(集成)。随即会出现集成列表页面。
- 点击
- Integration name(集成名称):为您的集成输入一个名称。例如
build-cicd
。 - 说明:(可选)为集成输入说明。例如
Demo integration created for CICD tutorial
。 - 区域:从预配区域列表中选择区域
us-central1
。如果要选择的区域未预配,请参阅预配新的区域。如需查看受支持区域的列表,请参阅 Application Integration 位置。 - 服务帐号:如果您为区域启用了治理功能,则会显示此字段。 选择您要集成的服务帐号。如需了解如何为您的区域启用治理功能,请参阅修改区域。
- 点击创建。此操作会打开集成编辑器页面,您可以在其中添加任务和触发器以构建集成。
创建集成,然后在创建集成页面中提供以下详细信息:
- Integration name(集成名称):为您的集成输入一个名称。例如
创建集成流程
添加 API 触发器和调用 REST 端点
如需添加 API 触发器,请执行以下步骤:- 在 Google Cloud 控制台中,前往 Application Integration 页面。
- 在导航菜单中,点击 Integrations(集成)
此时将显示集成列表页面,其中列出了 Google Cloud 项目中提供的所有集成。
- 选择
build-cicd
集成。这将在集成编辑器中打开集成。
- 在集成编辑器导航栏中,依次点击触发器 > API 触发器以添加触发器。
- 在集成编辑器导航栏中,点击 Tasks > Call REST Endpoint 即可添加任务。
- 添加从 API 触发器元素到 调用 REST 端点元素的边缘连接,方法是将鼠标悬停在 API 触发器元素上的控制点上,然后点击线条并将其拖动到调用 REST 端点任务元素的控制点上。
创建配置变量
如需创建配置变量,请按以下步骤操作:- 在集成编辑器导航栏中,点击 (切换面板)以显示变量窗格。
- 点击 +创建。
- 在创建变量窗格中执行以下操作:
- 对于名称,请输入
url
。Application Integration 会向配置变量添加
`CONFIG_
前缀。如果要使用 API 将配置变量添加到集成中,请使用以下格式配置变量:`CONFIG_CONFIG_VARIABLE_NAME`
。如需了解如何下载和上传集成,请参阅上传和下载集成。 - 对于变量类型,选择配置变量。
- 对于数据类型,选择字符串。
- 点击创建。
配置变量将显示在 Variables 窗格中。
- 对于名称,请输入
- 重复第 2 步和第 3 步,添加以下配置变量:
- 名称:
connection_name
- 变量类型:
Config Variable
- 数据类型:
String
- 名称:
添加和配置调用 REST 端点
如需创建配置变量,请按以下步骤操作:- 在集成编辑器中,点击 Call REST Endpoint 任务,打开任务配置窗格。然后,执行以下操作:
- 展开 Task input 部分。
- 在端点基准网址中,点击变量,然后添加
$`CONFIG_url`$
。
添加和配置连接器任务
- 在集成编辑器导航栏中,依次点击任务 > 连接器。
- 点击配置连接器。
- 在区域列表中,选择您在哪个区域创建了 Pub/Sub 连接器。
- 在连接字段中,选择您在上一步中创建的 Pub/Sub 连接器。
- 在类型部分,选择操作。
- 在设置实体/操作部分的操作中,选择 publishMessage。
- 在默认值中,添加配置变量的默认值。
- 点击创建。
- 在连接器任务配置窗格中,展开连接详情部分以更新以下字段:
- 在连接名称字段中,点击变量,然后选择
$`CONFIG_connection_name`$
。
- 在连接名称字段中,点击变量,然后选择
添加数据映射任务
- 在集成编辑器导航栏中,依次点击任务 > 数据映射。
- 通过以下方法添加从 Call REST Endpoint 元素到 Data Mapping 元素的边缘连接:将鼠标悬停在 Call REST Endpoint 元素的控制点上,然后点击线条并将其拖动到 Data Mapping 任务元素的控制点上。
- 添加从数据映射元素到连接器元素的另一个边缘连接,方法是将鼠标悬停在数据映射元素上的控制点上,然后点击线条并将其拖动到连接器任务元素上的控制点上。
- 在数据映射任务配置窗格中,点击打开数据映射编辑器。
- 将“调用 REST 端点”任务的输出变量映射到“连接器”任务的输入变量。
发布集成
如需发布集成,请按以下步骤操作:- 如需发布集成,请点击集成编辑器工具栏中的发布。
此时将显示发布集成对话框。
- 在发布集成对话框中,输入以下配置变量的值:
url
:输入端点网址的名称。connection_name
:输入您在上一步中创建的 Pub/Sub 连接器的名称。
- 点击发布。
- 成功发布集成后,您可以查看和检查已发布集成的执行日志。如需查看日志,请点击集成编辑器工具栏中的日志。
促进跨环境集成
如需促进跨环境的集成,您可以使用 integrationcli
工具,这是一种开源工具,可让您与 Application Integration API 和 Integration Connectors API 交互。借助此工具,您可以管理集成实体、身份验证配置等集成实体。如需了解如何为集成生成基架并应用该基架生成的更改,请参阅社区博客中的 integrationcli
简介。
您还可以通过设置 DevOps 流水线来促进跨环境更改,例如使用 Jenkins、GitLab、Cloud Build 等。如需了解详情,请参阅与 Cloud Build 集成。
如果您不想使用 integrationcli
,可以手动下载集成并将其上传到新项目。由于目前无法下载连接器,您必须在新项目中手动创建连接器。在新环境中发布集成时,Application Integration 可让您为配置变量输入值。
后续步骤
- 探索 GitHub 中的示例集成。
- 详细了解配置变量。
- 详细了解
integrationcli
工具。