模式：目标主机和组

当您通过临时命令或运行剧本执行 Ansible 时，您必须选择要执行的目标管理节点或组。模式允许您对清单中的特定主机和/或组运行命令和剧本。Ansible 模式可以引用单个主机、IP 地址、清单组、组集或清单中的所有主机。模式非常灵活 - 您可以排除或要求主机的子集，使用通配符或正则表达式，等等。Ansible 在模式中包含的所有清单主机上执行。

使用模式 

您几乎在每次执行临时命令或剧本时都会使用模式。模式是临时命令中唯一没有标志的元素。它通常是第二个元素

ansible <pattern> -m <module_name> -a "<module options>"

例如

ansible webservers -m service -a "name=httpd state=restarted"

在剧本中，模式是每个剧本的 hosts: 行的内容

- name: <play_name>
  hosts: <pattern>

例如

- name: restart webservers
  hosts: webservers

由于您通常希望对多个主机同时运行命令或剧本，因此模式通常会引用清单组。上面的临时命令和剧本都将在 webservers 组中的所有机器上执行。

常见模式 

此表列出了用于定位清单主机和组的常见模式。

描述	模式(s)	目标
所有主机	all (或 *)
一台主机	host1
多台主机	host1:host2 (或 host1,host2)
一个组	webservers
多个组	webservers:dbservers	webservers 中的所有主机加上 dbservers 中的所有主机
排除组	webservers:!atlanta	webservers 中的所有主机，除了 atlanta 中的主机
组的交集	webservers:&staging	webservers 中的任何主机，也位于 staging 中

注意

您可以使用逗号 (,) 或冒号 (:) 来分隔主机列表。在处理范围和 IPv6 地址时，首选逗号。

一旦您了解了基本模式，您就可以将它们组合起来。此示例

webservers:dbservers:&staging:!phoenix

定位 'webservers' 和 'dbservers' 组中的所有机器，这些机器也位于 'staging' 组中，除了 'phoenix' 组中的任何机器。

您可以对 FQDN 或 IP 地址使用通配符模式，只要您的清单中使用 FQDN 或 IP 地址命名主机即可

192.0.*
*.example.com
*.com

您可以同时混合使用通配符模式和组

one*.com:dbservers

模式的局限性 

模式取决于清单。如果清单中未列出主机或组，则您无法使用模式定位它。如果您的模式包含清单中未出现的 IP 地址或主机名，您将看到类似于以下内容的错误

[WARNING]: No inventory was parsed, only implicit localhost is available
[WARNING]: Could not match supplied host pattern, ignoring: *.not_in_inventory.com

您的模式必须匹配您的清单语法。如果您将主机定义为别名

atlanta:
  hosts:
    host1:
      http_port: 80
      maxRequestsPerChild: 808
      ansible_host: 127.0.0.2

您必须在模式中使用别名。在上面的示例中，您必须在模式中使用 host1。如果您使用 IP 地址，您将再次收到错误

[WARNING]: Could not match supplied host pattern, ignoring: 127.0.0.2

模式处理顺序 

处理有点特殊，按以下顺序进行

: 和 ,
&
!

此位置只说明每个操作内的处理顺序： a:b:&c:!d:!e == &c:a:!d:b:!e == !d:a:!e:&c:b

所有这些都会导致以下结果

主机在/是 (a 或 b) 并且主机在/是所有(c) 并且主机不在/是所有(d, e)。

现在 a:b:!e:!d:&c 稍微改变了一下，因为 !e 在 !d 之前被处理，虽然这并没有太大区别

主机在/是 (a 或 b) 并且主机在/是所有(c) 并且主机不在/是所有(e, d)。

高级模式选项 

上面描述的常见模式将满足您的大部分需求，但 Ansible 提供了多种其他方法来定义您要定位的主机和组。

在模式中使用变量 

您可以使用变量来启用使用 -e 参数传递组说明符到 ansible-playbook

webservers:!{{ excluded }}:&{{ required }}

在模式中使用组位置 

您可以根据其在组中的位置来定义主机或主机子集。例如，给定以下组

[webservers]
cobweb
webbing
weber

您可以使用下标来选择 webservers 组中的单个主机或范围。

切片特定项目 

操作： s[i]
结果： i-th s 的项目，其中索引原点为 0

如果 *i* 为负数，则索引相对于序列 *s* 的末尾： len(s) + i 将被替换。但是 -0 是 0。

webservers[0]       # == cobweb
webservers[-1]      # == weber

使用起始点和结束点切片 

操作： s[i:j]
结果： s 从 i 到 j 的切片

从 *i* 到 *j* 的 *s* 切片定义为具有索引 *k* 的项目序列，使得 i <= k <= j。如果省略 *i*，则使用 0。如果省略 *j*，则使用 len(s)。省略 *i* 和 *j* 的切片会导致无效的主机模式。如果 *i* 大于 *j*，则切片为空。如果 *i* 等于 *j*，则将替换 *s[i]*。

webservers[0:2]     # == webservers[0],webservers[1],webservers[2]
                    # == cobweb,webbing,weber
webservers[1:2]     # == webservers[1],webservers[2]
                    # == webbing,weber
webservers[1:]      # == webbing,weber
webservers[:3]      # == cobweb,webbing,weber

在模式中使用正则表达式 

您可以通过在模式开头使用 ~ 将模式指定为正则表达式

~(web|db).*\.example\.com

模式和临时命令 

您可以使用命令行选项更改临时命令中定义的模式的行为。您还可以使用 --limit 标志限制特定运行中定位的主机。

限制为一台主机

$ ansible all -m <module> -a "<module options>" --limit "host1"

限制为多台主机

$ ansible all -m <module> -a "<module options>" --limit "host1,host2"

否定限制。请注意，必须使用单引号以防止 bash 插值。

$ ansible all -m <module> -a "<module options>" --limit 'all:!host1'

限制为主机组

$ ansible all -m <module> -a "<module options>" --limit 'group1'

模式和 ansible-playbook 标志 

您可以使用命令行选项更改剧本中定义的模式的行为。例如，您可以通过指定 -i 127.0.0.2,（注意尾随逗号）来运行定义了 hosts: all 的剧本。即使您定位的主机未在您的清单中定义，这也适用，但此方法不会读取您的清单以获取与该主机相关的变量，并且剧本所需的任何变量都需要在命令行手动指定。您还可以使用 --limit 标志限制特定运行中定位的主机，该标志将引用您的清单

ansible-playbook site.yml --limit datacenter2

最后，您可以使用 --limit 从文件中读取主机列表，方法是在文件名之前加上 @

ansible-playbook site.yml --limit @retry_hosts.txt

如果 RETRY_FILES_ENABLED 设置为 True，则在 ansible-playbook 运行后将创建一个 .retry 文件，其中包含所有剧本中失败主机的列表。此文件将在每次 ansible-playbook 完成运行后被覆盖。

ansible-playbook site.yml --limit @site.retry

要将您对模式的了解应用于 Ansible 命令和剧本，请阅读Ad hoc 命令简介和Ansible 剧本。

另请参见

Ad hoc 命令简介: 基本命令示例
使用剧本: 学习 Ansible 配置管理语言
邮件列表: 问题？帮助？想法？请访问 Google Groups 上的列表
实时聊天: 如何加入 Ansible 聊天频道