Docker 项目交给 AI 前，端口、卷、环境变量和健康检查怎么说明

先把容器运行契约写清

端口、卷、环境变量、启动命令、健康检查和服务依赖决定容器能否运行和保存数据。只给 Dockerfile 而不说明外部条件，AI 很容易改坏持久化或暴露错误端口。

镜像与命令

写基础镜像、目标架构、构建上下文、启动命令和非 root 用户要求。

把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。

端口与网络

区分容器监听端口、宿主映射、服务名和外部入口，说明是否经过代理。

确认“端口与网络”已经有可回查结果，再进入“卷与数据”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

卷与数据

标持久化目录、只读挂载、初始化和备份；明确删除容器是否应保留数据。

确认“卷与数据”已经有可回查结果，再进入“变量与密钥”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

变量与密钥

列名称、来源、必填、默认和重启影响，不把生产值放进 Compose 或镜像层。

确认“变量与密钥”已经有可回查结果，再进入“健康与依赖”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

健康与依赖

健康检查使用真实就绪条件，依赖服务有超时和重试；启动顺序不替代可用性判断。

需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“容器运行契约”。

在干净环境重建一次

从无缓存构建、启动、健康、重启和恢复数据，记录命令与日志。只在开发机已有卷和缓存下成功不能验收。