unfoldedcircle/core-simulator

Unfolded Circle API核心模拟器镜像

镜像概述

Unfolded Circle API核心模拟器是一个专为开发场景设计的工具镜像，旨在模拟Unfolded Circle API核心服务的功能。它允许开发者在不依赖实际硬件设备或后端服务的情况下，进行应用程序的开发、测试和调试，有效降低开发环境搭建复杂度，提升开发效率。

核心功能和特性

• API模拟：模拟Unfolded Circle API核心服务的主要端点和接口，支持标准API请求处理
• 数据模拟：可返回预设的模拟数据，模拟不同业务场景下的API响应
• 开发友好：提供灵活的配置选项，支持自定义模拟行为
• 轻量级：镜像体积小巧，启动快速，适合本地开发和CI/CD环境集成

使用场景和适用范围

• 应用开发：开发基于Unfolded Circle API的客户端应用时，作为后端服务替代品
• 功能测试：验证应用程序对API不同响应的处理逻辑
• 集成测试：在CI/CD流程中模拟API服务，进行自动化测试
• 学习研究：了解Unfolded Circle API交互方式和数据结构

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d -p 8080:8080 --name uc-api-simulator unfoldedcircle/api-core-simulator

上述命令将启动模拟器容器，映射容器的8080端口到主机的8080端口，可通过http://localhost:8080访问API服务。

环境变量配置

自定义模拟数据

1. 准备自定义模拟数据文件（JSON格式）
2. 通过挂载卷的方式将数据文件目录映射到容器：

bash
docker run -d -p 8080:8080 -v /path/to/your/data:/app/data --name uc-api-simulator unfoldedcircle/api-core-simulator

Docker Compose配置示例

yaml
version: '3'
services:
  uc-api-simulator:
    image: unfoldedcircle/api-core-simulator
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=debug
      - SIMULATE_DELAY=200
    volumes:
      - ./simulator-data:/app/data
    restart: unless-stopped

验证服务

服务启动后，可通过以下命令验证API是否可用：

bash
curl http://localhost:8080/api/health

成功响应应返回类似{"status": "ok", "service": "uc-api-simulator"}的健康状态信息。