community.general.nios_network – Настройка объекта сети Infoblox NIOS

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.nios_network.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Добавляет и/или удаляет экземпляры объектов сети на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS network с использованием интерфейса Infoblox WAPI через REST.
Поддерживает оба интернет-протокола IPV4 и IPV6

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает строку комментария, которая будет связана с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта.
container логическое значение		Варианты: no yes	Если установлено в значение true, будет создан контейнер сети для добавления или удаления из системы.
extattrs словарь			Позволяет настроить расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
network строка / обязательно			Указывает сеть для добавления или удаления из системы. Значение должно использовать нотацию CIDR. псевдонимы: name, cidr
network_view строка		Значение по умолчанию: "default"	Настраивает имя представления сети, которое нужно ассоциировать с этим экземпляром.
options список / элементы=словарь			Настраивает набор опций DHCP, которые необходимо включить в качестве части настроенного экземпляра сети. Этот аргумент принимает список значений (см. подопции). При настройке подопций, по крайней мере, одно из `name` или `num` должно быть указано.
	name строка		Имя опции DHCP для настройки. Стандартные опции - `router`, `router-templates`, `domain-name-servers`, `domain-name`, `broadcast-address`, `broadcast-address-offset`, `dhcp-lease-time`, и `dhcp6.name-servers`.
	num целое число		Номер опции DHCP для настройки.
	use_option логическое значение	Варианты: no yes ←	Применяется только к подмножеству опций (см. документацию API NIOS).
	value строка / обязательно		Значение опции DHCP, указанной в `name`.
	vendor_class строка	Значение по умолчанию: "DHCP"	Имя пространства, к которому относится эта опция DHCP.
provider словарь			Объект словаря, содержащий данные подключения.
	host строка		Указывает имя хоста DNS или адрес для подключения к удалённому экземпляру NIOS WAPI через REST. Значение также может быть указано с помощью `INFOBLOX_HOST` переменной окружения.
	http_pool_connections целое число	Значение по умолчанию: 10	Количество пулов, которые будут использоваться объектом `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	http_pool_maxsize целое число	Значение по умолчанию: 10	Максимальное количество подключений на пул, которые будут использоваться объектом `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	http_request_timeout целое число	Значение по умолчанию: 10	Время ожидания получения ответа. Значение также может быть указано с помощью `INFOBLOX_HTTP_REQUEST_TIMEOUT` переменной окружения.
	max_results целое число	Значение по умолчанию: 1000	Указывает максимальное количество объектов, которые должны быть возвращены. Если установлено отрицательное число, прибор вернёт ошибку, если количество возвращённых объектов превысит установленное значение. Значение также может быть указано с помощью `INFOBLOX_MAX_RESULTS` переменной окружения.
	max_retries целое число	Значение по умолчанию: 3	Настраивает количество попыток повтора, прежде чем подключение будет объявлено работоспособным. Значение также может быть указано с помощью `INFOBLOX_MAX_RETRIES` переменной окружения.
	password строка		Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью `INFOBLOX_PASSWORD` переменной окружения.
	silent_ssl_warnings логическое значение	Варианты: no yes ←	Отключить `urllib3` предупреждения SSL в объекте `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью `INFOBLOX_USERNAME` переменной окружения.
	validate_certs логическое значение	Варианты: no ← yes	Логическое значение для включения или отключения проверки сертификатов SSL. Значение также может быть указано с помощью `INFOBLOX_SSL_VERIFY` переменной окружения. псевдонимы: ssl_verify
	wapi_version строка	Значение по умолчанию: "2.1"	Указывает версию WAPI для использования. Значение также может быть указано с помощью `INFOBLOX_WAP_VERSION` переменной окружения. До версии Ansible 2.8 по умолчанию использовалась версия WAPI 1.4
state строка		Варианты: present ← absent	Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.

Примечания

Примечание

Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
Пожалуйста, ознакомьтесь с Руководством по Infoblox для получения более подробной информации о том, как использовать Infoblox с Ansible.

Примеры

- name: Configure a network ipv4
  community.general.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Configure a network ipv6
  community.general.nios_network:
    network: fe80::/64
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Set dhcp options for a network ipv4
  community.general.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    options:
      - name: domain-name
        value: ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove a network ipv4
  community.general.nios_network:
    network: 192.168.10.0/24
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Configure a ipv4 network container
  community.general.nios_network:
    network: 192.168.10.0/24
    container: true
    comment: test network container
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Configure a ipv6 network container
  community.general.nios_network:
    network: fe80::/64
    container: true
    comment: test network container
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove a ipv4 network container
  community.general.nios_network:
    networkr: 192.168.10.0/24
    container: true
    comment: test network container
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Peter Sprygada (@privateip)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nios_network_module.html