ansible.utils.in_network 测试 – 测试 IP 地址是否属于某个网络

注意

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

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

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

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

ansible.utils 2.2.0 中的新增功能

概要

  • 此插件检查提供的 IP 地址是否属于提供的网络

关键字参数

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

参数

注释

ip

字符串 / 必需

表示 IP 地址的字符串

例如：10.1.1.1

network

字符串 / 必需

表示 CIDR 形式的网络地址的字符串

例如：10.0.0.0/8

示例

#### Simple examples

- name: Check if 10.1.1.1 is in 10.0.0.0/8
  ansible.builtin.set_fact:
    data: "{{ '10.1.1.1' is ansible.utils.in_network '10.0.0.0/8' }}"

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

- name: Check if 10.1.1.1 is not in 192.168.1.0/24
  ansible.builtin.set_fact:
    data: "{{ '10.1.1.1' is not ansible.utils.in_network '192.168.1.0/24' }}"

# TASK [Check if 10.1.1.1 is not in 192.168.1.0/24] ****************************
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

- name: Check if 2001:db8:a::123 is in 2001:db8:a::/64
  ansible.builtin.set_fact:
    data: "{{ '2001:db8:a::123' is ansible.utils.in_network '2001:db8:a::/64' }}"

# TASK [Check if 2001:db8:a::123 is in 2001:db8:a::/64] ****************************
# task path: /home/prsahoo/playbooks/collections/localhost_test/utils_in_network.yml:16
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

- name: Check if 2001:db8:a::123 is not in 10.0.0.0/8
  ansible.builtin.set_fact:
    data: "{{ '2001:db8:a::123' is not ansible.utils.in_network '10.0.0.0/8' }}"

# TASK [Check if 2001:db8:a::123 is not in 10.0.0.0/8] *********************************
# task path: /home/prsahoo/playbooks/collections/localhost_test/utils_in_network.yml:20
# ok: [localhost] => {
#     "ansible_facts": {
#         "data": true
#     },
#     "changed": false
# }

返回值

键

描述

数据

字符串

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

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

返回：成功

作者

  • Priyam Sahoo (@priyamsahoo)

提示

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