40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
# 镜像仓库规则
|
|
|
|
执行发布前，从用户输入和当前项目文档中确定以下信息：
|
|
|
|
| 字段 | 要求 |
|
|
| --- | --- |
|
|
| Registry | 必须显式确定，例如 `registry.example.com` |
|
|
| Repository | 必须包含项目约定的 namespace，例如 `team/service` |
|
|
| Tag | 必须显式确定；优先使用版本号或 Git SHA |
|
|
| Platform | 必须显式确定，例如 `linux/amd64` 或 `linux/amd64,linux/arm64` |
|
|
| Dockerfile | 默认 `Dockerfile`，不存在或项目另有约定时明确指定 |
|
|
| Context | 默认当前项目根目录 |
|
|
|
|
## 信息来源优先级
|
|
|
|
1. 用户本次请求中明确给出的值。
|
|
2. 当前项目的 `AGENTS.md` 和发布文档。
|
|
3. `Makefile`、CI 配置、Compose 文件或现有构建脚本中一致且无歧义的配置。
|
|
4. 询问用户。
|
|
|
|
不要从其他项目、shell history 或无关的本地配置中猜测发布目标。
|
|
|
|
## 认证
|
|
|
|
使用 Docker 当前配置的 credential helper 或已有登录状态。可用不泄露凭据的只读操作检查目标是否可访问。认证缺失或过期时，停止并让用户自行完成登录。
|
|
|
|
不要读取、打印或复制以下内容：
|
|
|
|
- registry 密码或访问令牌
|
|
- `~/.docker/config.json` 中的认证字段
|
|
- CI secret 的值
|
|
- 包含凭据的环境变量值
|
|
|
|
## Tag 策略
|
|
|
|
- release tag（如 `v1.2.3`）默认视为不可变。
|
|
- Git SHA tag 应对应当前源 commit。
|
|
- `latest`、`stable` 等浮动 tag 只有在用户明确要求时才发布。
|
|
- 用户未给 tag 且项目没有唯一明确规则时，必须询问，不要自行选择。
|