Руководство по 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 модули в playbooks, необходимо настроить данные учетных записей для доступа к вашей системе 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 сохраняет информацию в переменных, которые можно использовать в других playbooks. Это позволяет использовать Infoblox как единый источник истины для сбора и использования динамически изменяемой информации. Дополнительную информацию об использовании переменных Ansible см. в разделе Использование переменных. См. примеры nios для получения дополнительной информации о доступных вариантах данных для извлечения.

Эти playbooks доступны по адресу Infoblox lookup playbooks.

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

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