10 编写Playbook之Playbook的结构和语法

在上一篇中，我们讨论了 Ansible 的基础概念，特别是关于变量与事实的内容。这一节将深入探讨 Ansible Playbook 的结构和语法，为后续的任务定义与管理奠定基础。

什么是 Playbook？

Ansible 的 Playbook 是一组描述如何配置和管理远程主机的指令。它是 YAML 格式的文件，可读性强，易于维护。Playbook 通过“plays”来组织，这些 plays 描述了将要在哪些主机上执行哪些任务。

Playbook 的基本结构

一个基本的 Playbook 通常包含以下几个部分：

---
- hosts: webservers
  remote_user: ansible
  tasks:
    - name: Install nginx
      yum:
        name: nginx
        state: present

关键组成部分

1. 文件头：以 --- 开头，表示是一个 YAML 文件。
2. hosts：指定要应用该 Play 的主机组，可以是 hosts 文件中定义的组或单个主机。
3. remote_user：指定连接到目标主机的用户。
4. tasks：定义要执行的任务，这是 Playbook 的核心部分。
5. name：任务的描述性名称，便于理解任务的目的。
6. 模块：Ansible 提供的各种操作模块，比如 yum, apt, copy, template 等。

Playbook 的语法细节

• Playbook 使用 YAML 格式，注重缩进。每一层缩进需要使用空格（不允许使用制表符）。
• 一个 Playbook 可以包含多个 Plays。这些 Plays 可以根据需要定义在一个文件中。

示例：多个 Plays

---
- hosts: webservers
  tasks:
    - name: Install nginx
      yum:
        name: nginx
        state: present

- hosts: dbservers
  tasks:
    - name: Install MySQL
      yum:
        name: mysql
        state: present

在这个示例中，我们有两个 Plays：一个针对 webservers 主机组，另一个针对 dbservers 主机组。

Playbook 中的变量

在 Playbook 中，可以使用变量来动态化任务的输入。这些变量可以在不同的层级中定义，例如，主机级、任务级或 Playbook 级。

使用变量示例

---
- hosts: webservers
  vars:
    package_name: nginx
  tasks:
    - name: Install web server
      yum:
        name: "{{ package_name }}"
        state: present

这里我们定义了一个变量 package_name，并在任务中使用了它。这种方式提高了 Playbook 的灵活性和可重用性。

处理条件分支

Playbook 支持条件执行，可以使用 when 语句来控制某个任务的执行。

条件执行示例

---
- hosts: webservers
  tasks:
    - name: Install nginx
      yum:
        name: nginx
        state: present
      when: ansible_os_family == "RedHat"

在此示例中，只有当 ansible_os_family 为 RedHat 时，安装 nginx 任务才会被执行。

处理循环

Ansible 还支持循环执行任务，可以使用 with_items 来完成。

循环执行示例

---
- hosts: webservers
  tasks:
    - name: Install multiple packages
      yum:
        name: "{{ item }}"
        state: present
      with_items:
        - nginx
        - git
        - vim

在这个例子中，任务会依次安装 nginx、git 和 vim。

总结

本节内容介绍了 Ansible Playbook 的基本结构与语法，包括如何定义 hosts、tasks 和使用模块。此外，讲解了变量的使用方法，以及条件和循环的执行方式。这些知识为我们即将讨论的任务定义与管理打下了坚实的基础。

如果你已经掌握了这一部分，欢迎继续学习下一内容，编写 Playbook 之任务的定义与管理。