Infoblox NIOS Modules for Ansible Collections enable the management of your NIOS objects through APIs.
Infoblox NIOS Modules for Ansible Collections facilitate the DNS and IPAM automation of
VM workloads that are deployed across multiple platforms. The nios_modules
collection consists of modules and plug-ins required to manage the networks,
IP addresses, and DNS records in NIOS. The collection is hosted on Ansible Galaxy under infoblox.nios_modules
.
The infoblox.nios_modules
collection has the following content:
nios_a_record
– Configure Infoblox NIOS A recordsnios_aaaa_record
– Configure Infoblox NIOS AAAA recordsnios_cname_record
– Configure Infoblox NIOS CNAME recordsnios_dns_view
– Configure Infoblox NIOS DNS viewsnios_dtc_lbdn
– Configure Infoblox NIOS DTC LBDN recordsnios_dtc_monitor_http
– Configure Infoblox NIOS DTC HTTP monitorsnios_dtc_monitor_icmp
– Configure Infoblox NIOS DTC ICMP monitorsnios_dtc_monitor_pdp
– Configure Infoblox NIOS DTC PDP monitorsnios_dtc_monitor_sip
– Configure Infoblox NIOS DTC SIP monitorsnios_dtc_monitor_snmp
– Configure Infoblox NIOS DTC SNMP monitorsnios_dtc_monitor_tcp
– Configure Infoblox NIOS DTC TCP monitorsnios_dtc_pool
– Configure Infoblox NIOS DTC poolsnios_dtc_server
– Configure Infoblox NIOS DTC server recordsnios_dtc_topology
– Configure Infoblox NIOS DTC topologiesnios_extensible_attribute
- Configure Infoblox NIOS extensible attributesnios_fixed_address
– Configure Infoblox NIOS DHCP Fixed Addressnios_host_record
– Configure Infoblox NIOS host recordsnios_member
– Configure Infoblox NIOS membersnios_mx_record
– Configure Infoblox NIOS MX recordsnios_naptr_record
– Configure Infoblox NIOS NAPTR recordsnios_network
– Configure Infoblox NIOS network objectnios_network_view
– Configure Infoblox NIOS network viewsnios_nsgroup
– Configure Infoblox DNS Authoritative Name server Groupsnios_nsgroup_delegation
– Configure Infoblox DNS Delegation Name server Groupsnios_nsgroup_forwardingmember
– Configure Infoblox DNS Forwarding Member Name server Groupsnios_nsgroup_forwardstubserver
– Configure Infoblox DNS Forward/Stub Server Name server Groupsnios_nsgroup_stubmember
– Configure Infoblox DNS Stub Member Name server Groupsnios_ptr_record
– Configure Infoblox NIOS PTR recordsnios_range
- Configure Infoblox NIOS Network Range objectnios_restartservices
- Controlled restart of Infoblox NIOS servicesnios_srv_record
– Configure Infoblox NIOS SRV recordsnios_txt_record
– Configure Infoblox NIOS txt recordsnios_vlan
– Configure Infoblox NIOS vlannios_zone
– Configure Infoblox NIOS DNS zones
nios_inventory
: List all the hosts with records created in NIOSnios_lookup
: Look up queries for NIOS database objectsnios_next_ip
: Return the next available IP address for a networknios_next_network
: Return the next available network addresses for a given network CIDR
- Python version 3.10 or later
- Ansible Core version 2.15 or later
- NIOS 8.6.x and 9.0.x
- Infoblox WAPI version 2.12.3 or later
- Python module infoblox-client version 0.6.0
Install the infoblox-client WAPI package. To install, run the following command:
pip install infoblox-client==0.6.0
To install nios module with the Ansible Galaxy command-line tool:
ansible-galaxy collection install infoblox.nios_modules
You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml
, using the format:
collections:
- name: infoblox.nios_modules
Note that if you install any collection from Ansible Galaxy, they will not be upgraded automatically when you upgrade the Ansible package. To upgrade the collection to the latest available version, run the following command:
ansible-galaxy collection install infoblox.nios_modules --upgrade
You can also install a specific version of the collection. For example, due to an issue of the latest version, if you need to downgrade the collection to a prior version, use the following command to install the specific version:
ansible-galaxy collection install infoblox.nios_modules:==<version>
See using Ansible collections for more details.
- Install the collection directly from the GitHub repository using the latest commit on the master branch:
$ ansible-galaxy collection install git+https://github.com/infobloxopen/infoblox-ansible.git,master
-
For offline installation on the Ansible control machine, follow the below steps to clone the git repository and install from the repository:
-
Clone the repo:
$ git clone https://github.com/infobloxopen/infoblox-ansible.git
-
Build the collection: To build a collection, run the following command from inside the root directory of the collection:
$ ansible-galaxy collection build
This creates a tarball of the built collection in the current directory.
-
Install the collection:
$ ansible-galaxy collection install infoblox-nios_modules-<version>.tar.gz -p ./collections
-
Please refer to our Ansible deployment guide for more details.
Description: Automatically create, update, and delete DNS records in Infoblox NIOS based on changes in your infrastructure.
Example:
- name: Create a DNS A record
infoblox.nios_modules.nios_a_record:
name: "host.example.com"
ipv4addr: "192.168.1.10"
state: "present"
Description: Dynamically allocate and manage IP addresses for virtual machines and other devices in your network.
Example:
- name: Allocate an IP address
infoblox.nios_modules.nios_fixed_address:
ipv4addr: "192.168.1.20"
mac: "00:50:56:00:00:01"
state: "present"
Description: Create and manage network segments and subnets within Infoblox NIOS.
Example:
- name: Create a network
infoblox.nios_modules.nios_network:
network: "192.168.2.0/24"
comment: "Development network"
state: "present"
Description: Manage DHCP scopes to ensure efficient IP address distribution and avoid conflicts.
Example:
- name: Create a DHCP range
infoblox.nios_modules.nios_range:
network: "192.168.3.0/24"
start_addr: "192.168.3.10"
end_addr: "192.168.3.100"
state: "present"
Description: Manage DNS Traffic Control (DTC) objects to optimize traffic distribution and ensure high availability.
Example:
- name: Create a DTC Pool
infoblox.nios_modules.nios_dtc_pool:
name: "example_pool"
lb_method: "round_robin"
state: "present"
Description: Perform lookups to retrieve information about existing NIOS objects.
Example:
- name: fetch the default dns view
ansible.builtin.set_fact:
dns_views: "{{ lookup('infoblox.nios_modules.nios_lookup', 'view', filter={'name': 'default'},
provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"
Description: Retrieve the next available IP address or network in a specified range or network.
Example:
- name: return next available IP address for network 192.168.10.0/24
ansible.builtin.set_fact:
ipaddr: "{{ lookup('infoblox.nios_modules.nios_next_ip', '192.168.10.0/24', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"
For more detailed examples and playbooks, refer to the playbooks
directory in the infoblox-ansible
repository.
The collection has been tested in the following environments:
-
Operating Systems:
- Ubuntu 20.04 LTS
- Mac
-
Ansible Versions:
- Ansible Core 2.15
- Ansible Core 2.16
- Ansible Core 2.17
-
NIOS Versions:
- NIOS 8.6.x
- NIOS 9.0.x
For detailed information on testing and performance, refer to the tests
directory in the infoblox-ansible
repository.
We welcome your contributions to Infoblox Nios Modules. See CONTRIBUTING.md for more details.
Infoblox NIOS Modules for Ansible Collections supports the following versions:
- NIOS Versions: 8.6.x and 9.0.x
- Ansible Core Versions: 2.15 and later
- Python Versions: 3.10 and later
If you need assistance with the Infoblox NIOS Modules, you can get support through the following channels:
-
GitHub Issues:
- Submit your issues or requests for enhancements on the GitHub Issues page.
-
Infoblox Support:
- For enterprise support, contact Infoblox Support through the Infoblox Support Portal.
For any other inquiries, please refer to the Infoblox Contact Page.
For detailed information about the latest updates, new features, bug fixes, and improvements, please visit our Changelog.
For more detailed documentation and examples, refer to the following resources:
- Infoblox NIOS modules on Ansible documentation
- Infoblox workspace in Ansible Galaxy
- Infoblox Ansible deployment guide
- CONTRIBUTING.md for contribution guidelines
This code is published under GPL v3.0
COPYING
You can open an issue or request for enhancement here