# Docker 测试环境镜像说明

## 用途与边界

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

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

## 构建与自检

在仓库根目录执行：

```bash
make image-build
make image-verify
```

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

## 启动测试容器示例

```bash
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 免密。

进入容器：

```bash
ssh -p 2222 dev@127.0.0.1
```

## 容器内最小测试流程

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

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

## 安全说明

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