Ansible - Ansible安装与入门配置

综合新闻

Ansible - Ansible安装与入门配置

2026-05-03 16:02

React - 安装配置配置详解 Composer - Composer日常开发

解决Ansible自动化工具从零安装、配置到首次连接被管节点的全流程问题，涵盖CentOS/RHEL与Ubuntu两大主流发行版的路径差异，让你绕过常见坑，30分钟跑通第一个Playbook。

Ansible安装与入门配置：从零跑通第一个自动化任务

一、前言

搞过自动化的人都知道，第一次装Ansible时被各种Python依赖、包管理冲突、SSH配置折腾到心态爆炸的环境不在少数。这篇文章不整那些"什么是Ansible"的废话，直接干：装好、配置、连上第一台机器、执行第一个任务。

二、操作步骤

步骤1：确认环境并安装Python环境 | 步骤2：通过pip安装Ansible | 步骤3：创建工作目录和配置文件 | 步骤4：配置inventory主机清单 | 步骤5：配置SSH免密连接 | 步骤6：测试Ansible连通性 | 步骤7：执行第一个实际任务——批量查看磁盘 | 步骤8：编写第一个Playbook实现批量部署

步骤1：确认环境并安装Python环境

Ansible依赖Python 3.8+，先检查系统环境。

CentOS/RHEL 8+：

$ python3 --version
Python 3.9.5
$ sudo dnf install python3 python3-pip -y

已安装并且是最新版本，无需处理。
Package python3-3.9.5-4.el8.x86_64 is already installed.

Ubuntu 22.04+：

$ python3 --version
Python 3.10.12
$ sudo apt update && sudo apt install python3 python3-pip -y

正在读取软件包列表... 完成
生成依赖树... 完成
python3 已达到最新版本 (3.10.6-1)。
pip 3.10.12

步骤2：通过pip安装Ansible

官方推荐pip安装，可以获取最新稳定版本。

$ sudo pip3 install ansible

Collecting ansible Downloading ansible-10.1.0 (py3) Collecting ansible-core==2.15.10 Downloading ansible-core-2.15.10.tar.gz (2.1 MB) ... Installing collected packages: ansible, ansible-core, resolvconf Successfully installed ansible-10.1.0

验证安装结果：

$ ansible --version

ansible [core 2.15.10]
  config file = None
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/local/lib/python3.9/site-packages/ansible
  ansible collection location = /usr/local/lib/python3.9/site-packages/ansible/collections/ansible_collections
  executable location = /usr/local/lib/bin/ansible
  python version = 3.9.5


步骤3：创建工作目录和配置文件
生产环境不要在home目录随便搞，创建个专门的ansible工作区。

$ mkdir -p ~/ansible-prod && cd ~/ansible-prod
$ ls -la

总用量 0
drwxr-xr-x 4 root root 4096 Sep 20 10:30:02 .
drwxr-xr-x 2 root root 4096 Sep 20 10:30:02 .
drwxr-xr-x 6 root root 4096 root 4096 Sep 20 10:30:02 ..


创建ansible.cfg配置文件：
$ cat > ansible.cfg << 'EOF'
[defaults]
inventory = ./inventory
host_key_checking = False
timeout = 30
gather_facts = False

[privilege_escalation]
become = True
become_method = sudo
become_user = root
become_ask_pass = False
EOF
$ cat ansible.cfg

[defaults]
inventory = ./inventory
host_key_checking = False
timeout = 30
gather_facts = False

[privilege_escalation]
become = True
become_method = sudo
become_user = root
become_ask_pass = False


步骤4：配置inventory主机清单
定义要管理的主机。这里用两台测试机做示例，生产环境记得替换成真实IP。

$ cat > inventory << 'EOF'
[webServers]
192.168.1.101 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa
192.168.1.102 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa

[dbServers]
192.168.1.201 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa

[all:vars]
ansible_python_interpreter=/usr/bin/python3
EOF

[webServers]
192.168.1.101 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa
192.168.1.102 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa

[dbServers]
192.168.1.201 ansible_user=deploy ansible_ssh_private_key_file=~/.ssh/id_rsa

[all:vars]
ansible_python_interpreter=/usr/bin/python3


步骤5：配置SSH免密连接
被管节点如果还没配置过SSH公钥，先做这一步。使用ssh-copy-id工具，密码方式部署公钥。

首次连接需输入密码：
$ ssh-copy-id -i ~/.ssh/id_rsa.pub deploy@192.168.1.101

/usr/bin/ssh-copy-id: INFO: Source of key(s) offered: /root/.ssh/id_rsa.pub
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that already exist on the remote system.
/usr/bin/ssh-copy-id: INFO: 1 of 1 node(s) succeeded
deploy@192.168.1.101's password:
Number of key(s) added: 1

Now try logging into the machine, with: "ssh -i '~/.ssh/id_rsa' 'deploy@192.168.1.101'"


验证SSH连接：
$ ssh -o ConnectTimeout=5 deploy@192.168.1.101 "hostname"

web-server-01


步骤6：测试Ansible连通性
用ping模块快速验证所有主机连通性，不需要登录目标机执行命令。

$ cd ~/ansible-prod
$ ansible all -m ping -i inventory

192.168.1.101 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}
192.168.1.102 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}
192.168.1.201 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}


如果看到SUCCESS和pong字样，恭喜你已成功连上所有被管节点。

