- executor/Dockerfile 改多阶段:base 为基础镜像 M(长期不变,系统工具 + 预烘 Python 包);skills 阶段 = M + 技能系统层依赖(构建期跑各 install.sh,apt 等系统包持久且对命令只读)。build context 改为仓库根,用 .dockerignore 只放行 executor/ 与 skills/。 - 新增 agent-executor-init 一次性服务(executor/init-skills.js,与 core ensureDeps 同 hash/marker 格式):启动前把 requirements.txt(pip --target 共享 deps)与 install.sh 资产落到宿主 ./skills;只挂 ./skills、无特权、read_only,跑完退出;executor depends_on service_completed_successfully。 - 运行期 skills 仍 :ro;M 不变、skills 可变、命令写不了共享系统层,会话隔离保持。 - 实测:构建 stage 两个 install.sh 正常;init 幂等跳过/按需重跑(install.sh 与 pip 分支各验一次);executor 重建后 ReadonlyRootfs=true、/run tmpfs、core 到 executor 健康、run_skill 端到端正常。docs/ARCHITECTURE.md 与 skills/README.md 同步。
129 lines
5.6 KiB
YAML
129 lines
5.6 KiB
YAML
services:
|
||
agent-core:
|
||
build: ./app
|
||
container_name: agent-core
|
||
restart: unless-stopped
|
||
expose:
|
||
- "8080" # 仅内网暴露,由 nginx-proxy 对外
|
||
volumes:
|
||
- ./tasks:/workspace/tasks # 持久化:任务目录
|
||
- ./skills:/workspace/skills # 技能目录:所有任务/会话共享同一份技能
|
||
- ./data:/workspace/data # 持久化:数据目录
|
||
- ./config.yml:/app/config.yml # 允许设置页写配置(写前服务端会校验)
|
||
- ./app/server:/app/server
|
||
environment:
|
||
- PORT=8080
|
||
- AGENT_CONFIG=/app/config.yml
|
||
- VIRTUAL_HOST=agent.ai.foresh.com
|
||
- VIRTUAL_PORT=8080
|
||
- CERT_NAME=default
|
||
# 加入executor独立服务
|
||
- EXECUTOR_URL=http://agent-executor:9000
|
||
# 调用鉴权 token:两侧同一值。从 .env 读取(已 gitignore),不再硬编码进仓库;
|
||
# 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32
|
||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||
networks:
|
||
- my-app-network
|
||
- agent-internal
|
||
|
||
# 技能准备(一次性,跑完退出):把各技能的“运行期可变”依赖落到宿主 ./skills——
|
||
# requirements.txt → pip --target 共享 deps 目录;install.sh → 技能资产(如字体提取)。
|
||
# 系统层依赖(apt 等)不在这里做,由镜像的 skills 构建阶段烘进(才持久且对命令只读)。
|
||
# 只挂 ./skills(不挂 ./tasks),因此看不到任何会话数据;read_only 根 + tmpfs /tmp。
|
||
agent-executor-init:
|
||
build:
|
||
context: .
|
||
dockerfile: executor/Dockerfile
|
||
target: skills
|
||
image: agent-agent-executor-skills
|
||
container_name: agent-executor-init
|
||
restart: "no"
|
||
command: ["node", "init-skills.js"]
|
||
read_only: true
|
||
tmpfs:
|
||
- /tmp
|
||
volumes:
|
||
- ./skills:/workspace/skills
|
||
environment:
|
||
- HOME=/tmp
|
||
- TMPDIR=/tmp
|
||
- PYTHONDONTWRITEBYTECODE=1
|
||
- TZ=Asia/Shanghai
|
||
networks:
|
||
- agent-internal
|
||
|
||
agent-executor:
|
||
# M' = M + 技能系统层依赖(executor/Dockerfile 的 skills 阶段)。
|
||
# 管理员增删/改动 skills 后:docker compose build agent-executor 重建这层,M 不动。
|
||
build:
|
||
context: .
|
||
dockerfile: executor/Dockerfile
|
||
target: skills
|
||
image: agent-agent-executor-skills
|
||
container_name: agent-executor
|
||
restart: unless-stopped
|
||
depends_on:
|
||
agent-executor-init:
|
||
condition: service_completed_successfully
|
||
expose:
|
||
- "9000"
|
||
volumes:
|
||
# 核心变更:将宿主机 tasks 挂载到非标准路径 /mnt/host-tasks
|
||
# 目的:wrapper 启动时先 unmount 此路径,确保未经 wrapper 的进程无法访问其他 session 数据
|
||
- ./tasks:/mnt/host-tasks # 持久化:任务目录
|
||
- ./skills:/workspace/skills:ro # 技能目录:所有任务/会话共享同一份技能
|
||
environment:
|
||
- PORT=9000
|
||
# 与 agent-core 侧同一值,从 .env 读取(见 .env.example):
|
||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||
# 日志等级:debug|info|warn|error|none(默认 info);
|
||
# debug 会把与 core 的完整交互打印出来(请求、/exec 请求体、每条 SSE 帧、JSON 响应):
|
||
- EXECUTOR_LOG_LEVEL=info
|
||
# 防止 Python 在 skills 目录生成 __pycache__
|
||
- PYTHONDONTWRITEBYTECODE=1
|
||
# 定义隔离基路径,server.js 需读取此变量以执行 umount 和 bind mount
|
||
- EXECUTOR_ISOLATION_BASE=/mnt/host-tasks
|
||
|
||
# 资源限制:兜住 AI 失控命令(烧 CPU / 吃内存 / fork 炸弹 / 写盘撞满宿主机磁盘)。cgroup/ulimit 随 fork 继承。
|
||
# 这些是性能/容量护栏,不限制可调用的 syscall;执行能力由下方 cap_add/security_opt 控制。
|
||
cpus: "2.0" # 容器整体最多用 2 核(超出限流不杀进程),按宿主机核数调整
|
||
mem_limit: 2g # 内存失控 → 容器被 OOM kill(restart 策略自动拉起,代价是该容器内所有在执行命令随容器重启丢失)
|
||
pids_limit: 512 # 进程+线程总数上限,防 fork 炸弹耗尽宿主机进程表
|
||
ulimits:
|
||
# 单文件最大 2G(字节,RLIMIT_FSIZE):dd/cat /dev/urandom 写巨型文件超限即被内核 SIGXFSZ 杀掉,
|
||
# 对 bind 卷上的写入同样生效(内核层限制,与文件系统无关)。
|
||
# 只限单文件不限总占用量,“大量文件堆满磁盘”需宿主机侧配额(xfs project quota / 独立分区)兜底。
|
||
fsize:
|
||
soft: 2147483648
|
||
hard: 2147483648
|
||
|
||
# 安全加固:显式丢弃所有能力,仅保留必要的 SYS_ADMIN
|
||
cap_drop:
|
||
- ALL
|
||
cap_add:
|
||
- SYS_ADMIN
|
||
security_opt:
|
||
# 禁止提权(SUID/SGID 失效),防止通过二进制漏洞获取更高权限
|
||
- no-new-privileges:true
|
||
# 实测 Docker 29 (Ubuntu) 需 unconfined 才能使用 mount/unshare 系统调用
|
||
- apparmor=unconfined
|
||
|
||
# 根文件系统只读:AI 命令无法往镜像层(/usr、/root 等)写文件做持久化/篡改;
|
||
# 合法写盘另走 tmpfs 与 bind 卷(handleExec 已把 HOME/TMPDIR 指向 /tmp)。
|
||
read_only: true
|
||
tmpfs:
|
||
- /tmp
|
||
- /var/tmp
|
||
# /run 必须可写:隔离 wrapper 要在 /run/agent-exec 下建私有 anchor/rundir,
|
||
# 否则 read_only 下 mkdir 报 EROFS,每条命令直接中断。
|
||
- /run
|
||
|
||
networks:
|
||
- agent-internal
|
||
|
||
networks:
|
||
my-app-network:
|
||
external: true
|
||
agent-internal:
|
||
driver: bridge
|