在 Application Design Center 中,您可以配置 Pub/Sub 主题和订阅,以提供异步、伸缩消息传递功能,从而将生成消息的服务提供方与处理消息的服务分离开来。您可以根据 GitHub 上的 terraform-google-pubsub Terraform 模块,为主题和订阅自定义组件连接和配置参数。
组件连接
下表列出了您可以连接到 Pub/Sub 主题或订阅的组件,以及对应用及其生成的 Terraform 代码所做的相应更新。
| 关联的组成部分 | 应用更新 | 背景信息 |
|---|---|---|
|
实例模板 | |
|
使用 Identity and Access Management (IAM) 进行访问权限控制 | |
|
BigQuery 订阅 | |
|
教程:将 Pub/Sub 与 Cloud Run 搭配使用 | |
|
Cloud Storage 订阅 |
必需的配置参数
如果您的模板包含 Pub/Sub 组件,则必须在部署之前配置以下参数。
| 参数名称 | 说明和限制条件 | 背景信息 |
|---|---|---|
项目 ID |
您要在其中部署 Pub/Sub 资源的项目。 |
配置组件 |
主题 |
name | 主题、订阅、架构或快照命名指南 |
可选配置参数
以下参数是可选的。如需显示高级参数,请在配置区域中选择显示高级字段。
| 功能 | 参数名称 | 说明和限制条件信息 | 背景信息 |
|---|---|---|---|
| 创建主题 | 默认情况下,系统会创建一个主题。如果您不想创建主题,请清除该复选框。 | 创建主题 | |
| 创建订阅 | 默认情况下,系统会创建订阅。如果您不想创建订阅,请清除该复选框。 | 订阅概览 | |
| 主题标签 | 键 | labels | 通过标签报告使用量 |
| 主题标签 | 值 | labels | 通过标签报告使用量 |
| 推送订阅 | 名称 | name | 主题、订阅、架构或快照命名指南 |
| 推送订阅 | 确认时限(秒) | ackDeadlineSeconds | 确认截止时间 |
| 推送订阅 | 推送端点 | pushEndpoint | Endpoints |
| 推送订阅 | X-goog-version | 推送消息的 Pub/Sub API 格式。例如 v1beta1。 |
属性 |
| 推送订阅 | OIDC 服务账号邮箱 | serviceAccountEmail | Authentication |
| 推送订阅 | 受众群体 | audience | Authentication |
| 推送订阅 | 到期政策 | expirationPolicy | 到期期限 |
| 推送订阅 | 死信主题 | deadLetterTopic | 死信主题 |
| 推送订阅 | 保留已确认的消息 | retainAckedMessages | 保留已确认的消息 |
| 推送订阅 | 消息保留时长 | messageRetentionDuration | 消息保留时长 |
| 推送订阅 | 传送尝试次数上限 | maxDeliveryAttempts | 死信主题 |
| 推送订阅 | 最大退避时间 | maximumBackoff | 重试政策 |
| 推送订阅 | 最小退避时间 | minimumBackoff | 重试政策 |
| 推送订阅 | 过滤 | filter | 订阅过滤条件 |
| 推送订阅 | 启用消息排序 | enableMessageOrdering | 消息排序 |
| 拉取订阅 | 名称 | name | 主题、订阅、架构或快照命名指南 |
| 拉取订阅 | 确认时限(秒) | ackDeadlineSeconds | 确认截止时间 |
| 拉取订阅 | 死信主题 | deadLetterTopic | 死信主题 |
| 拉取订阅 | 传送尝试次数上限 | maxDeliveryAttempts | 死信主题 |
| 拉取订阅 | 保留已确认的消息 | retainAckedMessages | 保留已确认的消息 |
| 拉取订阅 | 消息保留时长 | messageRetentionDuration | 消息保留时长 |
| 拉取订阅 | 最大退避时间 | maximumBackoff | 重试政策 |
| 拉取订阅 | 最小退避时间 | minimumBackoff | 重试政策 |
| 拉取订阅 | 过滤 | filter | 订阅过滤条件 |
| 拉取订阅 | 启用消息排序 | enableMessageOrdering | 消息排序 |
| 拉取订阅 | 服务账号 | 在订阅上被授予 roles/pubsub.subscriber 角色的服务账号。 |
使用 IAM 进行访问权限控制 |
| 拉取订阅 | 启用“仅传送一次” | enableExactlyOnceDelivery | “正好一次”传送 |
| BigQuery 订阅 | 名称 | name | 主题、订阅、架构或快照命名指南 |
| BigQuery 订阅 | 表格 | 表格 | 创建 BigQuery 订阅 |
| BigQuery 订阅 | 使用主题架构 | useTopicSchema | 使用主题架构 |
| BigQuery 订阅 | 使用表架构 | useTableSchema | 使用表架构 |
| BigQuery 订阅 | 写入元数据 | writeMetadata | 写入元数据 |
| BigQuery 订阅 | 删除未知字段 | dropUnknownFields | 删除未知字段 |
| BigQuery 订阅 | 确认时限(秒) | ackDeadlineSeconds | 确认截止时间 |
| BigQuery 订阅 | 保留已确认的消息 | retainAckedMessages | 保留已确认的消息 |
| BigQuery 订阅 | 消息保留时长 | messageRetentionDuration | 消息保留时长 |
| BigQuery 订阅 | 启用消息排序 | enableMessageOrdering | 消息排序 |
| BigQuery 订阅 | 到期政策 | expirationPolicy | 到期期限 |
| BigQuery 订阅 | 过滤 | filter | 订阅过滤条件 |
| BigQuery 订阅 | 死信主题 | deadLetterTopic | 死信主题 |
| BigQuery 订阅 | 最大退避时间 | maximumBackoff | 重试政策 |
| BigQuery 订阅 | 最小退避时间 | minimumBackoff | 重试政策 |
| Cloud Storage 订阅 | 名称 | name | 主题、订阅、架构或快照命名指南 |
| Cloud Storage 订阅 | 存储桶 | 存储桶 | 存储桶名称 |
| Cloud Storage 订阅 | 文件名前缀 | filenamePrefix | 文件名、前缀、后缀和日期时间 |
| Cloud Storage 订阅 | 文件名后缀 | filenameSuffix | 文件名、前缀、后缀和日期时间 |
| Cloud Storage 订阅 | 文件名日期时间格式 | filenameDatetimeFormat | 文件名、前缀、后缀和日期时间 |
| Cloud Storage 订阅 | 时长上限 | maxDuration | 文件批量处理 |
| Cloud Storage 订阅 | 最大字节数 | maxBytes | 文件批量处理 |
| Cloud Storage 订阅 | 消息数量上限 | maxMessages | 文件批量处理 |
| Cloud Storage 订阅 | 输出格式 | textConfig 或 avroConfig | 文件格式 |
| Cloud Storage 订阅 | 写入元数据 | writeMetadata | 文件格式 |
| Cloud Storage 订阅 | 使用主题架构 | useTopicSchema | 文件格式 |
| Cloud Storage 订阅 | 确认时限(秒) | ackDeadlineSeconds | 确认截止时间 |
| Cloud Storage 订阅 | 保留已确认的消息 | retainAckedMessages | 保留已确认的消息 |
| Cloud Storage 订阅 | 消息保留时长 | messageRetentionDuration | 消息保留时长 |
| Cloud Storage 订阅 | 启用消息排序 | enableMessageOrdering | 消息排序 |
| Cloud Storage 订阅 | 到期政策 | expirationPolicy | 到期期限 |
| Cloud Storage 订阅 | 过滤 | filter | 订阅过滤条件 |
| Cloud Storage 订阅 | 死信主题 | deadLetterTopic | 死信主题 |
| Cloud Storage 订阅 | 最大退避时间 | maximumBackoff | 重试政策 |
| Cloud Storage 订阅 | 最小退避时间 | minimumBackoff | 重试政策 |
| 订阅标签 | 键 | labels | 通过标签报告使用量 |
| 订阅标签 | 值 | labels | 通过标签报告使用量 |
| 主题消息保留时长 | topicMessageRetentionDuration | 消息保留时长 | |
| 主题 KMS 密钥名称 | kmsKeyName | 使用客户管理的加密密钥 (CMEK) | |
| 授予 BigQuery 项目角色 | 默认情况下,系统会向默认 Pub/Sub 服务账号授予 BigQuery Metadata Viewer (roles/bigquery.metadataViewer) 和 BigQuery Data Editor (roles/bigquery.dataEditor) 角色。如果您不想授予这些角色,请清除该复选框。 |
向服务账号授予 IAM 角色 | |
| 授予 Token Creator 角色 | 默认情况下,系统会向默认 Pub/Sub 服务账号授予 Service Account Token Creator 角色。如果您不想授予此角色,请取消选中该复选框。 | 为 Pub/Sub 设置身份验证 | |
| 架构 | 名称 | name | 关于架构的重要信息 |
| 架构 | 类型 | type | 架构类型 |
| 架构 | 定义 | 定义 | 架构类型 |
| 架构 | 编码 | 编码 | 将架构与主题相关联的准则 |