创建 playbook

Playbook 是自动化蓝图,以 YAML 格式编写,Ansible 使用它们来部署和配置受管节点。

Playbook

一个 plays 列表,定义了 Ansible 从上到下执行操作的顺序,以实现整体目标。

Play

一个有序的任务列表,映射到清单中的受管节点。

任务

对单个模块的引用,定义了 Ansible 执行的操作。

模块

Ansible 在受管节点上运行的代码单元或二进制文件。 Ansible 模块按集合分组,每个模块都有一个完全限定集合名称 (FQCN)

完成以下步骤以创建一个 playbook,该 playbook 将 ping 您的主机并打印“Hello world”消息

  1. 在您之前创建的 ansible_quickstart 目录中创建一个名为 playbook.yaml 的文件,内容如下

    - name: My first play
      hosts: myhosts
      tasks:
       - name: Ping my hosts
         ansible.builtin.ping:
    
       - name: Print message
         ansible.builtin.debug:
           msg: Hello world
    
  2. 运行您的 playbook。

    ansible-playbook -i inventory.ini playbook.yaml
    

Ansible 返回以下输出

PLAY [My first play] ****************************************************************************

TASK [Gathering Facts] **************************************************************************
ok: [192.0.2.50]
ok: [192.0.2.51]
ok: [192.0.2.52]

TASK [Ping my hosts] ****************************************************************************
ok: [192.0.2.50]
ok: [192.0.2.51]
ok: [192.0.2.52]

TASK [Print message] ****************************************************************************
ok: [192.0.2.50] => {
    "msg": "Hello world"
}
ok: [192.0.2.51] => {
    "msg": "Hello world"
}
ok: [192.0.2.52] => {
    "msg": "Hello world"
}

PLAY RECAP **************************************************************************************
192.0.2.50: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.0.2.51: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.0.2.52: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

在此输出中,您可以看到

  • 您为 play 和每个任务指定的名称。您应该始终使用描述性名称,以便轻松验证和排除 playbook 的故障。

  • “Gathering Facts”任务是隐式运行的。默认情况下,Ansible 会收集有关您的清单的信息,以便在 playbook 中使用。

  • 每个任务的状态。每个任务的状态均为 ok,表示它已成功运行。

  • play 回顾,总结每个主机 playbook 中所有任务的结果。在此示例中,有三个任务,因此 ok=3 表示每个任务都成功运行。

恭喜,您已开始使用 Ansible!

另请参阅

Ansible playbook

开始构建真实场景的 playbook。

使用 playbook

深入了解 Ansible playbook。

Ansible 技巧和诀窍

获取使用 playbook 的技巧和诀窍。

发现变量:facts 和魔术变量

详细了解 playbook 中的 gather_facts 关键字。