ansible.utils.resolvable 测试 – 测试是否可以通过 /etc/hosts 或 DNS 解析 IP 或名称

注意

此测试插件是 ansible.utils 集合（版本 5.1.2）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install ansible.utils。

要在 playbook 中使用它，请指定：ansible.utils.resolvable。

ansible.utils 2.2.0 中的新增功能

概要

  • 此插件检查提供的 IP 地址或主机名是否可以使用 /etc/hosts 或 DNS 解析

关键字参数

这描述了测试的关键字参数。这些是在以下示例中的 key1=value1、key2=value2 等值：input is ansible.utils.resolvable(key1=value1, key2=value2, ...) 和 input is not ansible.utils.resolvable(key1=value1, key2=value2, ...)

参数

注释

host

字符串 / 必需

一个表示 IP 地址或主机名的字符串

例如："docs.ansible.com"、127.0.0.1 或 ::1

示例

#### Simple examples

- name: Check if docs.ansible.com is resolvable or not
  ansible.builtin.set_fact:
    data: "{{ 'docs.ansible.com' is ansible.utils.resolvable }}"

# TASK [Check if docs.ansible.com is resolvable or not] **********************************
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

- name: Set host name variables
  ansible.builtin.set_fact:
    good_name: www.google.com
    bad_name: foo.google.com

- name: Assert good_name's resolvability
  assert:
    that: "{{ 'www.google.com' is ansible.utils.resolvable }}"

- name: Assert bad_name's resolvability
  assert:
    that: "{{ 'foo.google.com' is not ansible.utils.resolvable }}"

# TASK [Assert good_name's resolvability] ************************************************
# ok: [localhost] => {
#     "changed": false,
#     "msg": "All assertions passed"
# }

# TASK [Assert bad_name's resolvability] *************************************************
# ok: [localhost] => {
#     "changed": false,
#     "msg": "All assertions passed"
# }

- name: Set ip variables
  ansible.builtin.set_fact:
    ipv4_localhost: "127.0.0.1"
    ipv6_localhost: "::1"

- name: Assert ipv4_localhost's resolvability
  assert:
    that: "{{ ipv4_localhost is ansible.utils.resolvable }}"

- name: Assert ipv6_localhost's resolvability
  assert:
    that: "{{ ipv6_localhost is ansible.utils.resolvable }}"

# TASK [Assert ipv4_localhost's resolvability] *******************************************
# ok: [localhost] => {
#     "changed": false,
#     "msg": "All assertions passed"
# }

# TASK [Assert ipv6_localhost's resolvability] *******************************************
# ok: [localhost] => {
#     "changed": false,
#     "msg": "All assertions passed"
# }

返回值

键

描述

数据

字符串

如果 jinja 测试满足插件表达式 true

如果 jinja 测试不满足插件表达式 false

返回：成功

作者

  • Priyam Sahoo (@priyamsahoo)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。