基础设施即代码 / 系统课时
搭建 Ansible 控制节点
搭建 Ansible 控制节点
本篇把一台 Linux 主机准备成可重复使用的 Ansible 控制节点:用 Python 虚拟环境隔离依赖,安装 Ansible,建立最小项目配置,并通过本机 ping 模块验证命令、配置加载和模块执行链全部可用。
学习目标
- 使用 Python 虚拟环境安装并隔离 Ansible。
- 确认
ansible、ansible-config与项目配置可以正常加载。 - 用最小 inventory 完成一次本机模块执行验证。
检查并安装控制节点依赖
控制节点不需要运行 Ansible 服务端进程,但需要 Python、venv、pip 和 SSH 客户端。下面以 Debian/Ubuntu 系统为例;命令会把项目放在 ~/ansible-lab,Ansible 只安装到该目录下的虚拟环境。
sudo apt-get update -qq
sudo apt-get install -y python3 python3-venv python3-pip openssh-client >/dev/null
mkdir -p ~/ansible-lab
cd ~/ansible-lab
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --quiet --upgrade pip
python -m pip install --quiet ansible
ansible --version | head -n 4预期输出
ansible [core <VERSION>]
config file = None
configured module search path = <PATH_OR_LIST>
ansible python module location = <PATH><VERSION> 和 <PATH> 会随安装版本与用户目录变化。此时 config file = None 是正常的,因为项目配置文件还没有创建。以后每次进入项目,都应先执行 source .venv/bin/activate;这样不会把课程依赖写进系统 Python,也能避免受 PEP 668 管理的系统环境拒绝全局 pip install。
建立最小项目配置
Ansible 会从当前工作目录等位置查找 ansible.cfg。把 inventory 路径固定在项目内,可以让命令不依赖全局配置;本机 inventory 则用于先排除网络、SSH 和远端 Python 等变量,只验证控制节点自身。
cd ~/ansible-lab
source .venv/bin/activate
cat > ansible.cfg <<'EOF'
[defaults]
inventory = ./inventory.ini
interpreter_python = auto_silent
retry_files_enabled = False
EOF
cat > inventory.ini <<'EOF'
[local]
localhost ansible_connection=local
EOF
ansible-config view
ansible all -m ping预期输出
[defaults]
inventory = ./inventory.ini
interpreter_python = auto_silent
retry_files_enabled = False
localhost | SUCCESS => {
"changed": false,
"ping": "pong"
}ping 模块并不是 ICMP 网络探测;它会实际启动 Ansible 模块,并由目标 Python 返回 pong。因此这里成功,说明 CLI、inventory 解析、Python 解释器和模块执行链已经连通。
判断配置是否真的来自当前项目
进入其他目录后,Ansible 可能加载不同的配置,所以排错时不要只看“命令能运行”。在项目目录执行 ansible --version,其中 config file 应指向 ~/ansible-lab/ansible.cfg;若仍是 None,先确认当前目录和文件权限。
虚拟环境未激活时出现 ansible: command not found,重新执行 source ~/ansible-lab/.venv/bin/activate 即可;创建虚拟环境失败时,优先确认 python3-venv 已安装。做到本机 ping 返回 pong 后,控制节点就具备继续管理远端 Linux 主机的基础。