创建 playbook
Playbook 是自动化蓝图,以 YAML
格式编写,Ansible 使用它们来部署和配置受管节点。
- Playbook
一个 plays 列表,定义了 Ansible 从上到下执行操作的顺序,以实现整体目标。
- Play
一个有序的任务列表,映射到清单中的受管节点。
- 任务
对单个模块的引用,定义了 Ansible 执行的操作。
- 模块
Ansible 在受管节点上运行的代码单元或二进制文件。 Ansible 模块按集合分组,每个模块都有一个完全限定集合名称 (FQCN)。
完成以下步骤以创建一个 playbook,该 playbook 将 ping 您的主机并打印“Hello world”消息
在您之前创建的
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
运行您的 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
关键字。