pactfoundation/pact-mock-service

Pact Mock Service Docker镜像文档

镜像概述

Pact Mock Service Docker镜像是运行Pact模拟服务的容器化解决方案，可从https://hub.docker.com/r/pactfoundation/pact-mock-service%E6%8B%89%E5%8F%96%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7%E3%80%81%E5%8F%AF%E7%A7%BB%E6%A4%8D%E7%9A%84Pact%E6%A8%A1%E6%8B%9F%E6%9C%8D%E5%8A%A1%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E5%A5%91%E7%BA%A6%E6%B5%8B%E8%AF%95%E4%B8%AD%E6%A8%A1%E6%8B%9F%E6%9C%8D%E5%8A%A1%E6%8F%90%E4%BE%9B%E8%80%85%EF%BC%8C%E6%94%AF%E6%8C%81%E6%B6%88%E8%B4%B9%E8%80%85%E7%8B%AC%E7%AB%8B%E8%BF%9B%E8%A1%8C%E6%8E%A5%E5%8F%A3%E6%B5%8B%E8%AF%95%E3%80%82

核心功能和特性

• 模拟服务提供者：能够模拟服务提供者的API接口，返回预定义响应
• 契约定义支持：允许通过API请求定义消费者与提供者之间的契约
• 契约文件生成：可生成符合Pact规范的契约文件，用于后续验证
• 容器化部署：基于Docker容器，部署简单，确保环境一致性

使用场景

• 微服务开发中，服务提供者未就绪时，消费者可使用模拟服务进行独立测试
• 消费者驱动契约测试（CDC）流程中，作为模拟服务提供者的核心组件
• 持续集成/持续部署（CI/CD）流水线中，集成契约测试步骤

使用方法

基本部署

通过docker-compose启动服务：

shell
$ docker-compose up

验证服务运行状态

根据Docker运行环境获取容器IP：

• Docker native（本地直接运行Docker）：使用localhost
• Docker Machine：通过以下命令获取IP

shell
$ DOCKER_CONTAINER_IP=$(docker-machine ip default)

发送请求验证服务是否正常运行：

shell
$ curl -H "X-Pact-Mock-Service: true" http://${DOCKER_CONTAINER_IP}

获取契约内容

通过POST请求生成并获取契约内容：

shell
$ curl -X POST \
  -H "X-Pact-Mock-Service: true" \
  -H "Content-Type: application/json" \
  -d '{"consumer": {"name": "消费者名称"}, "provider": {"name": "提供者名称"}}' \
  http://${DOCKER_CONTAINER_IP}/pact

其他命令示例

更多使用命令示例，请参考https://github.com/pact-foundation/pact-mock_service/blob/master/script/example.sh%E3%80%82