misaksen/octopus-pact-worker

镜像概述

该Docker镜像为Octopus环境提供容器化的Pact CLI执行环境，支持在Octopus部署流程中运行Pact CLI命令，实现契约测试、契约发布等Pact相关操作的容器化执行，确保环境一致性并简化集成流程。

核心功能与特性

• 完整Pact CLI支持：集成标准Pact CLI工具，可执行所有Pact命令（如契约验证、发布、 pact-broker操作等）
• Octopus环境兼容：针对Octopus部署流程优化，可无缝集成到Octopus管道中
• 环境一致性：容器化运行避免依赖冲突，确保不同环境中Pact命令执行结果一致
• 轻量级设计：基于官方Pact CLI基础镜像构建，资源占用低，启动速度快

使用场景

• Octopus CI/CD流程：在部署管道中集成契约测试环节，验证服务间契约一致性
• 契约自动化管理：自动发布Pact契约至Pact Broker，或执行契约查询、清理等管理操作
• 隔离环境执行：在隔离容器中运行Pact命令，避免对Octopus主机环境造成影响
• 跨平台兼容：在不同操作系统的Octopus环境中提供统一的Pact CLI执行方式

使用方法与配置说明

基本使用格式

通过docker run命令在Octopus环境中执行Pact CLI命令，基本语法：

bash
docker run --rm [选项] [镜像名称] [Pact CLI命令]

常用操作示例

1. 验证契约

挂载本地契约文件并执行验证：

bash
docker run --rm \
  -v /octopus/workspace/pact:/pact \  # 挂载契约文件目录
  octopus-pact-cli:latest \           # 镜像名称
  pact verify \                       # Pact CLI命令
    --provider-base-url=http://provider-service \  # 服务提供者URL
    --pact-url=/pact/consumer-provider.json        # 契约文件路径

2. 发布契约至Pact Broker

设置Pact Broker认证信息并发布契约：

bash
docker run --rm \
  -e PACT_BROKER_BASE_URL=https://pact-broker.example.com \  # Pact Broker地址
  -e PACT_BROKER_TOKEN=your-auth-token \                     # 认证令牌
  -v /octopus/workspace/pact:/pact \                         # 挂载契约文件
  octopus-pact-cli:latest \
  pact publish /pact/consumer-provider.json \                # 发布命令
    --consumer-app-version=1.2.3 \                           # 消费者版本
    --tag=production                                         # 标签

关键配置参数

与Octopus集成建议

1. 在Octopus部署流程中添加"Run a Docker Container"步骤
2. 配置镜像名称及版本（如octopus-pact-cli:latest）
3. 在"Command"字段填写Pact CLI命令（如pact verify --provider-base-url=...）
4. 通过Octopus变量管理敏感信息（如Pact Broker令牌），并映射为环境变量
5. 使用Octopus工作目录挂载功能，将契约文件传递至容器内