Mockaco 镜像文档## 快速参考-获取帮助和提交问题：GitHub仓库

-维护者：natenho## 什么是 Mockaco？Mockaco 是一个基于HTTP的API模拟服务器，具有快速设置的特点，主要功能包括：

• 简单的基于JSON的配置
• 纯C#脚本 - 无需学***新的特定语言或API即可配置模拟
• 假数据生成 - 内置便捷的假数据生成功能
• 回调支持 - 当请求命中模拟API时触发另一个服务调用

如何使用此镜像### 运行演示默认镜像附带一个"hello"示例模拟：

$ docker run -it --rm -p 5000:5000 natenho/mockaco

可通过任何HTTP客户端访问Mockaco，地址为http://localhost:5000

$ curl -iX GET http://localhost:5000/hello/docker

HTTP/1.1 200 OK
Date: Wed, 21 Jun 2019 05:10:00 GMT
Content-Type: application/json
Server: Kestrel
Transfer-Encoding: chunked

{
	"message": "Hello docker!"
}

运行和创建自己的模拟使用此镜像的最佳方式是在主机系统（容器外部）创建一个目录，并将其挂载到容器内的/app/Mocks目录。

1. 在主机系统的合适卷上创建数据目录，例如/my/own/mockdir。
2. 如下启动mockaco容器：

$ docker run -it --rm -p 5000:80 -v /my/own/mockdir:/app/Mocks natenho/mockaco

命令中的-v /my/own/mockdir:/app/Mocks部分将主机系统的/my/own/mockdir目录挂载为容器内的/app/Mocks目录，Mockaco默认会在此处读取模拟JSON文件。

3. 在/my/own/mockdir文件夹下创建名为PingPong.json的请求/响应模板文件：

{
  "request": {
	"method": "GET",
	"route": "ping"
  },
  "response": {
	"status": "OK",
	"body": {
	  "response": "pong"
	}
  }
}

4. 发送请求并获取模拟响应，运行：

$ curl -iX GET http://localhost:5000/ping

HTTP/1.1 200 OK
Date: Wed, 21 Jun 2019 05:10:00 GMT
Content-Type: application/json
Server: Kestrel
Transfer-Encoding: chunked

{
	"response": "pong"
}

对于高级使用场景，如脚本编写和假数据生成，请参考文档。