Ansible 示例设置

您已经了解了剧本、清单、角色和变量。本节将所有这些元素结合在一起,并概述了一个用于自动化 Web 服务的示例设置。

示例设置按功能组织剧本、角色、清单和带有变量的文件。剧本和任务级别的标签提供更细粒度的控制。这是一种强大而灵活的方法,但还有其他方法可以组织 Ansible 内容。您对 Ansible 的使用应该适合您的需求,因此请随意修改这种方法并相应地组织您的内容。

示例目录布局

此布局将大多数任务组织到角色中,每个环境使用一个清单文件,以及在顶层目录中的一些剧本

production                # inventory file for production servers
staging                   # inventory file for staging environment

group_vars/
   group1.yml             # here we assign variables to particular groups
   group2.yml
host_vars/
   hostname1.yml          # here we assign variables to particular systems
   hostname2.yml

library/                  # if any custom modules, put them here (optional)
module_utils/             # if any custom module_utils to support modules, put them here (optional)
filter_plugins/           # if any custom filter plugins, put them here (optional)

site.yml                  # main playbook
webservers.yml            # playbook for webserver tier
dbservers.yml             # playbook for dbserver tier
tasks/                    # task files included from playbooks
    webservers-extra.yml  # <-- avoids confusing playbook with task files
roles/
    common/               # this hierarchy represents a "role"
        tasks/            #
            main.yml      #  <-- tasks file can include smaller files if warranted
        handlers/         #
            main.yml      #  <-- handlers file
        templates/        #  <-- files for use with the template resource
            ntp.conf.j2   #  <------- templates end in .j2
        files/            #
            bar.txt       #  <-- files for use with the copy resource
            foo.sh        #  <-- script files for use with the script resource
        vars/             #
            main.yml      #  <-- variables associated with this role
        defaults/         #
            main.yml      #  <-- default lower priority variables for this role
        meta/             #
            main.yml      #  <-- role dependencies and optional Galaxy info
        library/          # roles can also include custom modules
        module_utils/     # roles can also include custom module_utils
        lookup_plugins/   # or other types of plugins, like lookup in this case

    webtier/              # same kind of structure as "common" was above, done for the webtier role
    monitoring/           # ""
    fooapp/               # ""

注意

默认情况下,Ansible 假设您的剧本存储在一个目录中,角色存储在名为 roles/ 的子目录中。随着要自动化的任务增多,您可以考虑将您的剧本移至名为 playbooks/ 的子目录中。如果您这样做,则必须使用 ansible.cfg 文件中的 roles_path 设置配置 roles/ 目录的路径。

替代目录布局

您还可以将每个清单文件与其 group_vars/host_vars 放置在单独的目录中。如果您 group_vars/host_vars 在不同环境中没有太多共同之处,这将特别有用。布局可能如下例所示

inventories/
   production/
      hosts               # inventory file for production servers
      group_vars/
         group1.yml       # here we assign variables to particular groups
         group2.yml
      host_vars/
         hostname1.yml    # here we assign variables to particular systems
         hostname2.yml

   staging/
      hosts               # inventory file for staging environment
      group_vars/
         group1.yml       # here we assign variables to particular groups
         group2.yml
      host_vars/
         stagehost1.yml   # here we assign variables to particular systems
         stagehost2.yml

library/
module_utils/
filter_plugins/

site.yml
webservers.yml
dbservers.yml

roles/
    common/
    webtier/
    monitoring/
    fooapp/

此布局为更大的环境提供了更大的灵活性,以及不同环境之间清单变量的完全分离。但是,这种方法更难维护,因为存在更多文件。有关组织组和主机变量的更多信息,请参见 组织主机和组变量

示例组和主机变量

这些带有变量的示例组和主机文件包含适用于每台机器或一组机器的值。例如,亚特兰大数据中心的 NTP 服务器是独有的。因此,在设置 ntp.conf 文件时,您可以使用类似于此示例中的代码

---
# file: group_vars/atlanta
ntp: ntp-atlanta.example.com
backup: backup-atlanta.example.com

类似地,webservers 组中的主机有一些不适用于数据库服务器的配置

---
# file: group_vars/webservers
apacheMaxRequestsPerChild: 3000
apacheMaxClients: 900

默认值或普遍适用的值属于名为 group_vars/all 的文件中

---
# file: group_vars/all
ntp: ntp-boston.example.com
backup: backup-boston.example.com

如有必要,您可以在 host_vars 目录中定义系统中特定的硬件差异

