community.dns.hetzner_dns_records 清单 – 从 Hetzner DNS 记录创建清单
注意
此清单插件是 community.dns 集合(版本 3.1.0)的一部分。
如果您正在使用 ansible
包,您可能已经安装了此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.dns
。
要在 playbook 中使用它,请指定:community.dns.hetzner_dns_records
。
community.dns 2.0.0 中的新增功能
概要
为了让 Ansible 能够将 YAML 文件识别为此插件的清单,清单文件必须包含
plugin: community.dns.hetzner_dns_records
并且其文件名必须以hetzner_dns.yaml
或hetzner_dns.yml
结尾记录通过前缀/记录名称和值进行匹配。
此插件允许从 Hetzner DNS 记录创建清单。
参数
参数 |
注释 |
---|---|
允许选择/取消选择此清单的主机的包含/排除过滤器列表。 过滤器按顺序处理,直到找到第一个匹配 |
|
Jinja2 条件。如果它与主机匹配,则该主机将排除。 只能指定 |
|
Jinja2 条件。如果它与主机匹配,则该主机将包含。 只能指定 |
|
此插件的名称。应始终设置为 选项
|
|
过滤器值对的字典。 此选项在 community.dns 3.0.0 之前称为 默认值: |
|
要使用其值的记录类型。 选项
默认值: |
|
是否将数值转义序列 ( 默认值在 community.dns 3.0.0 中更改为 选项
|
|
确定 TXT 条目值在 API 和此模块的输入输出之间如何转换。 值 值 值 默认值 注意: 转换代码假定值为 UTF-8 编码。 如果您需要其他编码,请使用 选项
|
|
备注
注意
提供程序特定的
hetzner_token
选项可以使用模板。
另请参阅
另请参阅
- community.dns.hetzner_dns_record_set_info
在 Hetzner DNS 服务中检索记录集。
- community.dns.hetzner_dns_record_info
在 Hetzner DNS 服务中检索记录。
示例
# filename must end with hetzner_dns.yaml or hetzner_dns.yml
plugin: community.dns.hetzner_dns_records
zone_name: domain.de
simple_filters:
type:
- TXT
filters:
- include: >-
not ansible_host.startswith('v=')
- exclude: true
txt_transformation: unquoted
# You can also configure the token by putting secret value into this file,
# but this is discouraged. Use a lookup like below, or leave it away and
# set it with the HETZNER_DNS_TOKEN environment variable.
hetzner_token: >-
{{ (lookup('community.sops.sops', 'keys/hetzner.sops.yml') | from_yaml).hetzner_dns_token }}