容器依赖别装进可写层:一次重启全丢的教训

举报
yd_299686804 发表于 2026/11/15 15:25:04 2026/11/15
【摘要】 三个浏览器任务同时报错,日志只有一行:容器的 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。