jkris/mountebank

Mountebank Docker镜像

镜像概述和主要用途

Mountebank是一款用于分布式软件的进程外组件测试工具，是首个提供跨平台、多协议网络测试替身的开源工具。本Docker镜像用于运行Mountebank，可将被测应用指向Mountebank而非真实依赖，实现类似传统存根和模拟的测试效果。

核心功能和特性

• 跨平台支持：支持多种操作系统环境
• 多协议测试：提供多种协议的网络测试替身
• 进程外测试：作为独立进程运行，不侵入被测应用
• 灵活配置：通过配置文件定义测试替身（imposters）
• 多架构支持：最新镜像支持linux/amd64和linux/arm64架构

使用场景和适用范围

适用于分布式系统的组件测试，特别是需要模拟外部依赖（如API服务、数据库等）的场景。可用于单元测试、集成测试和系统测试阶段，帮助开发和测试团队在不依赖真实服务的情况下验证应用行为。

支持的Dockerfile链接

• https://github.com/jimmikristensen/mountebank-docker/blob/master/Dockerfile
• https://github.com/jimmikristensen/mountebank-docker/blob/2.4.0/Dockerfile
• https://github.com/jimmikristensen/mountebank-docker/blob/2.2.1/Dockerfile
• https://github.com/jimmikristensen/mountebank-docker/blob/2.0.0/Dockerfile
• https://github.com/jimmikristensen/mountebank-docker/blob/1.8.0/Dockerfile
• https://github.com/jimmikristensen/mountebank-docker/blob/1.5.1/Dockerfile

Docker Registry

所有可用镜像可在Docker Hub查看，最新镜像支持linux/amd64和linux/arm64多架构：
https://hub.docker.com/r/jkris/mountebank/tags

使用方法和配置说明

基本运行

运行最新版本的Mountebank，暴露默认管理端口2525：

bash
docker run -p 2525:2525 -d docker.xuanyuan.run/jkris/mountebank

启动后，访问http://localhost:2525可进入配置和操作界面。

自动加载测试替身（imposters）

若需自动加载测试替身，可挂载包含配置文件的卷并绑定必要端口：

bash
docker run \
    -v ./imposters:/imposters \
    [-p 测试替身端口1:测试替身端口1 ...] \
    -p 2525:2525 \
    -d jkris/mountebank \
    --configfile /imposters/imposters.ejs --allowInjection

Docker Compose配置

以下是使用Docker Compose的示例配置，包含一个Star Trek API测试替身：

yaml
version: "3"
services:
  mountebank:
    container_name: mountebank
    image: docker.xuanyuan.run/jkris/mountebank:latest
    volumes:
    - ./imposters:/imposters
    ports:
    - 2525:2525  # Mountebank管理页面端口
    - 8090:8090  # 测试替身端口
    command: --configfile /imposters/imposters.ejs --allowInjection

配置说明

• 挂载卷./imposters:/imposters：将本地测试替身配置目录映射到容器内
• 端口映射：2525为Mountebank管理端口，8090为测试替身使用的端口（需与测试替身配置中的port一致）
• 测试替身配置示例（imposters.ejs中）：

  json
  {
      "port": 8090,
      "protocol": "http",
      "stubs": [
          // 测试替身定义...
      ]
  }
  

运行和测试

启动服务：

bash
docker-compose up -d

测试测试替身：

bash
curl -X GET http://localhost:8090/api/v1/rest/series/search

提示

可修改stapi_imposter.ejs文件中的wait行为，调整测试替身响应的延迟时间。