Руководство по 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 доступны по адресу playbook Infoblox lookup.

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

Модули 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). Дополнительную информацию см. в разделе Работа с динамической инвентаризацией.