基础设施即代码 / 知识点

Ansible 常用模块速查

连接与执行

CODE
ansible <host-pattern> -m ansible.builtin.ping

检查 Ansible 是否能连接目标主机并完成模块执行;不等同于网络层 ping,适合首次接入、凭据验证和故障排查。

测试主机连通性

首次接入主机、修改 SSH 凭据或排查执行失败时,用 ansible.builtin.ping 验证从控制节点到目标主机的连接、认证以及 Python 模块执行链路是否正常。它不是 ICMP ping;返回 pong 表示 Ansible 已成功执行模块。

基本语法

bash
ansible <host-pattern> -m ansible.builtin.ping

<host-pattern> 指定 Inventory 中的目标主机或主机组。常见的 all 会匹配当前 Inventory 中的全部主机;需要指定 Inventory 文件时可增加 -i <PATH>。

连通性验证

bash
ansible all -m ansible.builtin.ping

预期输出:成功主机通常显示 SUCCESS,并返回 pong;主机名及其他执行元数据可能因环境和 Ansible 版本不同而变化。

text
<HOST> | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

如果需要先确认目标是否被 Inventory 正确匹配,可执行:

bash
ansible all --list-hosts

预期结果:输出匹配到的主机数量和主机列表;若数量为 0,应先检查 Inventory 和 host pattern,而不是继续排查远端连接。

失败时怎么看

UNREACHABLE 通常表示连接或认证阶段没有完成,应检查目标地址、SSH 端口、用户、密钥和网络可达性。模块执行阶段报错则还要检查远端运行 Ansible 模块所需的环境,例如可用的 Python 解释器。

风险与边界

该模块主要用于连接与执行能力验证,不用于判断业务端口、HTTP 服务或数据库是否健康。排障时先用 --list-hosts 确认目标范围,再执行 ping 模块,可以避免把 Inventory 匹配错误误判为远端故障。

文件与配置

软件包与系统

服务与进程

用户与权限

目录与阅读设置

记录一个想法

Ansible 常用模块速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通