Ansible 学习笔记 - 定位主机和组的模式

中英文对照表

模式（Patterns）：定位主机和主机组

当您通过一个特别命令（ad hoc）或运行一个剧本（playbook）执行 Ansible 时，您必须选择要针对哪个受管节点或组执行。模式允许您针对库存（inventory）中的特定主机和 / 或组运行命令和剧本。Ansible 模式可以引用单个主机、IP 地址、库存组、一组 组或库存中的所有主机。模式非常灵活——您可以排除或要求主机子集，使用通配符或正则表达式，等等。Ansible 在模式中包含的所有库存主机上执行。

使用模式

几乎在执行特别命令或剧本时都要使用模式。模式是特别命令（ad hoc command ）中唯一没有标志的元素。其通常是第二个元素:

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

例如：

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

⚠️ 注意:

如果 shell 是 zsh，<pattern> 需要用双引号括起来，如下：

• ✅ ansible “component*” -m ping
• ❌ ansible component* -m ping ，这个会报错：「zsh: no matches found: component*」

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

- name: <play_name>
  hosts: <pattern>
YAML

例如：

- name: restart webservers
  hosts: webservers
YAML

由于您经常希望一次针对多个主机运行命令或剧本，因此模式通常引用库存组。特别命令和上面的剧本都将对 webservers 组中的所有机器执行。

常用模式

该表列出了针对库存主机和组的常见模式。

✍️ 笔记:

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

一旦你知道了基本的模式，你就可以把它们组合起来。举个例子:

webservers:dbservers:&staging:!phoenix
DTS

针对 “webservers” 组和 “dbservers” 组中所有也在 “staging” 组中的机器，除了 “phoenix” 组中的机器。

您可以对 FQDN 或 IP 地址使用通配符模式，只要目录中的主机是通过 FQDN 或 IP 地址命名的:

192.0.\*
\*.example.com
\*.com
ASCIIDOC

你可以同时混合通配符模式和组:

one*.com:dbservers
JBOSS-CLI

模式的限制

模式取决于库存。如果一个主机或组没有列在你的目录中，你不能使用模式来锁定它。如果你的模式包含一个 IP 地址或主机名，但没有出现在库存中，你会看到这样的错误:

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

您的模式必须与库存语法匹配。如果将主机定义为别名:

atlanta:
  host1:
    http_port: 80
    maxRequestsPerChild: 808
    host: 127.0.0.2
YAML

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

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

高级模式选项

上面描述的通用模式将满足您的大多数需求，但是 Ansible 提供了其他几种方法来定义您想要目标的主机和组。

在模式中使用变量

你可以通过 -e 参数使用变量来向 ansible-playbook 传递组说明符:

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

在模式中使用组位置

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

[webservers]
cobweb
webbing
weber
PROPERTIES

您可以使用下标来选择单独的主机或范围内的 webservers 组:

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

在模式中使用正则

你可以以 ~ 开头，指定一个模式作为一个正则表达式：

~(web|db).*\.example\.com
JBOSS-CLI

模式和 ansible-playbook 标志

您可以使用命令行选项更改剧本中定义的模式的行为。例如，可以通过指定 -i 127.0.0.2, (注意末尾的逗号)，在单个主机上运行一个定义了所有主机的剧本。即使你的目标主机没有在你的库存中定义，这也可以工作。你也可以使用 --limit 标志来限制你的目标主机:

ansible-playbook site.yml --limit datacenter2
BASH

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

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

如果 RETRY_FILES_ENABLED 设置为 True, ansible-playbook 运行后将创建一个 .retry 文件，其中包含所有剧本中失败的主机列表。每次 ansible-playbook 运行结束时，该文件都会被覆盖。

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

要使用 Ansible 命令和脚本应用您的模式知识，请阅读 特别命令介绍 和脚本介绍。