Spec-Zone.ru › Ansible 2.11

community.general.nios_fixed_address – Настройка фиксированного адреса DHCP Infoblox NIOS

Примечание

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

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

Для использования в плейбуке укажите: community.general.nios_fixed_address.

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

Обзор

  • Фиксированный адрес — это определённый IP-адрес, который DHCP-сервер всегда назначает при запросе аренды от конкретного MAC-адреса клиента.
  • Поддерживает оба интернет-протокола IPV4 и IPV6

Требования

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

  • infoblox-client

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
comment
строка
Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка будет настроена в экземпляре объекта.
extattrs
словарь
Позволяет настроить расширенные атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
ipaddr
строка / обязательно
IPV4/V6 адрес фиксированного адреса.
mac
строка / обязательно
MAC-адрес интерфейса.
name
строка / обязательно
Указывает имя хоста, с которым фиксированный DHCP ip-адрес хранится для соответствующего mac.
network
строка / обязательно
Указывает диапазон сети, в котором существует ipaddr.
network_view
строка
Значение по умолчанию:
"default"
Настраивает имя сетевого представления, которое нужно ассоциировать с этим экземпляром.
options
список / элементы=словарь
Настраивает набор DHCP-параметров, которые нужно включить как часть настроенного экземпляра сети. Этот аргумент принимает список значений (см. подпараметры). При настройке подпараметров, по крайней мере, один из name или num должен быть указан.
name
строка
Имя DHCP-параметра для настройки
num
целое число
Номер DHCP-параметра для настройки
use_option
логическое значение
    Варианты:
  • нет
  • да ←
Применимо только к подмножеству параметров (см. документацию 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
логическое значение
    Варианты:
  • нет
  • да ←
Отключить urllib3 предупреждения SSL в объекте infoblox_client.Connector.
Это передаётся как есть подлежащему классу requests.adapters.HTTPAdapter.
username
строка
Настраивает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS.
Значение также можно указать, используя INFOBLOX_USERNAME переменную среды.
validate_certs
логическое значение
    Варианты:
  • нет ←
  • да
Логическое значение для включения или отключения проверки сертификатов 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 с Ansible, обратитесь к руководству Infoblox Guide.

Примеры

- name: Configure ipv4 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Configure a ipv6 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv6_fixed
    ipaddr: fe80::1/10
    mac: 08:6d:41:e8:fd:e8
    network: fe80::/64
    network_view: default
    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 ipv4 fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    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 ipv4 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

  • Sumit Jaiswal (@sjaiswal)

© 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_fixed_address_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API