// LATEST

Compose 的 .env 有两种用途,镜像里又是第三个配置现场

部署中最容易混淆的是:Compose 用来替换 YAML 变量的 .env,与注入容器进程环境的 env_file,并不是同一个动作。这个项目同时使用了两者。

先区分解析时与运行时

Compose 的 ${CELLPOSE_BIND_HOST} 等占位符在解析配置时展开,决定端口、构建参数和设备预留;服务中的 env_file: ./.env 则把值注入运行容器。只满足其中一边,不代表另一边也正确。

Dockerfile 把模型目录作为构建参数使用,创建目录并设置用户权限;运行命令依赖容器环境中的 host、port 与 workers。模型目录若改了,构建参数、挂载目标与运行环境都要一致。

镜像里没有默认模板

Dockerfile 仅复制应用、健康脚本和配置模块等文件,没有复制 .env.example;.env 也在构建忽略列表中。因此容器内配置加载不能指望靠同目录模板兜底,部署需要通过环境提供所需键。

这通常有利于避免把秘密烘焙进镜像,但也要求部署配置完整。健康脚本所需 URL 与超时同样要存在,不是主程序能启动就代表探针一定能运行。

非 root 用户与模型卷

镜像创建 app 用户并切换身份,模型目录预先授权。首次创建命名卷与已有卷的权限状态可能不同,迁移卷或修改目录后应验证实际读写,而不是只看镜像层的 chown。

构建参数:决定镜像内目录准备
Compose 插值:决定容器规格
容器环境:决定应用实际行为
持久卷:带来独立的文件与权限状态

上线检查顺序

先在受控终端核对解析后的 Compose 配置,输出可能包含密钥,不能直接公开粘贴。再验证容器有效环境、目录可写、设备可用与 healthcheck 退出状态。切 CPU 时还要处理 Compose 的 NVIDIA 设备预留,不能只改 DEVICE。

本文没有构建或启动镜像,结论来自打包路径审查。部署可复现,依赖的是这几层配置同时对齐。


源码与阅读导航

本文属于「细胞分割工具链笔记」第 15 篇。依据固定提交 fd43764aac23 研读,后续版本可能不同。

全部专题与阅读顺序 · 上一篇:空 API Key 意味着关闭认证,不能只当成尚未配置 · 下一篇:调整分割参数前,先证明你比较的是同一个实验

还没有评论

欢迎留下你的观点,保持交流的清晰和友好。

写下评论