Ansible批量部署:从写清单到并发执行的操作步骤
Ansible 批量部署的核心思路是:在一台控制机上写好主机清单和 playbook,通过 SSH 把任务并行推到多台目标机执行。
你不需要在每台服务器上安装 agent,只要控制端能免密登录目标机,就能用一条命令完成软件安装、配置文件分发、服务启动等重复操作。
下面按从零开始的顺序讲清楚准备、操作和验证,适合刚接触 Ansible 的运维新手。
先确认控制端和目标端的 SSH 条件
Ansible 本身不负责建立信任关系,它依赖 SSH 登录目标机。
因此第一步是确认控制端能直接用密钥登录所有目标机。
- 控制端安装 Ansible:在 CentOS/RHEL 上执行
yum install -y ansible,在 Ubuntu/Debian 上执行apt install -y ansible。安装后运行ansible --version能看到版本号即可。 - 生成 SSH 密钥:如果控制端还没有密钥,执行
ssh-keygen -t rsa -b 4096,一路回车使用默认路径。 - 分发公钥:用
ssh-copy-id root@目标IP把公钥复制到每台目标机。如果目标机不是 root 用户,换成实际登录用户即可。 - 验证免密:执行
ssh root@目标IP,不提示密码直接进入 shell 就说明免密成功。
目标机需要安装 Python,因为 Ansible 大多数模块依赖 Python 解释器。
多数 Linux 发行版默认已带 Python 3,可以用 python3 --version 确认。
编写主机清单,把目标机分组
Ansible 默认读取 /etc/ansible/hosts,但建议在项目目录下单独建一个清单文件,比如 inventory.ini。
[web]
192.168.1.11
192.168.1.12
[db]
192.168.1.21
[all:vars]
ansible_user=root
ansible_ssh_private_key_file=/root/.ssh/id_rsa
方括号里是组名,组名可以自定义。all:vars 表示对所有主机生效的变量,这里指定登录用户和私钥路径。
如果目标机 SSH 端口不是 22,可以加 ansible_port=2222。
写完后用 ansible all -i inventory.ini -m ping 测试连通性。
每台主机都返回 pong 才算清单配置正确。
用 playbook 描述批量任务
playbook 是 YAML 格式的任务清单,一个 playbook 可以包含多个 play,每个 play 针对一组主机执行若干任务。
下面是一个批量部署 Nginx 并分发首页文件的例子:
---
- name: 批量部署 Nginx
hosts: web
become: yes
tasks:
- name: 安装 Nginx
yum:
name: nginx
state: present
- name: 分发首页文件
copy:
src: files/index.html
dest: /usr/share/nginx/html/index.html
owner: root
group: root
mode: '0644'
- name: 启动并设置开机自启
service:
name: nginx
state: started
enabled: yes
几个关键点:
hosts: web对应清单里的[web]组。become: yes表示用 sudo 提权执行,如果直接用 root 登录可以省略。copy模块的src是控制端本地路径,dest是目标机路径。- 模块名和参数要写对,比如
yum用于 CentOS/RHEL,Ubuntu 上应换成apt。
把上面的内容保存为 deploy-nginx.yml,同时在当前目录创建 files/index.html,内容随意写一行测试文字即可。
执行 playbook 并观察结果
在控制端进入 playbook 所在目录,执行:
ansible-playbook -i inventory.ini deploy-nginx.yml
执行过程中会按主机输出任务状态。
常见状态含义:
ok:任务执行成功且没有发生变更。changed:任务执行成功并修改了目标机状态。fatal:任务失败,需要看后面的错误信息定位。
如果只想先检查语法和影响范围,可以加 --check 参数做预演,但部分模块在检查模式下不会真正执行。
Ansible 默认并发数是 5,也就是同时操作 5 台主机。
目标机较多时可以调整:
ansible-playbook -i inventory.ini deploy-nginx.yml -f 10
-f 10 表示最多 10 台并发。
并发数不是越大越好,受控制端性能和目标机 SSH 承受能力限制,建议从 5 到 10 开始观察。
验证部署结果与常见失败处理
部署完成后,不要只看 playbook 返回成功,还要到目标机确认实际状态:
- 执行
systemctl status nginx查看服务是否运行。 - 执行
curl http://127.0.0.1看是否返回首页内容。 - 检查
/usr/share/nginx/html/index.html文件是否存在且权限正确。
常见失败原因集中在几处:
- SSH 连接失败:先手动
ssh目标机确认免密是否生效,再检查清单里的 IP、端口、用户是否正确。 - 权限不足:安装软件和写系统目录需要 root 或 sudo,确认
become: yes已加,并且目标机 sudo 配置允许当前用户提权。 - 模块参数写错:YAML 对缩进敏感,冒号后要有空格。报错信息通常会指出具体模块和参数名,按提示修正。
- 目标机没有 Python:Ansible 执行模块依赖 Python,可以用
ansible all -i inventory.ini -m raw -a 'python3 --version'检查。
批量部署前建议先拿一台测试机跑通 playbook,确认无误后再把清单扩展到全部目标机。
对生产环境执行变更前,至少确认配置文件有备份或可回滚,避免一次性影响所有节点。
关于批量部署范围的一点提醒
Ansible 适合做配置分发、软件安装、服务启停这类幂等操作,但不要把它当成万能的编排工具。
涉及数据库主从切换、集群扩缩容等有状态操作时,需要额外设计执行顺序和失败回滚策略。
先把无状态服务的批量部署跑顺,再逐步扩展到更复杂的场景。