soluto/simple-fake-server

simple-fake-server镜像说明

镜像概述

本镜像为soluto/simple-fake-server的容器化版本，是一款轻量级模拟服务器工具，用于在开发和测试场景中快速搭建模拟API服务，支持模拟接口的创建、查询与清除操作，帮助开发者隔离外部依赖，验证服务交互逻辑。

核心功能

• 创建模拟接口：通过POST请求定义模拟API的方法、URL、响应内容及状态码。
• 查询调用情况：通过GET请求查看指定模拟接口是否被调用。
• 清除模拟数据：通过POST请求清除所有已创建的模拟接口。

使用场景

• 开发阶段：模拟第三方服务或未实现的内部接口，加速开发流程。
• 测试阶段：验证服务对外部接口的调用逻辑，确保测试用例独立性。
• 集成测试：隔离依赖的外部服务，避免测试受外部环境影响。

配置说明

支持通过环境变量配置端口：

• ADMIN_PORT：管理端口（默认3000，用于执行模拟管理操作）。
• PORT：模拟接口端口（默认2000，用于接收模拟API请求）。

部署示例

Docker Compose部署

yaml
my-api:
  build: .
  environment:
    - OTHER_API_URL=http://fake-server:2000  # 指向模拟服务器接口端口
  ports:
    - '3000:3000'
fake-server:
  image: soluto/simple-fake-server:latest
  ports:
    - '3001:3000'  # 映射管理端口到本地3001

测试示例

js
const axios = require('axios');

describe('测试示例', () => {
  afterEach(async () => await axios.post('http://localhost:3001/fake_server_admin/clear'));

  it('验证服务调用模拟接口', async () => {
    const { data: { callId } } = await axios.post('http://localhost:3001/fake_server_admin/calls', {
      method: "get",
      url: 'api/v1/keys/foo',
      response: JSON.stringify("bar"),
      respondAsJson: true,
      statusCode: 200
    });

    await axios.post('http://localhost:3000/action');
    const { data: { hasBeenMade } } = await axios.get(`http://localhost:3001/fake_server_admin/calls?callId=${callId}`);
    
    expect(hasBeenMade).to.eq(true);
  });
});