容器依赖别装进可写层:一次重启全丢的教训
【摘要】 三个浏览器任务同时报错,日志只有一行:容器的 Python 依赖不可用,rc=1。前一天它们还正常。差别在于当天容器重建过一次——依赖是在重建前手工 pip install 进去的。 docker inspect 显示容器只有 /config 一个挂载卷;其余目录都在镜像的可写层。可写层跟着容器走:容器删除即消失,docker restart 反而保留。问题不在重启,而在“下一...
# 容器依赖别装进可写层:一次重启全丢的教训
## 一、现象
三个浏览器任务同时报错,日志只有一行:`容器的 Python 依赖不可用,rc=1`。前一天它们还正常。差别在于当天容器重建过一次——依赖是在重建前手工 `pip install` 进去的。
`docker inspect` 显示容器只有 `/config` 一个挂载卷;其余目录都在镜像的可写层。可写层跟着容器走:容器删除即消失,`docker restart` 反而保留。问题不在重启,而在“下一次重建”。
## 二、为什么会漏
临时排查时的典型命令:
```bash
docker exec app pip install playwright
```
它装到了系统 site-packages(`/usr/local/lib/python3.x`),位于可写层。当天验证通过,于是没人再想这件事。直到容器因配置调整被 `rm -f` 重建,依赖静默消失,任务才成批失败。
## 三、判断“装到哪里”的三个事实
```bash
# 1. 解释器与用户 site 路径
docker exec app python3 -c "import site,sys;print(sys.executable);print(site.getusersitepackages())"
# 2. PATH 里的解释器未必是同一个
docker exec app sh -lc 'command -v python3'
docker exec app sh -c 'command -v python3'
# 3. 挂载卷
docker inspect --format '{{json .Mounts}}' app
```
本例的结果:容器内 `sh -lc` 拿到 `/usr/bin/python3`,而 `docker exec app python3` 走 PATH 得到另一个解释器 `/lsiopy/bin/python3`;两者的依赖集合不同。只用一种方式验证,很容易得出“装好了”的错觉。
用户 site 路径落在挂载卷(`/config/.local/...`)时,安装才会持久。注意两个前提:
- 该目录必须存在,Python 才会把它加入 `sys.path`;
- 安装用户与目录属主要一致,否则后续写入会因权限失败。
## 四、做法:持久目录 + 幂等自检
安装:
```bash
docker exec -u app app python3 -m pip install --user --no-cache-dir playwright==1.65.0
docker exec app python3 -c "import playwright;print(playwright.__file__)"
# /config/.local/lib/python3.13/site-packages/playwright/__init__.py
```
自检脚本(可被服务启动前调用):
```bash
if dep_ok; then exit 0; fi
install_dep || true
if dep_ok; then exit 0; fi
notify "依赖自修失败,今天相关任务会以错误退出"
exit 0
```
最后一行是刻意设计:**修复失败时不阻断任务**。任务自己跑出错误码,运行账本里才有记录,日报才能看见缺口;如果自检直接拒绝启动,结果是“没有记录”,比失败更难发现。
## 五、把安装挂到容器生命周期
只在自检里修还不够,因为第一次失败仍会丢一天。容器启动流程里补一步幂等安装:
```bash
ensure_deps() {
docker exec "$C" python3 -c "import playwright" 2>/dev/null && return 0
docker exec -u app "$C" python3 -m pip install --user --no-cache-dir -q playwright==1.65.0
}
```
并在每次 `docker run` 之后就绪判定里调用。版本要固定:镜像里的浏览器内核升级后,客户端库跨大版本可能存在协议差异。
## 六、验收清单
- `pip show` 输出的 Location 必须在挂载卷路径下;
- 用任务实际使用的解释器复核一次导入,而不是只测交互式 shell;
- `docker restart` 后再导入一次,确认不是“重启保留、重建丢失”的幻觉;
- 删除容器再按生产参数重建,导入仍然成功,才算真正持久;
- 把版本号写进安装命令,禁止浮动最新版。
最后一条最容易被省略:浮动版本在重建日可能刚好拉到不兼容的大版本,故障会伪装成“持久化又失效了”。
## 七、代价与不适用场景
- 依赖装在用户目录意味着多用户共享同一容器时会互相覆盖;单用户镜像没有问题。
- 容器启动时联网安装会把“启动成功”绑定到外部包源可用性;离线环境应把 wheel 预置到挂载卷,而不是每次拉取。
- 自检不阻断任务,代价是当天仍可能失败一次;换来的是故障可见。两者不可兼得,选择取决于你是否接受“静默成功”。
- 这套办法只解决 Python 包。系统级库(如视频设备、字体、编解码)必须进镜像,靠卷挂载补不齐。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)