fluentthinking/gcloud-pubsub-emulator

容器化Google Cloud Pub/Sub模拟器

镜像概述

该镜像提供容器化的Google Cloud Pub/Sub模拟器，基于alpine Linux构建（体积约260MB，远小于完整gcloud SDK镜像），是对https://github.com/thinkfluent/pubsubc项目的封装，用于本地开发测试PubSub相关应用，无需连接真实Google Cloud服务。

核心功能

• 提供Pub/Sub模拟器服务，支持本地开发验证
• 通过环境变量或Docker标签自动创建主题和订阅
• 支持自定义PubSub服务端口（默认8681）和就绪检查端口（默认8682）
• 允许信任自签名证书，适配安全端点推送场景
• 提供就绪检查机制，便于控制依赖服务启动顺序

使用场景

• 本地开发PubSub相关应用，快速验证功能逻辑
• 集成到Docker Compose环境，模拟云服务环境
• 测试推送/拉取订阅功能，避免依赖真实云资源

配置说明

安装与运行

预构建镜像直接运行

bash
docker run --rm -ti -p 8681:8681 docker.xuanyuan.run/fluentthinking/gcloud-pubsub-emulator:latest

本地构建并运行

bash
docker build -t gcloud-pubsub-emulator:latest --platform=linux/amd64 .
docker run --rm -ti -p 8681:8681 docker.xuanyuan.run/gcloud-pubsub-emulator:latest

基础使用

启动模拟器后，设置应用的PUBSUB_EMULATOR_HOST环境变量指向模拟器：

bash
PUBSUB_EMULATOR_HOST=localhost:8681

自动创建主题和订阅

环境变量配置示例

dotenv
PUBSUB_PROJECT1=project-name,topic1,topic2:subscription1~300:subscription2
PUBSUB_PROJECT2=project-two,topicA,topicB:subscriptionX:subscriptionY
PUBSUB_PROJECT3=project-name,topic:push-subscription+myapp/endpoint
PUBSUB_PROJECT4=project-name,topic4:push-subs-with-deadline~120+myapp/endpoint

Docker标签配置示例（Docker Compose）

yaml
services:
  myapp:
    image: docker.xuanyuan.run/busybox:latest
    environment:
      - PUBSUB_EMULATOR_HOST=pubsub-emulator:8681
    labels:
      - 'pubsubc.config1=project-one,topic1,topic2:subscription1~300:subscription2'
      - 'pubsubc.config2=project-two,topic:push-subscription+endpoint'

就绪检查

• 未使用PUBSUB_PROJECT时，检查端口8681是否可用
• 使用PUBSUB_PROJECT时，检查端口8682（主题订阅创建完成后就绪）

端口配置

可通过环境变量或端口映射修改默认端口：

yaml
services:
  pubsub-emulator:
    image: docker.xuanyuan.run/fluentthinking/gcloud-pubsub-emulator:latest
    ports:
      - '8085:8681'
      - '8086:8682'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

信任自签名证书

挂载根证书目录到容器指定路径：

yaml
services:
  pubsub-emulator:
    image: docker.xuanyuan.run/fluentthinking/gcloud-pubsub-emulator:latest
    ports:
      - '8085:8681'
      - '8086:8682'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /path/to/root/certs/:/usr/local/share/ca-certificates/

版本详情