From 95f2c069552e3da4387d5b5462dcd73645bf9c12 Mon Sep 17 00:00:00 2001 From: Chen Gu Date: Tue, 10 Mar 2026 00:47:51 +0800 Subject: [PATCH] docs(ops): add Docker+Colima sandbox baseline and resource profiles --- org/ops/SANDBOX_BASELINE_COLIMA.md | 80 ++++++++++++++++++++++++++++ org/ops/sandbox_profiles.colima.json | 23 ++++++++ 2 files changed, 103 insertions(+) create mode 100644 org/ops/SANDBOX_BASELINE_COLIMA.md create mode 100644 org/ops/sandbox_profiles.colima.json diff --git a/org/ops/SANDBOX_BASELINE_COLIMA.md b/org/ops/SANDBOX_BASELINE_COLIMA.md new file mode 100644 index 0000000..f128048 --- /dev/null +++ b/org/ops/SANDBOX_BASELINE_COLIMA.md @@ -0,0 +1,80 @@ +# Sandbox Baseline(Docker CLI + Colima) + +日期:2026-03-10 +状态:active + +## 1) 当前可用性检查(已通过) + +- Docker Client/Server: `29.3.0 / 29.2.1` +- Colima: running(QEMU / x86_64 / runtime=docker) +- Docker 引擎信息: + - driver: `overlayfs` + - cgroup: `cgroupfs` + - CPU: `2` + - Memory: `~3.0GB` +- 冒烟测试:`docker run --rm hello-world` 成功 + +## 2) 基线目标 + +用于后续 subagent 项目开发、构建、预览与部署演练,确保: +- 环境可复现 +- 资源可控 +- 日志可追溯 +- 故障可回滚 + +## 3) 资源基线(建议) + +- 默认 profile:`colima default` +- CPU:2(轻量项目)/ 4(构建型项目) +- Memory:3GB(轻量)/ 6GB(中型) +- Disk:>= 30GB + +> 若项目为前端+SSR或多容器编排,建议先升到 `4C / 6GB`。 + +## 4) 目录与挂载约定 + +- Workspace:`/Users/guchen/.openclaw/workspace` +- 项目容器挂载统一:`/workspace` +- 项目级缓存:放在项目内 `.cache/`(便于清理) + +## 5) 运行约束 + +- 禁止在沙箱内修改 OpenClaw 主配置 +- 生产密钥不得写入镜像层 +- 容器默认无特权模式(非必要不加 `--privileged`) + +## 6) 标准操作 + +### 启停 +```bash +colima start +colima stop +``` + +### 快速健康检查 +```bash +docker version +docker info +docker run --rm hello-world +``` + +### 项目运行(示例) +```bash +docker run --rm -it \ + -v /Users/guchen/.openclaw/workspace:/workspace \ + -w /workspace node:20 bash +``` + +## 7) 故障兜底 + +- Docker 命令异常:先 `colima status` 确认运行状态 +- Socket 异常:重启 Colima +- 镜像/层损坏: +```bash +docker system prune -f +``` + +## 8) 下一步 + +- 将 Val Blog 项目接入此基线(docker-compose + 一键预览) +- 增加项目级资源模板(light/medium/high) diff --git a/org/ops/sandbox_profiles.colima.json b/org/ops/sandbox_profiles.colima.json new file mode 100644 index 0000000..2941613 --- /dev/null +++ b/org/ops/sandbox_profiles.colima.json @@ -0,0 +1,23 @@ +{ + "version": "v1", + "profiles": { + "light": { + "cpu": 2, + "memoryGb": 3, + "diskGb": 30, + "useCase": "docs/static-site/small tools" + }, + "medium": { + "cpu": 4, + "memoryGb": 6, + "diskGb": 50, + "useCase": "frontend+api/multi-container dev" + }, + "high": { + "cpu": 6, + "memoryGb": 10, + "diskGb": 80, + "useCase": "build-heavy/parallel test workloads" + } + } +}