nandess/pact_broker-docker

Pact Broker Docker镜像

镜像概述

Pact Broker是一款用于管理微服务间契约的工具，本镜像将其Docker化，便于快速部署和集成到团队工作流中。它帮助团队在微服务架构下验证服务接口变更的兼容性，避免集成问题。

核心功能

• 多数据库支持：兼容PostgreSQL（推荐）、MySQL和SQLite数据库
• 基本认证：区分读写与只读权限，保障契约数据安全
• 灵活配置：支持日志级别调整、Webhook白名单管理及公开心跳URL
• SSL适配：可配合反向代理实现HTTPS访问
• 徽章集成：验证状态徽章无需认证，可直接嵌入文档

使用场景

• 微服务团队管理服务间契约，跟踪接口变更历史
• CI/CD流程中自动验证契约一致性，防止破坏性更新
• 嵌入验证状态徽章到项目文档，直观展示契约健康度

配置说明

数据库配置

认证配置

• PACT_BROKER_BASIC_AUTH_USERNAME：读写权限用户名
• PACT_BROKER_BASIC_AUTH_PASSWORD：读写权限密码
• PACT_BROKER_BASIC_AUTH_READ_ONLY_USERNAME：只读权限用户名
• PACT_BROKER_BASIC_AUTH_READ_ONLY_PASSWORD：只读权限密码

其他配置

• PACT_BROKER_LOG_LEVEL：日志级别（DEBUG/INFO/WARN/ERROR/FATAL）
• PACT_BROKER_WEBHOOK_HOST_WHITELIST：Webhook允许的主机列表（空格分隔，支持正则）
• PACT_BROKER_PUBLIC_HEARTBEAT：开启公开心跳URL（true/false）

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -e PACT_BROKER_DATABASE_ADAPTER=postgres \
  -e PACT_BROKER_DATABASE_USERNAME=pact \
  -e PACT_BROKER_DATABASE_PASSWORD=pactpass \
  -e PACT_BROKER_DATABASE_HOST=postgres \
  -e PACT_BROKER_DATABASE_NAME=pact_db \
  nandess/pact_broker-docker

Docker Compose示例

yaml
version: '3'
services:
  pact-broker:
    image: nandess/pact_broker-docker
    ports:
      - "80:80"
    environment:
      PACT_BROKER_DATABASE_ADAPTER: postgres
      PACT_BROKER_DATABASE_USERNAME: pact
      PACT_BROKER_DATABASE_PASSWORD: pactpass
      PACT_BROKER_DATABASE_HOST: postgres
      PACT_BROKER_DATABASE_NAME: pact_db
  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: pact
      POSTGRES_PASSWORD: pactpass
      POSTGRES_DB: pact_db
    volumes:
      - postgres-data:/var/lib/postgresql/data
volumes:
  postgres-data:

访问地址：http://localhost（浏览器或curl均可）

sh
curl http://localhost