storytel/gcp-pubsub-emulator

Google Cloud PubSub Emulator

镜像概述和主要用途

一个轻量级容器，仅包含Google Cloud SDK中的PubSub模拟器，用于在本地环境中模拟Google Cloud Pub/Sub服务，支持开发和测试阶段无需连接实际云服务即可进行功能验证。

核心功能和特性

• 轻量级设计：仅包含PubSub模拟器核心组件，减少资源占用
• 灵活配置：支持通过命令行参数自定义主机、端口、IAM设置及项目列表
• 本地模拟：无需连接Google Cloud实际服务，降低开发测试成本
• 兼容性：与Google Cloud Pub/Sub API兼容，确保开发环境与生产环境一致性

使用场景和适用范围

• 本地开发：开发人员在本地环境调试Pub/Sub相关功能
• 单元测试：为依赖Pub/Sub服务的应用编写单元测试
• 集成测试：在CI/CD流程中提供模拟Pub/Sub服务环境
• 教学演示：学习Google Cloud Pub/Sub服务的本地实验环境

使用方法和配置说明

命令行选项

可直接通过命令行参数配置模拟器行为：

bash
docker run --rm storytel/gcp-pubsub-emulator --help

输出帮助信息包含以下选项：

• --help: 显示帮助信息并退出
• --host: 服务器绑定的主机地址（默认值：localhost）
• --port: 服务器运行的端口（需显式指定）
• --iam_host: IAM模拟器绑定的主机地址（默认值：localhost）
• --iam_port: IAM模拟器监听请求的端口（默认值：8090）
• --projects: 逗号分隔的有效项目名称列表（未指定时所有项目均有效）

部署示例

基本运行示例

后台运行模拟器并映射端口：

bash
docker run -d -p 8262:8262 storytel/gcp-pubsub-emulator --host=0.0.0.0 --port=8262

指定项目列表示例

限制仅允许特定项目访问：

bash
docker run -d -p 8262:8262 storytel/gcp-pubsub-emulator --host=0.0.0.0 --port=8262 --projects=my-project-1,my-project-2