Files
Agent-System-Dev/docker

Docker 测试环境镜像说明

用途与边界

本目录用于定义一个可重复构建的隔离测试环境镜像,供后续用该镜像启动一次性容器、挂载当前仓库做隔离测试。

  • 该镜像只提供测试运行环境,不包含仓库代码。
  • 该镜像不包含任何密钥、私钥或凭据。
  • 本仓正式交付流程仍以非容器化路径为准,此镜像仅用于辅助隔离测试。

构建与自检

在仓库根目录执行:

make image-build
make image-verify
  • make image-build:构建镜像 agent-system-test-env:dev。
  • make image-verify:运行镜像内环境自检脚本 /usr/local/bin/verify-env.sh。

启动测试容器示例

docker run -d --name asdev-test --shm-size=1g -p 127.0.0.1:2222:22 -v ~/.ssh/id_ed25519.pub:/home/dev/.ssh/authorized_keys:ro -v $PWD:/workspace agent-system-test-env:dev

说明:

  • authorized_keys 挂载源可以替换为任意可用的 .pub 公钥文件。
  • 容器内 SSH 登录用户为 dev。
  • dev 用户已配置 sudo 免密。

进入容器:

ssh -p 2222 dev@127.0.0.1

容器内最小测试流程

cd /workspace
make sync
cd modules/frontend
npm ci
npx playwright test

说明:镜像已内置 PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright 下的 Chromium,通常无需在容器内再次执行 playwright install。

安全说明

  • 容器内无密码登录,仅允许公钥认证。
  • 每个容器实例在启动时独立生成 SSH host key。
  • 不要将生产凭据、私钥或其他敏感文件带进容器。