Ubuntu 20.04环境下该Ansible部署方案是否正确?
现有方案的合理性评估
你这套方案在2021年的Ubuntu Server 20.04场景下,核心思路是完全站得住脚的,不属于非正规的野路子做法:
- 采用独立Python虚拟环境安装Ansible,完全避开了Ubuntu系统Python的依赖耦合问题——毕竟系统Python是apt包管理器的运行基础,直接在系统Python里pip install包很容易触发系统工具的依赖冲突,把Ansible和它的依赖都锁定在venv里是行业通用的合规操作。
- 提前安装本地数据库客户端、libpq编译依赖,同时安装PyMySQL、psycopg2这类Ansible连接数据库必需的Python驱动,把本地日常运维、Ansible远程管理数据库两类需求的依赖都覆盖到了,没有遗漏核心组件。
- 用update-alternatives做可执行文件的版本映射,本质是实现了多版本Ansible的并行切换能力,不需要手动修改PATH、不需要记忆每个版本的二进制绝对路径,设计思路完全成熟。
现有方案存在的可优化点
这套方案没有硬伤,但有不少可以简化、降低长期维护成本的空间:
- 中间层的shell包装脚本完全是冗余的:venv里生成的所有可执行文件,本身已经把shebang写死为对应venv的Python解释器路径,运行时会自动加载venv里的site-packages环境,根本不需要手动执行source activate、deactivate。多写这层包装不仅要给每一个Ansible组件(ansible、ansible-playbook、ansible-doc、ansible-galaxy等)单独写一份脚本,还容易因为shell兼容性、返回值传递的边界问题引入不必要的故障。
- 固定的venv路径(/opt/ansible)没有版本标识,后续如果要升级Ansible版本,要么清空旧venv做覆盖,要么临时更换路径,长期来看容易出现旧版本被误删、版本和目录对应错位的问题。
- 当前的安装流程没有对依赖版本做固化,后续如果要在其他环境重建这套Ansible管控节点,很容易拉到和Ansible 2.8.13不兼容的驱动版本,触发难以排查的连接类错误。
更优的落地实现方式
完全可以在不改变你核心思路的前提下,把长期维护成本降下来:
- 删掉所有手动编写的shell包装脚本,直接把venv里的二进制关联到update-alternatives
关联命令不需要经过中间的.sh文件,直接指向venv目录下的可执行文件即可,比如:
因为venv的二进制本身自带环境加载能力,这种方式和原来的包装脚本效果完全一致,但少了两层不必要的shell调用,稳定性更高。update-alternatives --install /usr/local/bin/ansible-playbook ansible-playbook \ /opt/ansible-2.8.13/bin/ansible-playbook 1 - 调整venv的目录命名规则,把版本号作为目录名的一部分
不要用无版本标识的/opt/ansible路径,改成/opt/ansible-<版本号>的结构,比如/opt/ansible-2.8.13。这样后续升级版本的时候,只要新建一个/opt/ansible-<新版本号>的venv目录,跑一遍update-alternatives把新版本的权重调高就行,旧版本的venv完全保留在磁盘上,要回滚的时候只要把权重切回去就能恢复,不需要重新安装依赖。 - 固定每个venv内的依赖清单
单个版本的venv建完、所有依赖安装完成后,把当前的依赖版本导出到对应venv目录下的requirements文件,比如:
后续不管是重建管控节点、还是补装缺失的依赖,都可以直接对照这个清单安装,避免因为依赖版本漂移出现兼容问题。/opt/ansible-2.8.13/bin/pip freeze > /opt/ansible-2.8.13/requirements.txt - 如果觉得update-alternatives的操作太繁琐,可以换成更轻量的软链接方案
专门建一个无版本标识的软链接路径/opt/ansible/current,直接指向当前正在使用的Ansible版本的venv目录,再把/opt/ansible/current/bin加到系统全局PATH的最前面。后续切换版本的时候,只要把软链接的指向改到新版本的venv目录即可,不需要给每一个Ansible二进制单独做alternatives关联,操作步骤更少,长期维护更省心。
落地时的注意事项
- 系统级的
mysql-client、postgresql-client这类非Python依赖工具,直接通过apt安装到系统路径即可,不需要纳入venv管理,日常运维调用时路径更短、使用更方便。 - 不要为了简化流程直接把Ansible安装到系统Python环境,也不要直接使用Ubuntu apt仓库自带的Ansible包,这类官方源的Ansible版本迭代节奏慢,和自定义安装的PyMySQL、psycopg2这类驱动容易出现版本不兼容问题。
- 后续安装Ansible Collections时,统一把安装路径放在对应版本的venv目录下,不要放到用户家目录的默认路径,避免不同版本的Ansible出现集合读取冲突。
内容的提问来源于stack exchange,提问作者Darko Miletic
相关产品推荐
相关产品推荐

