ttsnap/mountebank-on-alpine-amd64-for-openshift

mountebank v2.9.1 Docker镜像文档

镜像概述

本镜像基于Alpine 3.23.0构建，集成mountebank v2.9.1（一款开源API模拟工具），旨在提供轻量级、可移植的API模拟服务。支持在OpenShift 4环境中运行，通过暴露2525端口对外提供API模拟能力，适用于开发、测试阶段模拟第三方API或依赖服务。

核心功能与特性

• 轻量级基础：基于Alpine 3.23.0，镜像体积小，资源占用低
• 指定版本：集成mountebank v2.9.1，确保API模拟功能稳定性
• API模拟能力：支持HTTP、HTTPS、TCP等多种协议的API模拟，可定义请求响应规则
• 端口暴露：默认暴露2525端口，为mountebank服务通信端口
• 进程与日志管理：启动时自动生成进程PID文件（/tmp/mb.pid）和日志文件（/tmp/logfile.txt），便于服务监控与调试

使用场景

• 开发环境依赖模拟：前端或服务端开发时，模拟未就绪的第三方API或下游服务
• API测试验证：测试阶段模拟异常响应（如超时、错误码），验证系统容错能力
• 契约测试支持：配合契约测试工具（如Pact），模拟服务契约定义的交互行为
• OpenShift环境适配：兼容OpenShift 4平台，可直接部署用于容器化环境的API模拟

使用方法与配置说明

基本运行命令

通过以下命令启动镜像，映射2525端口至本地：

bash
docker run -d -p 2525:2525 --name mountebank-simulator [镜像名称]

挂载日志文件（可选）

如需持久化日志，可挂载日志文件目录：

bash
docker run -d -p 2525:2525 -v /本地路径/logfile.txt:/tmp/logfile.txt --name mountebank-simulator [镜像名称]

自定义启动参数（可选）

默认启动命令为mb start --pidfile /tmp/mb.pid --logfile /tmp/logfile.txt，可通过command覆盖启动参数，例如修改日志级别：

bash
docker run -d -p 2525:2525 --name mountebank-simulator [镜像名称] mb start --pidfile /tmp/mb.pid --logfile /tmp/logfile.txt --loglevel debug

环境变量说明

注：该环境变量主要用于构建阶段指定版本，运行时修改无效。

服务验证

启动后，可通过访问http://localhost:2525验证服务是否运行（mountebank默认提供管理API）。

注意事项

• 本镜像基于Alpine，需确保运行环境支持Alpine基础镜像依赖
• 如需自定义mountebank配置（如模拟规则），可通过mountebank的REST API或配置文件挂载实现（参考mountebank官方文档）
• OpenShift 4环境部署时，需确保2525端口在项目网络策略中允许访问