Руководство по Infoblox

• Предварительные требования
• Данные для входа и аутентификация
• Плагины поиска NIOS
  • Получение всех сетевых представлений
  • Получение записи о хосте
• Примеры использования модулей
  • Настройка сети IPv4
  • Создание записи о хосте
  • Создание зоны прямого DNS
  • Создание зоны обратного DNS
• Сценарий динамического инвентаризации

Это руководство описывает, как использовать Ansible с Infoblox Network Identity Operating System (NIOS). С помощью интеграции Ansible вы можете использовать Ansible playbook для автоматизации Infoblox Core Network Services для управления IP-адресами (IPAM), DNS и отслеживания инвентаризации.

Вы можете ознакомиться с простыми примерами задач в документации по любому из модулей NIOS или посмотреть раздел Примеры использования модулей для более подробных примеров. Подробнее об продукте Infoblox см. на веб-сайте Infoblox.

Предварительные требования

Перед использованием Ansible nios модулей с Infoblox необходимо установить infoblox-client на узле управления Ansible:

$ sudo pip install infoblox-client

Данные для входа и аутентификация

Для использования Infoblox nios модулей в playbook необходимо настроить данные для входа для доступа к вашей системе Infoblox. В примерах этого руководства используются данные для входа, хранящиеся в <playbookdir>/group_vars/nios.yml. Замените эти значения своими учетными данными Infoblox:

---
nios_provider:
  host: 192.0.0.2
  username: admin
  password: ansible

Плагины поиска NIOS

Ansible включает следующие плагины поиска для NIOS:

• nios Использует API Infoblox WAPI для получения указанных объектов NIOS, например, сетевых представлений, представлений DNS и записей о хостах.
• nios_next_ip Предоставляет следующий доступный IP-адрес из сети. Вы увидите пример этого в Создание записи о хосте.
• nios_next_network - Возвращает следующий доступный диапазон сети для сетевого контейнера.

Вы должны запустить плагины поиска NIOS локально, указав connection: local. Более подробную информацию см. в плагинах поиска.

Получение всех сетевых представлений

Для получения всех сетевых представлений и сохранения их в переменной используйте модуль set_fact с плагином поиска nios:

---
- hosts: nios
  connection: local
  tasks:
    - name: fetch all networkview objects
      set_fact:
        networkviews: "{{ lookup('nios', 'networkview', provider=nios_provider) }}"

    - name: check the networkviews
      debug:
        var: networkviews

Получение записи о хосте

Для получения набора записей о хостах используйте модуль set_fact с плагином поиска nios и включите фильтр для конкретных хостов, которые вы хотите получить:

---
- hosts: nios
  connection: local
  tasks:
    - name: fetch host leaf01
      set_fact:
         host: "{{ lookup('nios', 'record:host', filter={'name': 'leaf01.ansible.com'}, provider=nios_provider) }}"

    - name: check the leaf01 return variable
      debug:
        var: host

    - name: debug specific variable (ipv4 address)
      debug:
        var: host.ipv4addrs[0].ipv4addr

    - name: fetch host leaf02
      set_fact:
        host: "{{ lookup('nios', 'record:host', filter={'name': 'leaf02.ansible.com'}, provider=nios_provider) }}"

    - name: check the leaf02 return variable
      debug:
        var: host

Если вы запустите этот get_host_record.yml playbook, вы увидите результаты, похожие на следующие:

$ ansible-playbook get_host_record.yml

PLAY [localhost] ***************************************************************************************

TASK [fetch host leaf01] ******************************************************************************
ok: [localhost]

TASK [check the leaf01 return variable] *************************************************************
ok: [localhost] => {
< ...output shortened...>
    "host": {
        "ipv4addrs": [
            {
                "configure_for_dhcp": false,
                "host": "leaf01.ansible.com",
            }
        ],
        "name": "leaf01.ansible.com",
        "view": "default"
    }
}

TASK [debug specific variable (ipv4 address)] ******************************************************
ok: [localhost] => {
    "host.ipv4addrs[0].ipv4addr": "192.168.1.11"
}

TASK [fetch host leaf02] ******************************************************************************
ok: [localhost]

