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 适合做配置分发、软件安装、服务启停这类幂等操作,但不要把它当成万能的编排工具。
涉及数据库主从切换、集群扩缩容等有状态操作时,需要额外设计执行顺序和失败回滚策略。
先把无状态服务的批量部署跑顺,再逐步扩展到更复杂的场景。

分享到:
上一篇
K8s 到底需要几台服务器?按用途和可用性要求说清楚
下一篇
用 Prometheus 和 Alertmanager 搭建服务器监控告警
1
系统公告

关于香港云优质服务器IP地址更换的通知

尊敬的客户: 因原IP运营商大幅涨价,为避免成本转嫁至用户,我司决定更换IP服务商。本次更换后,您的续费价格将保持不变,且新IP网络质量与服务标准不受影响。新IP已分配至后台,即刻生效(更换的新IP都是香港原生IPv4)。 涉及 IP 段: 45.192.x.x 旧 IP 停用时间: 2026 年 12 月 1 日
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意