步骤7：执行第一个实际任务——批量查看磁盘
用command模块在所有web服务器上执行df命令：

$ ansible webServers -m command -a "df -h" -i inventory

192.168.1.101 | CHANGED | rc=0 >>
文件系统          容量  已用  可用 已用% 挂载点
devtmpfs          16G     0   16G    0% /dev
tmpfs             16G     0   16G    0% /dev
/dev/vda1        100G   45G   55G   45% /
tmpfs            2.0G     0  2.0G    0% /dev/shm

192.168.1.102 | CHANGED | rc=0 >>
文件系统          容量  已用  可用 已用% 挂载点
devtmpfs          16G     0   16G    0% /dev
tmpfs             16G     0   16G    0% /dev
/dev/vda1        200G   80G  120G   40% /
tmpfs            2.0G     0  2.0G    0% /dev/shm


步骤8：编写第一个Playbook实现批量部署
真正干活还是得用Playbook，创建一个Nginx安装的配置文件：

$ cat > deploy-nginx.yml << 'EOF'
---
- name: Install and configure Nginx
  hosts: webServers
  become: true
  
  tasks:
    - name: Install Nginx package
      package:
        name: nginx
        state: present

    - name: Start Nginx service
      service:
        name: nginx
        state: started
        enabled: true

    - name: Copy custom index page
      template:
        src: index.html.j2
        dest: /var/www/html/index.html
      notify: Reload Nginx

  handlers:
    - name: Reload Nginx
      service:
        name: nginx
        state: reloaded
EOF

---
- name: Install and configure Nginx
  hosts: webServers
  become: true
  
  tasks:
    - name: Install Nginx package
      package:
        name: nginx
        state: present

    - name: Start Nginx service
      service:
        name: nginx
        state: started
        enabled: true

    - name: Copy custom index page
      template:
        src: index.html.j2
        dest: /var/www/html/index.html
      notify: Reload Nginx

  handlers:
    - name: Reload Nginx
      service:
        name: nginx
        state: reloaded


执行Playbook：
$ ansible-playbook deploy-nginx.yml -i inventory

PLAY [Install and configure Nginx] *********************************************************************

TASK [Gathering Facts] *******************************************************************************
ok: [192.168.1.101]
ok: [192.168.1.102]

TASK [Install Nginx package] **************************************************************************
ok: [192.168.1.101]
ok: [192.168.1.102]

TASK [Start Nginx service] ***************************************************************************
ok: [192.168.1.101]
ok: [192.168.1.102]

PLAY RECAP *******************************************************************************************
192.168.1.101              : ok=3    changed=0    unreachable=0    failed=0
192.168.1.102              : ok=3    changed=0    unreachable=0    failed=0





三、常见问题FAQ


Q：连不上目标机，报"Failed to connect to the host via ssh: Permission denied"
这问题十有八九是SSH密钥没配对。先确认公钥是否已经部署到目标机：ssh-copy-id user@targetIP。再检查inventory里写的路径是否正确指向私钥文件，私钥权限必须是600。如果用了跳板机或者非标准端口，得在inventory里加ansible_ssh_common_args或者在ansible.cfg里配置代理转发。



Q：目标机跑的是Python3，但Ansible报"module default not found in library path"
这是Ansible找不到Python解释器。在inventory里加上ansible_python_interpreter=/usr/bin/python3变量，或者在ansible.cfg的[defaults]段加上interpreter_python=auto_silent。有些精简镜像默认没装python，需要先手动装上yum install python3或apt install python3。



Q：第一次连某台机器要输入yes/no，确认后下次又要输
SSH首次连接会问yes/no做主机指纹确认，但在非交互模式下会卡住。在ansible.cfg里加了host_key_checking = False后就不会再问了。生产环境建议还是用known_hosts管理指纹，这个参数只是开发测试环境用的。



Q：Playbook执行报"Could not find module"或者"unsupported parameter for module"
这是Ansible版本和模块参数不匹配。高版本Ansible废弃了一些旧参数，比如yum模块改成了通用的package，service模块的enabled参数也有调整。先确认控制机的版本：ansible --version，然后去官方文档查对应版本的模块语法。





四、总结
核心要点：

通过pip安装Ansible可获取最新稳定版本，dnf/apt方式受制于仓库更新速度
ansible.cfg和inventory要放在同一目录，启动时默认读取当前目录配置
SSH免密是基操，ssh-copy-id工具能一键完成公钥部署
先用ping模块验证连通性，再跑实际任务，这是基本排查流程
package模块比yum/apt更通用，能跨发行版工作


延伸阅读：

官方文档：Ansible Documentation
进阶主题：Ansible Vault加密敏感数据、Roles组织Playbook结构、Inventory动态脚本
推荐工具：ansible-lint代码检查、ARA记录执行历史、AWX/Web UI管理界面



相关推荐
Ansible批量管理100台服务器
Ansible自动化运维 - 星耀云专业指南
`
    content = content.indexOf('') > 0 ? content.replace('', viewstyle + '') : viewstyle + content
    const iframe = document.querySelector('#viewcontent')
    const viewdoc = iframe.contentDocument
    viewdoc.open()
    viewdoc.write(content)
    viewdoc.close()
    iframe.height = viewdoc.body.scrollHeight + 20
  })






	
		
			
				© 星耀云.
			
			
				
					
				
			
		
	




 Powered by ©智简魔方