ansible.utils.ipv4 测试 – 测试是否为 IPv4 地址或网络

注意

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

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

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

要在 Playbook 中使用它，请指定： ansible.utils.ipv4。

ansible.utils 2.2.0 中的新功能

概要

  • 此插件检查提供的值是否为使用 IPv4 寻址方案的有效主机或网络 IP 地址

关键字参数

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

参数

注释

ip

字符串 / 必需

表示将要执行测试的值的字符串

例如：10.1.1.1、10.0.0.0/8 或 fe80::216:3eff:fee4:16f3

示例

#### Simple examples

- name: Check if 10.0.0.0/8 is a valid IPv4 address
  ansible.builtin.set_fact:
    data: "{{ '10.0.0.0/8' is ansible.utils.ipv4 }}"

# TASK [Check if 10.0.0.0/8 is a valid IPv4 address] ***************************
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

- name: Check if 192.168.1.250 is a valid IPv4 address
  ansible.builtin.set_fact:
    data: "{{ '192.168.1.250' is ansible.utils.ipv4 }}"

# TASK [Check if 192.168.1.250 is a valid IPv4 address] ********************
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

- name: Check if fe80::216:3eff:fee4:16f3 is not a valid IPv4 address
  ansible.builtin.set_fact:
    data: "{{ 'fe80::216:3eff:fee4:16f3' is not ansible.utils.ipv4 }}"

# TASK [Check if fe80::216:3eff:fee4:16f3 is not a valid IPv4 address] *********
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

返回值

键

描述

数据

字符串

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

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

返回: 成功

作者

  • Priyam Sahoo (@priyamsahoo)

提示

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