配置 Pub/Sub 主题和订阅

Pub/Sub 是一种异步且可伸缩的通讯服务，可将生成消息的服务与处理这些消息的服务分离开来。如需了解详情，请参阅什么是 Pub/Sub？

本文档介绍了使用应用设计中心创建 Pub/Sub 主题和订阅时可以配置的连接和参数。配置参数基于 terraform-google-pubsub Terraform 模块。

组件连接

下表列出了可连接到 Pub/Sub 主题或订阅的组件，以及对应用及其生成的 Terraform 代码的相应更新。

关联的组成部分

申请动态

背景信息

Compute Engine 实例模板
  • Compute Engine 实例可以向 Pub/Sub 主题发布消息，也可以从该主题接收消息。
  • Pub/Sub 主题 ID 已添加到 Compute Engine 实例模板元数据中。
 实例模板

服务账号
  • 服务账号可以管理 Pub/Sub 主题，并从订阅中提取消息。
  • roles/pubsub.editor 角色已添加到服务账号。
  • 服务账号名称和电子邮件地址信息已添加到 Pub/Sub 拉取订阅中。
 使用 IAM 进行访问权限控制

BigQuery
  • Pub/Sub 订阅可以将消息写入 BigQuery 数据集。
  • BigQuery 数据集信息会添加到 BigQuery 订阅字段中。
 BigQuery 订阅

Cloud Run
  • Cloud Run 服务可以接收消息或发布到 Pub/Sub 主题。
  • Pub/Sub 主题 ID 已添加到 Cloud Run 环境变量中。
  • roles/pubsub.publisher 和 roles/pubsub.subscriber 角色已添加到 Cloud Run 服务账号。
  • Cloud Run 服务已添加到 Pub/Sub 推送和拉取订阅字段中。
 教程：将 Pub/Sub 与 Cloud Run 搭配使用

Cloud Storage
  • Pub/Sub 订阅可以将消息写入 Cloud Storage 存储桶。
  • Cloud Storage 存储桶信息已添加到 Pub/Sub 订阅字段中。
 Cloud Storage 订阅

必需的配置参数

如果您的模板包含 Pub/Sub 组件，则必须先配置以下参数，然后才能进行部署。

参数名称

说明和限制

背景信息

项目 ID

您要部署 Pub/Sub 资源的项目。

 配置组件

主题

 name 主题、订阅、架构或快照命名指南

可选配置参数

以下参数为可选参数。如需显示高级参数，请在配置区域中选择显示高级字段。

功能

参数名称

说明和限制条件信息

背景信息
创建主题 默认情况下，系统会创建一个主题。如果您不想创建主题，请清除该复选框。 创建主题
创建订阅 默认情况下，系统会创建订阅。如果您不想创建订阅，请清除该复选框。 订阅概览

主题标签

 键 labels 通过标签报告使用量
值 labels 通过标签报告使用量

推送订阅

 名称 name 主题、订阅、架构或快照命名指南
确认时限（以秒为单位） ackDeadlineSeconds 确认截止期限
推送端点 pushEndpoint Endpoints
X-goog-version 推送消息的 Pub/Sub API 格式。例如，v1beta1。 属性
OIDC 服务账号电子邮件地址 serviceAccountEmail Authentication
受众群体 受众群体 Authentication
失效政策 expirationPolicy 有效期
死信主题 deadLetterTopic 死信主题
保留已确认的消息 retainAckedMessages 保留已确认的消息
消息保留时长 messageRetentionDuration 消息保留时长
传送尝试次数上限 maxDeliveryAttempts 死信主题
退避时间上限 maximumBackoff 重试政策
最短退避时间 minimumBackoff 重试政策
过滤 filter 订阅过滤条件
启用消息排序 enableMessageOrdering 消息排序

拉取订阅

 名称 name 主题、订阅、架构或快照命名指南
确认时限（以秒为单位） ackDeadlineSeconds 确认截止期限
死信主题 deadLetterTopic 死信主题
传送尝试次数上限 maxDeliveryAttempts 死信主题
保留已确认的消息 retainAckedMessages 保留已确认的消息
消息保留时长 messageRetentionDuration 消息保留时长
退避时间上限 maximumBackoff 重试政策
最短退避时间 minimumBackoff 重试政策
过滤 filter 订阅过滤条件
启用消息排序 enableMessageOrdering 消息排序
服务账号
启用“仅传送一次” enableExactlyOnceDelivery 仅传送一次

BigQuery 订阅

 名称 name