TASK [check the leaf02 return variable] *************************************************************
ok: [localhost] => {
< ...output shortened...>
    "host": {
        "ipv4addrs": [
            {
                "configure_for_dhcp": false,
                "host": "leaf02.example.com",
                "ipv4addr": "192.168.1.12"
            }
        ],
    }
}

PLAY RECAP ******************************************************************************************
localhost                  : ok=5    changed=0    unreachable=0    failed=0

Вывод выше отображает запись о хосте для leaf01.ansible.com и leaf02.ansible.com, которые были получены плагином поиска nios. Этот playbook сохраняет информацию в переменных, которые вы можете использовать в других playbook. Это позволяет использовать Infoblox как единый источник истины для сбора и использования динамически изменяющейся информации. Подробнее об использовании переменных Ansible см. в Использование переменных. Более подробные данные, которые вы можете получить, см. в примерах nios.

Вы можете получить доступ к этим playbook по адресу Infoblox playbook поиска.

Примеры использования модулей

Вы можете использовать nios модули в задачах для упрощения распространенных рабочих процессов Infoblox. Не забудьте настроить свои данные для входа в NIOS перед выполнением этих примеров.

Настройка сети IPv4

Для настройки сети IPv4 используйте модуль nios_network:

---
- hosts: nios
  connection: local
  tasks:
    - name: Create a network on the default network view
      nios_network:
        network: 192.168.100.0/24
        comment: sets the IPv4 network
        options:
          - name: domain-name
            value: ansible.com
        state: present
        provider: "{{nios_provider}}"

Обратите внимание на последний параметр, provider, использующий переменную nios_provider, определенную в каталоге group_vars/.

Создание записи о хосте

Чтобы создать запись о хосте с именем leaf03.ansible.com в новой сети IPv4:

---
- hosts: nios
  connection: local
  tasks:
    - name: configure an IPv4 host record
      nios_host_record:
        name: leaf03.ansible.com
        ipv4addrs:
          - ipv4addr:
              "{{ lookup('nios_next_ip', '192.168.100.0/24', provider=nios_provider)[0] }}"
        state: present
provider: "{{nios_provider}}"

Обратите внимание, что IP-адрес в этом примере использует плагин поиска nios_next_ip для поиска следующего доступного IP-адреса в сети.

Создание зоны прямого DNS

Для настройки зоны прямого DNS используйте модуль nios_zone:

---
- hosts: nios
  connection: local
  tasks:
    - name: Create a forward DNS zone called ansible-test.com
      nios_zone:
        name: ansible-test.com
        comment: local DNS zone
        state: present
        provider: "{{ nios_provider }}"

Создание зоны обратного DNS

Для настройки зоны обратного DNS:

---
- hosts: nios
  connection: local
  tasks:
    - name: configure a reverse mapping zone on the system using IPV6 zone format
      nios_zone:
        name: 100::1/128
        zone_format: IPV6
        state: present
        provider: "{{ nios_provider }}"

Сценарий динамического инвентаризации

Вы можете использовать сценарий динамической инвентаризации Infoblox для импорта инвентаризации узлов вашей сети с Infoblox NIOS. Для сбора инвентаризации из Infoblox вам потребуются два файла:

• infoblox.yaml - файл, который задает аргументы поставщика NIOS и необязательные фильтры.
• infoblox.py - скрипт Python, который получает инвентаризацию NIOS.

Чтобы использовать сценарий динамической инвентаризации Infoblox:

1. Скачайте файл infoblox.yaml и сохраните его в каталоге /etc/ansible.
2. Измените файл infoblox.yaml со своими учетными данными NIOS.
3. Скачайте файл infoblox.py и сохраните его в каталоге /etc/ansible/hosts.
4. Измените разрешения на файл infoblox.py и сделайте его исполняемым:

$ sudo chmod +x /etc/ansible/hosts/infoblox.py

Вы можете (необязательно) использовать ./infoblox.py --list для проверки сценария. Через несколько минут вы увидите вашу инвентаризацию Infoblox в формате JSON. Вы можете явно использовать сценарий динамической инвентаризации Infoblox следующим образом:

$ ansible -i infoblox.py all -m ping

Вы также можете неявно использовать сценарий динамической инвентаризации Infoblox, включив его в каталог инвентаризации (etc/ansible/hosts по умолчанию). Дополнительные сведения см. в Работа с динамической инвентаризацией.