第 1 篇 · 认识与部署 Ansible
《Ansible 自动化运维实战》第 1 篇
本文说明 Ansible 的基本概念、部署方式与首次连通验证。目标读者:需要自动化管理 Linux 或 Windows 主机的实施人员。完成本篇后,部署机可以执行
ping与 ad-hoc 命令。
1. Ansible 概述
Ansible 是一套自动化运维工具,采用控制节点与被管节点的结构,不需要在被管节点安装代理程序。核心特性如下。
1.1 无代理
被管节点不需要安装 Ansible 程序,也不需要常驻代理。控制节点通过 SSH 连接 Linux 主机,通过 WinRM 连接 Windows 主机,任务完成后即断开。无代理特性降低了被管节点的维护负担,这是 Ansible 与需要预装代理的配置管理工具的主要区别。
1.2 幂等
Ansible 任务具备幂等性:同一任务重复执行,结果与首次执行一致。任务描述的是目标状态,Ansible 只在当前状态与目标状态不一致时执行变更。服务已处于所需状态时,重复执行不会重启服务;文件内容已符合要求时,重复执行不会重写文件。幂等性保证重复执行安全且结果可预期。
1.3 声明式
Ansible 使用声明式描述目标状态,不编写用于判断当前状态的命令序列。部署请求只需说明「某文件的内容应为 X」「某服务应处于运行状态」,由 Ansible 决定具体操作。
1.4 与批量脚本的差异
批量脚本通过循环在多个主机执行命令序列,执行结果与各主机当前状态耦合。部分主机已完成安装、部分主机版本不一致时,脚本可能执行失败且难以回滚。Ansible 基于目标状态执行:缺少的内容补齐,多余的内容不处理,已偏离的状态可据目标状态修复。
2. 部署前提与选型
2.1 前置条件
部署 Ansible 前,确认满足以下条件:
- 部署机为 Linux 系统。本文以 Rocky Linux 9.9 为例;Debian/Ubuntu 使用 apt,包名与仓库与本文不同,但流程一致。
- 系统已安装 Python 3.13,或可从仓库安装。当前最新版(ansible 15.0.0)要求 Python 3.13;Rocky 9 默认提供 Python 3.9 与 3.12,Python 3.13 需从 EPEL 获取。
- 已启用 EPEL 仓库。未启用时先执行
dnf install -y epel-release。 - 部署机可访问 PyPI 软件源;网络受限时可使用国内镜像源(见第 3.2 节)。
2.2 选型说明
使用系统软件仓库安装 Ansible 时,包版本可能滞后。本文环境中的 EPEL(Extra Packages for Enterprise Linux)仓库提供 ansible 7.7.0(对应 ansible-core 2.14,2023 年发布,已过上游维护期)。
为获取受支持版本,建议使用 Python 虚拟环境(venv)安装,并从 PyPI 获取软件包。虚拟环境使 Ansible 与系统 Python 环境隔离,避免影响系统上其他工具。
当前(2026 年 11 月)PyPI 上的最新版本为 ansible 15.0.0 / ansible-core 2.22.0,二者要求 Python 3.13 或更高。因此部署环境需要 Python 3.13:EPEL 仓库提供 python3.13,通过 dnf install -y python3.13 安装(见第 3 节)。
3. 部署 Ansible
以下步骤在部署机上执行,均需 root 权限。安装路径以 /opt/ansible-venv 为例。
3.1 创建虚拟环境
- (若 EPEL 未启用)启用 EPEL 仓库。
dnf install -y epel-release
可手动选中代码并复制。
- 确认 Python 3.13 可用;缺失时安装。
python3.13 --version
dnf install -y python3.13
可手动选中代码并复制。
- 创建虚拟环境。使用与最新版要求匹配的 Python 3.13。
python3.13 -m venv /opt/ansible-venv
可手动选中代码并复制。
3.2 安装 Ansible
- 升级虚拟环境内的 pip。
/opt/ansible-venv/bin/pip install -U pip
可手动选中代码并复制。
- 安装 Ansible。
/opt/ansible-venv/bin/pip install ansible
可手动选中代码并复制。
网络受限或下载缓慢时,可指定国内镜像源安装(以阿里云源为例):
/opt/ansible-venv/bin/pip install -i https://mirrors.aliyun.com/pypi/simple ansible
可手动选中代码并复制。
- 创建命令入口符号链接,使各 shell 可以直接调用 Ansible 命令。
ln -s /opt/ansible-venv/bin/ansible* /usr/local/bin/
可手动选中代码并复制。
若 /usr/local/bin 下已存在同名 ansible 命令(例如系统仓库安装过旧版),符号链接会创建失败,需先移除旧文件或改用其他路径。
- 验证命令入口。
which ansible
可手动选中代码并复制。
预期输出:
/usr/local/bin/ansible
可手动选中代码并复制。
3.3 验证安装
执行以下命令确认安装结果:
ansible --version
可手动选中代码并复制。
预期输出包含 ansible 与 ansible-core 的版本号、配置文件路径与 Python 版本。以 2026 年 11 月的最新版本为例:
ansible [core 2.22.0]
config file = /etc/ansible/ansible.cfg
... python version = 3.13.18 ... (/opt/ansible-venv/bin/python3.13)
可手动选中代码并复制。
config file是否显示取决于系统是否存在默认配置文件(/etc/ansible/ansible.cfg)。判断安装成功以版本号与 Python 行为准。
输出不符合预期时,检查 Python 版本是否满足要求、PyPI 或镜像源是否可访问。
4. 版本升级与维护
第 3 节演示了在干净环境安装当前最新版。本节说明已有旧版本环境的升级方法,以一个真实案例展开:将 ansible 14.6.0(Python 3.12)升级到 15.0.0(Python 3.13)。PyPI 于 2026 年 11 月发布 ansible 15.0.0 与 ansible-core 2.22.0,要求 Python 3.13 或更高。
首次搭建(刚按第 3 节完成安装)的读者可跳过本节,直接进入第 5 节验证。本节适用于需要升级旧版本环境的读者。
4.1 升级约束
ansible 15.0.0 与 ansible-core 2.22.0 要求 Python 3.13 或更高版本。现有虚拟环境为 Python 3.12 时,无法直接升级,需要先安装新版本的 Python。
本文版本信息核对于 2026 年 11 月。软件版本更新较快,请以官方发布说明为准。
4.2 升级步骤
- (若 EPEL 未启用)启用 EPEL 仓库,并安装 Python 3.13。
dnf install -y epel-release
dnf install -y python3.13
可手动选中代码并复制。
- 使用 Python 3.13 重建虚拟环境。为便于回滚,先移走现有环境,再在原路径重建。
mv /opt/ansible-venv /opt/ansible-venv-14
python3.13 -m venv /opt/ansible-venv
可手动选中代码并复制。
- 升级新环境内的 pip,再安装指定版本。
/opt/ansible-venv/bin/pip install -U pip
/opt/ansible-venv/bin/pip install "ansible==15.0.0"
可手动选中代码并复制。
- 核对关键集合。随发行包捆绑的集合会随新版本自动更新;用户单独安装的集合需确认,必要时重新安装。
ansible-galaxy collection list
可手动选中代码并复制。
- 安装缺失或需要使用的集合。
ansible-galaxy collection install <集合名称>
可手动选中代码并复制。
将 <集合名称> 替换为实际名称,例如 microsoft.ad、ansible.windows。
- 执行回归验证,确认原有功能可用(见第 5 节)。
4.3 已知问题与处理
虚拟环境改名报 bad interpreter:命令失效
现象:将虚拟环境目录改名后,环境中 bin/ 下的命令报 bad interpreter。
原因:虚拟环境中的脚本首行硬编码了创建时的解释器绝对路径;目录改名后,该路径不再指向有效的解释器。
处理:不要通过重命名虚拟环境目录保留旧环境。需要保留旧环境时,将旧环境整体移走,并在原路径重建新环境。需要回滚时,将旧环境目录名改回原路径。
报错 requests-credssp is not installed:Windows CredSSP 依赖缺失
现象:升级后连接 Windows 主机,执行 win_ping 报 requests-credssp is not installed。
原因:新版本环境默认不包含 CredSSP 认证所需的 requests-credssp 包。
处理:安装对应版本的依赖包。
/opt/ansible-venv/bin/pip install "requests-credssp==2.0.0"
可手动选中代码并复制。
升级时机
大版本发布初期,建议暂缓升级,等待补丁发布与社区反馈。旧版本退出维护期,或新版本提供必需能力时,再评估升级。升级前确认关键链路可用,包括 Python 版本、依赖包与 Windows 连接组件。
5. 验证与首次连通
5.1 本机连通验证
Ansible 的 ping 模块验证控制节点与目标主机之间的连接,并确认目标主机可执行模块。该模块不是 ICMP 测试。
在部署机执行:
ansible localhost -m ping
可手动选中代码并复制。
预期输出:
localhost | SUCCESS => {
"changed": false,
"ping": "pong"
}
可手动选中代码并复制。
输出中出现 SUCCESS 与 pong,表示控制节点环境可用。
5.2 接入首台被管主机
- 创建清单目录并编辑清单文件(inventory),登记被管主机(需 root 权限)。清单中的地址以下列示例 IP 替代实际地址。
mkdir -p /etc/ansible
可手动选中代码并复制。
# /etc/ansible/hosts
[web]
10.0.0.21 ansible_user=root
可手动选中代码并复制。
- 配置 SSH 免密登录。Ansible 通过 SSH 批量连接被管主机,首次执行会提示输入被管机的 root 密码。请确认被管机允许 root 通过密码登录,并已安装 Python 3(Ansible 依赖被管端的 Python)。
ssh-copy-id root@10.0.0.21
可手动选中代码并复制。
- 执行批量连通测试。
ansible web -m ping
可手动选中代码并复制。
预期输出中每台主机返回 SUCCESS 与 pong。
返回 UNREACHABLE 时,按以下顺序排查:清单中的地址与登录用户是否正确;SSH 免密是否配置成功(ssh root@10.0.0.21 可免密进入);目标主机防火墙是否放行 SSH。
6. 完成后如何验证
若已在第 5 节完成验证,本节步骤无需重做。本节是独立复查清单,也可作为跳过第 5 节后的自检。每步给出预期输出,执行结果与预期一致即通过。
- 确认 Ansible 可执行。
ansible --version
可手动选中代码并复制。
预期输出:显示 ansible 与 ansible-core 的版本号。
- 验证控制节点自身通道。
ansible localhost -m ping
可手动选中代码并复制。
预期输出:
localhost | SUCCESS => {
"changed": false,
"ping": "pong"
}
可手动选中代码并复制。
- 验证清单中的被管主机。
ansible web -m ping
可手动选中代码并复制。
预期输出:清单中每台主机返回 SUCCESS 与 pong。
以上三步均得到预期结果,表示本篇部署完成,环境可进入第 2 篇。后续各篇将涉及 Windows 接入(WinRM 与 CredSSP)、AD 域控与 Exchange 部署。
7. 常见问题
Q1:ansible 与 ansible-core 是什么关系?
ansible 是完整发行包,包含 ansible-core 与一批常用集合;ansible-core 是执行任务的核心引擎。安装 ansible 时会自动安装配套版本的 ansible-core,可通过 ansible --version 查看两者的版本号。
Q2:为什么不直接使用 dnf install ansible?
系统软件仓库中的包版本可能滞后。本文环境中的 EPEL 仓库提供 ansible 7.7.0,已过上游维护期。从 PyPI 安装并使用虚拟环境,可以获得受支持版本,同时使 Ansible 与系统 Python 隔离。
Q3:升级到新版本后,已安装的集合会丢失吗?
集合分为随发行包捆绑的集合与用户单独安装的集合。随发行包捆绑的集合会随新版本自动更新;用户单独安装的集合在升级后需要检查并在新环境重新安装。本文升级中,关键集合(如 microsoft.ad、ansible.windows)随 ansible 15.0.0 捆绑提供,未受影响。升级后建议执行 ansible-galaxy collection list 核对集合状态。
Q4:ping 模块与网络层的 ICMP ping 是同一回事吗?
不是。Ansible 的 ping 模块验证控制节点到目标主机的管理通道(Linux 为 SSH,Windows 为 WinRM)是否可用,并确认目标主机能够执行模块。它与网络层的 ICMP 连通测试无关。主机之间网络互通,不代表 Ansible 管理通道可用。
Q5:虚拟环境目录改名后,命令为什么全部报错?
虚拟环境中的脚本首行硬编码了创建时的解释器绝对路径。目录改名后,该路径不再指向有效的解释器,命令报 bad interpreter。需要保留旧环境时,应将旧环境整体移走,并在原路径重建;回滚时把目录名改回原路径。
系列导航
《Ansible 自动化运维实战》系列文章规划:
| 序号 | 主题 |
|---|---|
| 第 1 篇 | 认识与部署 Ansible(本文) |
| 第 2 篇 | Playbook 语法与工程化 |
| 第 3 篇 | 接管 Windows(WinRM 与 CredSSP) |
| 第 4 篇 | 实战一:从模板到域控 |
| 第 5 篇 | 实战二:AD 与 Exchange 配置运维 |
| 第 6 篇 | 运维闭环与扩展 |
