pactfoundation/pact-stub-server

Pact Stub Server Docker镜像文档

镜像概述和主要用途

Pact Stub Server Docker镜像是一个从本地或远程Pact文件运行存根服务器的工具，主要用于自动化项目的外部API依赖。通过该镜像，用户可以快速创建模拟API服务，避免在开发或测试过程中依赖真实外部API。

Docker镜像地址：https://hub.docker.com/r/pactfoundation/pact-stub-server/

核心功能和特性

• 支持从一个或多个本地或远程Pact文件启动存根服务器
• 提供API端点模拟功能，模拟外部API的响应
• 轻量级部署，通过Docker容器快速启动和配置

使用场景和适用范围

• 开发阶段：模拟外部API依赖，无需等待真实API就绪
• 测试环境：隔离外部依赖，确保测试的稳定性和一致性
• 自动化测试：作为集成测试中的模拟服务，验证API交互逻辑

使用方法和配置说明

前提条件

• 已安装Docker环境
• 拥有Pact文件（本地文件或远程URL）

可用CLI选项

完整的命令行选项可参考项目GitHub地址：https://github.com/uglyog/pact-stub-server

常用参数说明：

• -p <port>: 指定存根服务器监听端口（默认可能为8080）
• -d <directory>: 指定本地Pact文件所在目录

部署示例

1. 创建存根API

sh
# 拉取镜像
docker pull pactfoundation/pact-stub-server

# 运行容器（挂载本地pacts目录，指定端口8080）
docker run -t -p 8080:8080 -v "$(pwd)/pacts/:/app/pacts" pactfoundation/pact-stub-server -p 8080 -d pacts

2. 测试存根端点

sh
# 测试存根API端点（根据Docker环境获取主机IP）
# 若使用docker-machine，获取当前活跃主机IP
curl -v $(docker-machine ip $(docker-machine active)):8080/bazbat

# 测试另一个端点
curl -v $(docker-machine ip $(docker-machine active)):8080/foobar

# 若直接在本地Docker环境（如Linux或Docker Desktop），可使用localhost
curl -v localhost:8080/bazbat
curl -v localhost:8080/foobar

注意：docker-machine ip命令适用于使用docker-machine管理Docker主机的场景，现代Docker Desktop环境通常可直接使用localhost访问容器端口。