Docker Compose

Docker Compose 是在单机上运行当前多仓库 Monkeys 栈的最快方式。首次完整启动请从 从 0 到 1 部署 开始。

Compose 结构

Monkeys 现在使用两层本地 compose：

• monkeys/docker/infrastructure：PostgreSQL、Redis、Elasticsearch、Conductor、MinIO、Prometheus、Grafana。
• monkeys/docker/services：核心产品服务和可选能力 profile。

服务 compose 文件要求产品仓库和 monkeys 放在同级目录。

启动共享基础设施

cd monkeys/docker/infrastructure
docker compose up -d

启动核心服务

cd monkeys/docker/services
docker compose up -d --build

默认 profile 需要这些仓库和 monkeys 放在同级目录：

• monkeys-server
• monkeys-studio
• monkeys-kernel
• monkeys-compute

默认端点：

可选 profiles

需要额外能力服务时，可以启动对应 profile：

docker compose --profile agent up -d --build
docker compose --profile billing up -d --build
docker compose --profile data up -d --build
docker compose --profile webhook up -d --build
docker compose --profile mcp up -d --build
docker compose --profile worker up -d --build
docker compose --profile tools up -d --build

典型流程

1. 启动基础设施。
2. 启动核心服务。
3. 打开 Studio 创建或导入工作流。
4. 需要时通过 manifest 或 OpenAPI 导入外部工具。
5. 通过 UI 或 OpenAI 兼容 API 验证工作流。

排障

• 如果服务无法解析 postgres、redis 或 conductor-server，确认基础设施栈已经创建外部 monkeys 网络。
• 如果服务镜像构建失败，确认需要的兄弟仓库存在于预期路径。
• 如果 Studio 无法调用后端，确认服务端口映射和前端运行时 endpoint 配置。

停止

cd monkeys/docker/services
docker compose down
cd ../infrastructure
docker compose down