---
# file: host_vars/db-bos-1.example.com
foo_agent_port: 86
bar_agent_port: 99

如果您使用 动态清单,Ansible 会自动创建许多动态组。因此,像 class:webserver 这样的标签将自动从 group_vars/ec2_tag_class_webserver 文件中加载变量。

注意

您可以使用一个名为 hostvars 的特殊变量访问主机变量。有关这些变量的列表,请参见 特殊变量hostvars 变量只能访问特定于主机的变量,而不能访问组变量。

按功能组织的示例剧本

使用此设置,单个剧本可以定义整个基础设施。 site.yml 剧本导入另外两个剧本。一个用于 webservers,一个用于数据库服务器

---
# file: site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.yml

位于顶层的 webservers.yml 剧本将 webservers 组的配置映射到与 webservers 组相关的角色

---
# file: webservers.yml
- hosts: webservers
  roles:
    - common
    - webtier

使用此设置,您可以通过运行 site.yml 来配置您的整个基础设施。或者,要仅配置您的基础设施的一部分,请运行 webservers.yml。这类似于 Ansible 的 --limit 参数,但更明确一些

ansible-playbook site.yml --limit webservers
ansible-playbook webservers.yml

基于功能的角色中的示例任务和处理程序文件

Ansible 在角色子目录中加载任何名为 main.yml 的文件。此示例 tasks/main.yml 文件配置 NTP

---
# file: roles/common/tasks/main.yml

- name: be sure ntp is installed
  yum:
    name: ntp
    state: present
  tags: ntp

- name: be sure ntp is configured
  template:
    src: ntp.conf.j2
    dest: /etc/ntp.conf
  notify:
    - restart ntpd
  tags: ntp

- name: be sure ntpd is running and enabled
  ansible.builtin.service:
    name: ntpd
    state: started
    enabled: true
  tags: ntp

这是一个处理程序文件示例。只有当某些任务报告更改时才会触发处理程序。处理程序在每个剧本结束时运行

---
# file: roles/common/handlers/main.yml
- name: restart ntpd
  ansible.builtin.service:
    name: ntpd
    state: restarted

有关更多信息,请参见 角色

示例设置支持什么

上面描述的基本组织结构支持许多不同的自动化选项。要重新配置您的整个基础设施

ansible-playbook -i production site.yml

要重新配置所有内容的 NTP

ansible-playbook -i production site.yml --tags ntp

要重新配置仅 webservers

ansible-playbook -i production webservers.yml

要重新配置仅波士顿的 webservers

ansible-playbook -i production webservers.yml --limit boston

要重新配置仅波士顿的前 10 个 webservers,然后是接下来的 10 个

ansible-playbook -i production webservers.yml --limit boston[0:9]
ansible-playbook -i production webservers.yml --limit boston[10:19]

示例设置还支持基本的临时命令

ansible boston -i production -m ping
ansible boston -i production -m command -a '/sbin/reboot'

要发现特定 Ansible 命令将运行哪些任务或将影响哪些主机名

# confirm what task names would be run if I ran this command and said "just ntp tasks"
ansible-playbook -i production webservers.yml --tags ntp --list-tasks

# confirm what hostnames might be communicated with if I said "limit to boston"
ansible-playbook -i production webservers.yml --limit boston --list-hosts

组织部署或配置

示例设置说明了典型的配置拓扑。在进行多层部署时,您可能需要一些额外的剧本,这些剧本跨层跳跃以推出应用程序。在这种情况下,您可以使用诸如 deploy_exampledotcom.yml 之类的剧本来扩展 site.yml。但是,一般概念仍然适用。使用 Ansible,您可以使用相同的实用程序进行部署和配置。因此,您可能会重用组并将操作系统配置与应用程序部署保存在单独的剧本或角色中。

将“剧本”视为一项体育运动的比喻——您可以在所有基础设施中使用一组剧本。然后,您拥有在不同时间和出于不同目的使用的情景剧本。

使用本地 Ansible 模块

如果剧本相对于其 YAML 文件有一个 ./library 目录,则可以使用此目录将 Ansible 模块自动添加到模块路径中。这将模块与剧本组织在一起。例如,请参见本节开头的目录结构。

另请参见

YAML 语法

了解 YAML 语法

使用剧本

查看基本剧本功能

集合索引

浏览现有的集合、模块和插件

您应该开发一个模块吗?

了解如何通过编写自己的模块来扩展 Ansible

模式:定位主机和组

了解如何选择主机

沟通

有问题吗?需要帮助?想要分享您的想法?请访问 Ansible 沟通指南