基础设施即代码 / 系统课时

执行第一次 Ad Hoc 命令

执行第一次 Ad Hoc 命令

本课用一组最小 Ad Hoc 命令打通控制节点、Inventory 与受管主机,完成连通性检查和系统信息采集。执行完后,你能判断 Ansible 是否已经具备批量远程操作的基本条件。

学习目标

  • 掌握 ansible Ad Hoc 命令的目标模式、Inventory、模块和参数写法
  • 使用 ansible.builtin.ping 验证 SSH、认证与远程执行链路
  • 使用 ansible.builtin.setup 采集受管主机的基础事实并定位常见连接失败

看懂 Ad Hoc 命令的执行链路

Ad Hoc 命令适合执行一次性的批量操作,例如连通性检查、查询系统版本、重启服务或临时修改文件。它不需要先编写 Playbook,基本结构是 ansible <主机模式> -i <inventory> -m <模块> -a <参数>。

Ad Hoc 命令从控制节点到受管主机的执行链路

目标模式可以是 all、单个主机、某个组或更复杂的 pattern。-i 指定 Inventory,-m 指定模块,-a 传递模块参数。模块名称建议使用完全限定集合名,例如 ansible.builtin.ping,这样可以明确模块来源。

验证端到端连通性

假设当前目录已经有可访问受管主机的 inventory.ini,先执行 ping 模块。Ansible 的 ping 不是 ICMP ping,而是验证登录、远程模块执行和结果返回是否都能成功。

bash
ansible all -i inventory.ini -m ansible.builtin.ping

预期输出如下,主机名会随 Inventory 不同而变化:

text
web1 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
web2 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

出现 SUCCESS 和 pong 说明至少四个环节已经打通:目标主机被正确匹配、SSH 可以建立、远端能够执行模块、执行结果能够返回控制节点。changed: false 表示这个检查没有修改远程状态。

采集远程系统信息

连通后可以使用 ansible.builtin.setup 获取 facts。完整 facts 很多,第一次验证时更适合通过 filter 只查看关心的字段,例如发行版信息。

bash
ansible all -i inventory.ini -m ansible.builtin.setup -a 'filter=ansible_distribution*'

预期输出结构类似下面这样,发行版名称和版本取决于实际受管主机:

text
web1 | SUCCESS => {
    "ansible_facts": {
        "ansible_distribution": "<VALUE>",
        "ansible_distribution_major_version": "<VALUE>",
        "ansible_distribution_version": "<VALUE>"
    },
    "changed": false
}

setup 返回的是 Ansible 后续自动化可以直接使用的主机事实。此时如果不同主机返回不同发行版或版本,也说明 Inventory 中的多个目标确实被分别执行,而不是只验证了控制节点本机。

按错误层级定位失败

Ad Hoc 命令失败时不要立刻修改模块参数,先看错误发生在哪一层。UNREACHABLE 通常说明主机连接链路未建立,应优先检查地址、SSH 端口、用户、密钥、主机密钥校验和网络;FAILED 则通常表示已经连接,但模块执行本身失败。

可以增加详细日志观察连接过程:

bash
ansible web1 -i inventory.ini -m ansible.builtin.ping -vvv

成功时预期结果仍以 SUCCESS 和 pong 结束,只是前面会增加连接与模块传输细节:

text
<CONNECTION DEBUG OUTPUT>
web1 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

如果日志显示 Permission denied,优先修正 SSH 用户或认证材料;如果显示主机无法解析或连接超时,先修正 Inventory 地址和网络;如果 SSH 已建立但远程模块报错,再检查远端 Python、权限或模块参数。能够稳定执行 ping 与一次 setup 采集,就说明最基本的 Ansible 端到端实验链路已经成立。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行第一次 Ad Hoc 命令

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

登录哪都通