ehacke/pubsub-emulator

Google Cloud Pub/Sub模拟器镜像

镜像概述

本镜像为Google Cloud Pub/Sub模拟器的容器化实现，旨在提供独立的本地测试环境，让开发者无需连接生产环境即可模拟Pub/Sub服务功能，适用于应用开发与测试阶段。

核心功能

1. 模拟Google Cloud Pub/Sub的基础消息发布与订阅能力
2. 支持通过环境变量配置监听地址与项目ID
3. 内置start-pubsub初始化脚本（已加入系统PATH）
4. 提供持久化存储能力，保持容器重启后的状态

使用场景

• 开发者本地验证依赖Pub/Sub的应用逻辑
• CI/CD流程中的集成测试环节，确保应用与Pub/Sub交互正常
• 团队协作时搭建统一测试环境，保障环境一致性

配置说明

必要环境变量

需设置以下环境变量启动模拟器：

• PUBSUB_LISTEN_ADDRESS：监听地址，格式为HOST:PORT（如0.0.0.0:8432），容器需暴露对应端口
• PUBSUB_PROJECT_ID：模拟器使用的Google Cloud项目ID

应用连接配置

应用需设置以下环境变量以连接模拟器（替代生产环境）：

• PUBSUB_EMULATOR_HOST：模拟器监听地址
• PUBSUB_PROJECT_ID：与模拟器一致的项目ID

Docker Compose部署示例

以下是快速搭建模拟器的Docker Compose配置：

yaml
version: "2"

services:
  pubsub:
    image: ehacke/pubsub-emulator
    environment:
      - PUBSUB_PROJECT_ID=project-test
      - PUBSUB_LISTEN_ADDRESS=0.0.0.0:8432
    ports:
      - "8432:8432"

持久化设置

镜像已挂载/opt/data目录，若需保留状态，可在部署时将本地卷挂载至该路径。

yaml
# 持久化示例（在上述Compose配置中添加volumes）
volumes:
  - ./pubsub-data:/opt/data