From 5c3e9fb3ea23adc43345ff1ab7db9c6c3a099a8a Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 09:40:17 +0530 Subject: [PATCH 1/9] Added FQCN in examples --- .../plugins/lookup/nios_lookup.py | 25 ++++++++++--------- .../plugins/lookup/nios_next_ip.py | 13 +++++----- .../plugins/lookup/nios_next_network.py | 13 +++++----- 3 files changed, 27 insertions(+), 24 deletions(-) diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py index 815c06d4..7e28c21a 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py @@ -32,12 +32,13 @@ EXAMPLES = """ - name: fetch all networkview objects - set_fact: - networkviews: "{{ lookup('nios', 'networkview', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" + ansible.builtin.set_fact: + networkviews: "{{ lookup('infoblox.nios_modules.nios', 'networkview', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" - name: fetch the default dns view - set_fact: - dns_views: "{{ lookup('nios', 'view', filter={'name': 'default'}, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" + ansible.builtin.set_fact: + dns_views: "{{ lookup('infoblox.nios_modules.nios', 'view', filter={'name': 'default'}, + provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" # all of the examples below use credentials that are set using env variables # export INFOBLOX_HOST=nios01 @@ -45,21 +46,21 @@ # export INFOBLOX_PASSWORD=admin - name: fetch all host records and include extended attributes - set_fact: - host_records: "{{ lookup('nios', 'record:host', return_fields=['extattrs', 'name', 'view', 'comment']}) }}" + ansible.builtin.set_fact: + host_records: "{{ lookup('infoblox.nios_modules.nios', 'record:host', return_fields=['extattrs', 'name', 'view', 'comment']}) }}" - name: use env variables to pass credentials - set_fact: - networkviews: "{{ lookup('nios', 'networkview') }}" + ansible.builtin.set_fact: + networkviews: "{{ lookup('infoblox.nios_modules.nios', 'networkview') }}" - name: get a host record - set_fact: - host: "{{ lookup('nios', 'record:host', filter={'name': 'hostname.ansible.com'}) }}" + ansible.builtin.set_fact: + host: "{{ lookup('infoblox.nios_modules.nios', 'record:host', filter={'name': 'hostname.ansible.com'}) }}" - name: get the authoritative zone from a non default dns view - set_fact: - host: "{{ lookup('nios', 'zone_auth', filter={'fqdn': 'ansible.com', 'view': 'ansible-dns'}) }}" + ansible.builtin.set_fact: + host: "{{ lookup('infoblox.nios_modules.nios', 'zone_auth', filter={'fqdn': 'ansible.com', 'view': 'ansible-dns'}) }}" """ RETURN = """ diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py index 2d3fd6b1..a0179052 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py @@ -32,16 +32,17 @@ EXAMPLES = """ - name: return next available IP address for network 192.168.10.0/24 - set_fact: - ipaddr: "{{ lookup('nios_next_ip', '192.168.10.0/24', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" + ansible.builtin.set_fact: + ipaddr: "{{ lookup('infoblox.nios_modules.nios_next_ip', '192.168.10.0/24', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" - name: return the next 3 available IP addresses for network 192.168.10.0/24 - set_fact: - ipaddr: "{{ lookup('nios_next_ip', '192.168.10.0/24', num=3, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" + ansible.builtin.set_fact: + ipaddr: "{{ lookup('infoblox.nios_modules.nios_next_ip', '192.168.10.0/24', num=3, + provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" - name: return the next 3 available IP addresses for network 192.168.10.0/24 excluding ip addresses - ['192.168.10.1', '192.168.10.2'] - set_fact: - ipaddr: "{{ lookup('nios_next_ip', '192.168.10.0/24', num=3, exclude=['192.168.10.1', '192.168.10.2'], + ansible.builtin.set_fact: + ipaddr: "{{ lookup('infoblox.nios_modules.nios_next_ip', '192.168.10.0/24', num=3, exclude=['192.168.10.1', '192.168.10.2'], provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" """ diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py index c4fecc62..a0728477 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py @@ -40,17 +40,18 @@ EXAMPLES = """ - name: return next available network for network-container 192.168.10.0/24 - set_fact: - networkaddr: "{{ lookup('nios_next_network', '192.168.10.0/24', cidr=25, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" + ansible.builtin.set_fact: + networkaddr: "{{ lookup('infoblox.nios_modules.nios_next_network', '192.168.10.0/24', cidr=25, + provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" - name: return the next 2 available network addresses for network-container 192.168.10.0/24 - set_fact: - networkaddr: "{{ lookup('nios_next_network', '192.168.10.0/24', cidr=25, num=2, + ansible.builtin.set_fact: + networkaddr: "{{ lookup('infoblox.nios_modules.nios_next_network', '192.168.10.0/24', cidr=25, num=2, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" - name: return the available network addresses for network-container 192.168.10.0/24 excluding network range '192.168.10.0/25' - set_fact: - networkaddr: "{{ lookup('nios_next_network', '192.168.10.0/24', cidr=25, exclude=['192.168.10.0/25'], + ansible.builtin.set_fact: + networkaddr: "{{ lookup('infoblox.nios_modules.nios_next_network', '192.168.10.0/24', cidr=25, exclude=['192.168.10.0/25'], provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}" """ From 4a5f5b3bcfd8fca668ca46e58cfecb950d774700 Mon Sep 17 00:00:00 2001 From: Anagha K H <70952486+anagha-infoblox@users.noreply.github.com> Date: Mon, 12 Apr 2021 12:53:15 +0530 Subject: [PATCH 2/9] Update ansible-test.yml --- .github/workflows/ansible-test.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/ansible-test.yml b/.github/workflows/ansible-test.yml index 15566864..1d295e6b 100644 --- a/.github/workflows/ansible-test.yml +++ b/.github/workflows/ansible-test.yml @@ -22,6 +22,7 @@ jobs: # Testing against `devel` may fail as new tests are added. - stable-2.9 - stable-2.10 + - stable-2.11 - devel runs-on: ubuntu-latest steps: From 9d87a96a88ddaa12f128aa73e4f60ddd111032b4 Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 16:43:52 +0530 Subject: [PATCH 3/9] Added the parameter version_added in the documentation of modules --- .../infoblox/nios_modules/plugins/inventory/nios_inventory.py | 2 +- .../infoblox/nios_modules/plugins/lookup/nios_lookup.py | 1 + .../infoblox/nios_modules/plugins/lookup/nios_next_ip.py | 1 + .../infoblox/nios_modules/plugins/lookup/nios_next_network.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_a_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_aaaa_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_cname_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_dns_view.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_dtc_pool.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_dtc_server.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_fixed_address.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_host_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_member.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_mx_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_naptr_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_network.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_network_view.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_nsgroup.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_ptr_record.py | 1 + .../nios_modules/plugins/modules/nios_restartservices.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_srv_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_txt_record.py | 1 + .../infoblox/nios_modules/plugins/modules/nios_zone.py | 1 + 24 files changed, 24 insertions(+), 1 deletion(-) diff --git a/ansible_collections/infoblox/nios_modules/plugins/inventory/nios_inventory.py b/ansible_collections/infoblox/nios_modules/plugins/inventory/nios_inventory.py index 32470c2a..c88a3576 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/inventory/nios_inventory.py +++ b/ansible_collections/infoblox/nios_modules/plugins/inventory/nios_inventory.py @@ -10,7 +10,7 @@ author: - Will Tome (@willtome) short_description: Infoblox inventory plugin - version_added: "2.10" + version_added: "1.0.0" description: - Infoblox inventory plugin options: diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py index 7e28c21a..d67690c2 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_lookup.py @@ -11,6 +11,7 @@ --- lookup: nios short_description: Query Infoblox NIOS objects +version_added: "1.0.0" description: - Uses the Infoblox WAPI API to fetch NIOS specified objects. This lookup supports adding additional keywords to filter the return data and specify diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py index a0179052..eab755fc 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_ip.py @@ -11,6 +11,7 @@ --- lookup: nios_next_ip short_description: Return the next available IP address for a network +version_added: "1.0.0" description: - Uses the Infoblox WAPI API to return the next available IP addresses for a given network CIDR diff --git a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py index a0728477..cbb0723a 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py +++ b/ansible_collections/infoblox/nios_modules/plugins/lookup/nios_next_network.py @@ -11,6 +11,7 @@ --- lookup: nios_next_network short_description: Return the next available network range for a network-container +version_added: "1.0.0" description: - Uses the Infoblox WAPI API to return the next available network addresses for a given network CIDR diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_a_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_a_record.py index f9bf4080..3363c4d2 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_a_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_a_record.py @@ -11,6 +11,7 @@ module: nios_a_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS A records +version_added: "1.0.0" description: - Adds and/or removes instances of A record objects from Infoblox NIOS servers. This module manages NIOS C(record:a) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_aaaa_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_aaaa_record.py index e1fa2df2..2ce22a02 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_aaaa_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_aaaa_record.py @@ -11,6 +11,7 @@ module: nios_aaaa_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS AAAA records +version_added: "1.0.0" description: - Adds and/or removes instances of AAAA record objects from Infoblox NIOS servers. This module manages NIOS C(record:aaaa) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_cname_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_cname_record.py index 4594876c..c732c131 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_cname_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_cname_record.py @@ -11,6 +11,7 @@ module: nios_cname_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS CNAME records +version_added: "1.0.0" description: - Adds and/or removes instances of CNAME record objects from Infoblox NIOS servers. This module manages NIOS C(record:cname) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dns_view.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dns_view.py index a3a7a603..4265e6f2 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dns_view.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dns_view.py @@ -11,6 +11,7 @@ module: nios_dns_view author: "Peter Sprygada (@privateip)" short_description: Configure Infoblox NIOS DNS views +version_added: "1.0.0" description: - Adds and/or removes instances of DNS view objects from Infoblox NIOS servers. This module manages NIOS C(view) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py index 2f5688a3..927e22a4 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py @@ -10,6 +10,7 @@ --- module: nios_dtc_lbdn author: "Mauricio Teixeira (@badnetmask)" +version_added: "1.0.3" short_description: Configure Infoblox NIOS DTC LBDN description: - Adds and/or removes instances of DTC Load Balanced Domain Name (LBDN) diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py index a1a38c45..4a58f245 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py @@ -10,6 +10,7 @@ --- module: nios_dtc_pool author: "Mauricio Teixeira (@badnetmask)" +version_added: "1.0.3" short_description: Configure Infoblox NIOS DTC Pool description: - Adds and/or removes instances of DTC Pool objects from diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py index d998cd56..ebd068a1 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py @@ -11,6 +11,7 @@ module: nios_dtc_server author: "Mauricio Teixeira (@badnetmask)" short_description: Configure Infoblox NIOS DTC Server +version_added: "1.0.3" description: - Adds and/or removes instances of DTC Server objects from Infoblox NIOS servers. This module manages NIOS C(dtc:server) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_fixed_address.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_fixed_address.py index 249085cd..ac855f31 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_fixed_address.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_fixed_address.py @@ -11,6 +11,7 @@ module: nios_fixed_address author: "Sumit Jaiswal (@sjaiswal)" short_description: Configure Infoblox NIOS DHCP Fixed Address +version_added: "1.0.0" description: - A fixed address is a specific IP address that a DHCP server always assigns when a lease request comes from a particular diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_host_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_host_record.py index 2f5f1319..bcc43def 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_host_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_host_record.py @@ -11,6 +11,7 @@ module: nios_host_record author: "Peter Sprygada (@privateip)" short_description: Configure Infoblox NIOS host records +version_added: "1.0.0" description: - Adds and/or removes instances of host record objects from Infoblox NIOS servers. This module manages NIOS C(record:host) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_member.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_member.py index f750f9f5..20718a39 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_member.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_member.py @@ -11,6 +11,7 @@ module: nios_member author: "Krishna Vasudevan (@krisvasudevan)" short_description: Configure Infoblox NIOS members +version_added: "1.0.0" description: - Adds and/or removes Infoblox NIOS servers. This module manages NIOS C(member) objects using the Infoblox WAPI interface over REST. requirements: diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_mx_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_mx_record.py index e4c8b822..d67b2afc 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_mx_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_mx_record.py @@ -11,6 +11,7 @@ module: nios_mx_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS MX records +version_added: "1.0.0" description: - Adds and/or removes instances of MX record objects from Infoblox NIOS servers. This module manages NIOS C(record:mx) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_naptr_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_naptr_record.py index b4050a60..8d5c4914 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_naptr_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_naptr_record.py @@ -11,6 +11,7 @@ module: nios_naptr_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS NAPTR records +version_added: "1.0.0" description: - Adds and/or removes instances of NAPTR record objects from Infoblox NIOS servers. This module manages NIOS C(record:naptr) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network.py index 8b1f953f..39b973fa 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network.py @@ -11,6 +11,7 @@ module: nios_network author: "Peter Sprygada (@privateip)" short_description: Configure Infoblox NIOS network object +version_added: "1.0.0" description: - Adds and/or removes instances of network objects from Infoblox NIOS servers. This module manages NIOS C(network) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network_view.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network_view.py index 35bd5b09..5952cc19 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network_view.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_network_view.py @@ -11,6 +11,7 @@ module: nios_network_view author: "Peter Sprygada (@privateip)" short_description: Configure Infoblox NIOS network views +version_added: "1.0.0" description: - Adds and/or removes instances of network view objects from Infoblox NIOS servers. This module manages NIOS C(networkview) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_nsgroup.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_nsgroup.py index d26d98d8..a4aeff7c 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_nsgroup.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_nsgroup.py @@ -12,6 +12,7 @@ --- module: nios_nsgroup short_description: Configure InfoBlox DNS Nameserver Groups +version_added: "1.0.0" extends_documentation_fragment: infoblox.nios_modules.nios author: - Erich Birngruber (@ebirn) diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_ptr_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_ptr_record.py index f41bf901..e6f36dac 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_ptr_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_ptr_record.py @@ -11,6 +11,7 @@ module: nios_ptr_record author: "Trebuchet Clement (@clementtrebuchet)" short_description: Configure Infoblox NIOS PTR records +version_added: "1.0.0" description: - Adds and/or removes instances of PTR record objects from Infoblox NIOS servers. This module manages NIOS C(record:ptr) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py index de87ab93..219272d2 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py @@ -11,6 +11,7 @@ module: nios_restartservices author: "Mauricio Teixeira (@badnetmask)" short_description: Restart grid services. +version_added: "1.0.3" description: - Restart grid services. - When invoked without any options, will restart ALL services on the diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_srv_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_srv_record.py index 235b1a9a..55bf705c 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_srv_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_srv_record.py @@ -11,6 +11,7 @@ module: nios_srv_record author: "Blair Rampling (@brampling)" short_description: Configure Infoblox NIOS SRV records +version_added: "1.0.0" description: - Adds and/or removes instances of SRV record objects from Infoblox NIOS servers. This module manages NIOS C(record:srv) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_txt_record.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_txt_record.py index 525ca19a..ab4eb47a 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_txt_record.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_txt_record.py @@ -11,6 +11,7 @@ module: nios_txt_record author: "Corey Wanless (@coreywan)" short_description: Configure Infoblox NIOS txt records +version_added: "1.0.0" description: - Adds and/or removes instances of txt record objects from Infoblox NIOS servers. This module manages NIOS C(record:txt) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_zone.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_zone.py index 49281ebd..d652d9d4 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_zone.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_zone.py @@ -11,6 +11,7 @@ module: nios_zone author: "Peter Sprygada (@privateip)" short_description: Configure Infoblox NIOS DNS zones +version_added: "1.0.0" description: - Adds and/or removes instances of DNS zone objects from Infoblox NIOS servers. This module manages NIOS C(zone_auth) objects From b423580075cdbf4404e049223ececd9d47a2c9df Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 16:56:24 +0530 Subject: [PATCH 4/9] Updated version_added --- .../infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py | 2 +- .../infoblox/nios_modules/plugins/modules/nios_dtc_pool.py | 2 +- .../infoblox/nios_modules/plugins/modules/nios_dtc_server.py | 2 +- .../nios_modules/plugins/modules/nios_restartservices.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py index 927e22a4..b9dceae1 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_lbdn.py @@ -10,7 +10,7 @@ --- module: nios_dtc_lbdn author: "Mauricio Teixeira (@badnetmask)" -version_added: "1.0.3" +version_added: "1.1.0" short_description: Configure Infoblox NIOS DTC LBDN description: - Adds and/or removes instances of DTC Load Balanced Domain Name (LBDN) diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py index 4a58f245..eba862ee 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_pool.py @@ -10,7 +10,7 @@ --- module: nios_dtc_pool author: "Mauricio Teixeira (@badnetmask)" -version_added: "1.0.3" +version_added: "1.1.0" short_description: Configure Infoblox NIOS DTC Pool description: - Adds and/or removes instances of DTC Pool objects from diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py index ebd068a1..9bb8f813 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_dtc_server.py @@ -11,7 +11,7 @@ module: nios_dtc_server author: "Mauricio Teixeira (@badnetmask)" short_description: Configure Infoblox NIOS DTC Server -version_added: "1.0.3" +version_added: "1.1.0" description: - Adds and/or removes instances of DTC Server objects from Infoblox NIOS servers. This module manages NIOS C(dtc:server) objects diff --git a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py index 219272d2..62589684 100644 --- a/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py +++ b/ansible_collections/infoblox/nios_modules/plugins/modules/nios_restartservices.py @@ -11,7 +11,7 @@ module: nios_restartservices author: "Mauricio Teixeira (@badnetmask)" short_description: Restart grid services. -version_added: "1.0.3" +version_added: "1.1.0" description: - Restart grid services. - When invoked without any options, will restart ALL services on the From 39761e5dcb93d918b8a0cde7f7533b53bdb31a19 Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 18:20:14 +0530 Subject: [PATCH 5/9] Updated changelogs and README --- README.md | 17 ++++- .../infoblox/nios_modules/CHANGELOG.rst | 11 ++++ .../infoblox/nios_modules/README.md | 35 ++++++++--- .../changelogs/.plugin-cache.yaml | 62 ++++++++++++------- .../nios_modules/changelogs/changelog.yaml | 15 +++++ 5 files changed, 109 insertions(+), 31 deletions(-) diff --git a/README.md b/README.md index 18615602..0603489c 100644 --- a/README.md +++ b/README.md @@ -144,10 +144,18 @@ Please refer to our Ansible [deployment guide](https://www.infoblox.com/wp-content/uploads/infoblox-deployment-guide-infoblox-and-ansible-integration.pdf) for more details. -Current release +Releasing ========= -1.0.2 on 27 January 2021 +Next release +--------------- + +Dates TBD + +Current release +--------------- + +1.1.0 on 12 April 2021 Versioning ========= @@ -155,6 +163,11 @@ Versioning - galaxy.yml in the master branch will always contain the version of the current major or minor release. It will be updated right after a release. - version_added needs to be used for every new feature and module/plugin, and needs to coincide with the next minor/major release version. (This will eventually be enforced by CI.) +Deprecation +=========== +- Deprecations are done by version number (not by date). +- New deprecations can be added during every minor release, under the condition that they do not break backwards compatibility. + Resources ========= diff --git a/ansible_collections/infoblox/nios_modules/CHANGELOG.rst b/ansible_collections/infoblox/nios_modules/CHANGELOG.rst index 97dc72a4..81d2385b 100644 --- a/ansible_collections/infoblox/nios_modules/CHANGELOG.rst +++ b/ansible_collections/infoblox/nios_modules/CHANGELOG.rst @@ -5,6 +5,17 @@ Infoblox.Nios_Modules Release Notes .. contents:: Topics +v1.1.0 +====== + +New Modules +----------- + +- infoblox.nios_modules.nios_dtc_lbdn - Configure Infoblox NIOS DTC LBDN +- infoblox.nios_modules.nios_dtc_pool - Configure Infoblox NIOS DTC Pool +- infoblox.nios_modules.nios_dtc_server - Configure Infoblox NIOS DTC Server +- infoblox.nios_modules.nios_restartservices - Restart grid services. + v1.0.2 ====== diff --git a/ansible_collections/infoblox/nios_modules/README.md b/ansible_collections/infoblox/nios_modules/README.md index 6eb38d69..0603489c 100644 --- a/ansible_collections/infoblox/nios_modules/README.md +++ b/ansible_collections/infoblox/nios_modules/README.md @@ -27,6 +27,12 @@ Modules: - `nios_dns_view` – Configure Infoblox NIOS DNS views +- `nios_dtc_lbdn` – Configure Infoblox NIOS DTC LBDN records + +- `nios_dtc_pool` – Configure Infoblox NIOS DTC pools + +- `nios_dtc_server` – Configure Infoblox NIOS DTC server records + - `nios_fixed_address` – Configure Infoblox NIOS DHCP Fixed Address - `nios_host_record` – Configure Infoblox NIOS host records @@ -45,6 +51,8 @@ Modules: - `nios_ptr_record` – Configure Infoblox NIOS PTR records +- `nios_restartservices` - Controlled restart of Infoblox NIOS services + - `nios_srv_record` – Configure Infoblox NIOS SRV records - `nios_txt_record` – Configure Infoblox NIOS txt records @@ -90,7 +98,7 @@ Installation of nios\_modules Collection The `nios_modules` collection can be installed either from Ansible Galaxy or directly from git. It is recommended to install collections from -Ansible Galaxy are those are more stable than the ones in the git +Ansible Galaxy as those are more stable than the ones in the git branch. ### Installation from Ansible Galaxy @@ -112,11 +120,10 @@ To git clone and install from this repo, follow these steps: - **Clone the repo:** ```shell -$ git clone -https://github.com/infobloxopen/infoblox-ansible.git +$ git clone https://github.com/infobloxopen/infoblox-ansible.git ``` -- **Build the collection: ** +- **Build the collection:** To build a collection, run the following command from inside the root directory of the collection: @@ -130,18 +137,25 @@ This creates a tarball of the built collection in the current directory. - **Install the collection:** ```shell -$ ansible-galaxy collection install <collection-name>.tar.gz -p -./collections +$ ansible-galaxy collection install .tar.gz -p ./collections ``` Please refer to our Ansible [deployment guide](https://www.infoblox.com/wp-content/uploads/infoblox-deployment-guide-infoblox-and-ansible-integration.pdf) for more details. -Current release +Releasing ========= -1.0.2 on 27 January 2021 +Next release +--------------- + +Dates TBD + +Current release +--------------- + +1.1.0 on 12 April 2021 Versioning ========= @@ -149,6 +163,11 @@ Versioning - galaxy.yml in the master branch will always contain the version of the current major or minor release. It will be updated right after a release. - version_added needs to be used for every new feature and module/plugin, and needs to coincide with the next minor/major release version. (This will eventually be enforced by CI.) +Deprecation +=========== +- Deprecations are done by version number (not by date). +- New deprecations can be added during every minor release, under the condition that they do not break backwards compatibility. + Resources ========= diff --git a/ansible_collections/infoblox/nios_modules/changelogs/.plugin-cache.yaml b/ansible_collections/infoblox/nios_modules/changelogs/.plugin-cache.yaml index 21456100..d8cffdb6 100644 --- a/ansible_collections/infoblox/nios_modules/changelogs/.plugin-cache.yaml +++ b/ansible_collections/infoblox/nios_modules/changelogs/.plugin-cache.yaml @@ -9,103 +9,123 @@ plugins: nios_inventory: description: Infoblox inventory plugin name: nios_inventory - version_added: '2.10' + version_added: 1.0.0 lookup: nios_lookup: description: Query Infoblox NIOS objects name: nios_lookup - version_added: null + version_added: 1.0.0 nios_next_ip: description: Return the next available IP address for a network name: nios_next_ip - version_added: null + version_added: 1.0.0 nios_next_network: description: Return the next available network range for a network-container name: nios_next_network - version_added: null + version_added: 1.0.0 module: nios_a_record: description: Configure Infoblox NIOS A records name: nios_a_record namespace: '' - version_added: null + version_added: 1.0.0 nios_aaaa_record: description: Configure Infoblox NIOS AAAA records name: nios_aaaa_record namespace: '' - version_added: null + version_added: 1.0.0 nios_cname_record: description: Configure Infoblox NIOS CNAME records name: nios_cname_record namespace: '' - version_added: null + version_added: 1.0.0 nios_dns_view: description: Configure Infoblox NIOS DNS views name: nios_dns_view namespace: '' - version_added: null + version_added: 1.0.0 + nios_dtc_lbdn: + description: Configure Infoblox NIOS DTC LBDN + name: nios_dtc_lbdn + namespace: '' + version_added: 1.1.0 + nios_dtc_pool: + description: Configure Infoblox NIOS DTC Pool + name: nios_dtc_pool + namespace: '' + version_added: 1.1.0 + nios_dtc_server: + description: Configure Infoblox NIOS DTC Server + name: nios_dtc_server + namespace: '' + version_added: 1.1.0 nios_fixed_address: description: Configure Infoblox NIOS DHCP Fixed Address name: nios_fixed_address namespace: '' - version_added: null + version_added: 1.0.0 nios_host_record: description: Configure Infoblox NIOS host records name: nios_host_record namespace: '' - version_added: null + version_added: 1.0.0 nios_member: description: Configure Infoblox NIOS members name: nios_member namespace: '' - version_added: null + version_added: 1.0.0 nios_mx_record: description: Configure Infoblox NIOS MX records name: nios_mx_record namespace: '' - version_added: null + version_added: 1.0.0 nios_naptr_record: description: Configure Infoblox NIOS NAPTR records name: nios_naptr_record namespace: '' - version_added: null + version_added: 1.0.0 nios_network: description: Configure Infoblox NIOS network object name: nios_network namespace: '' - version_added: null + version_added: 1.0.0 nios_network_view: description: Configure Infoblox NIOS network views name: nios_network_view namespace: '' - version_added: null + version_added: 1.0.0 nios_nsgroup: description: Configure InfoBlox DNS Nameserver Groups name: nios_nsgroup namespace: '' - version_added: null + version_added: 1.0.0 nios_ptr_record: description: Configure Infoblox NIOS PTR records name: nios_ptr_record namespace: '' - version_added: null + version_added: 1.0.0 + nios_restartservices: + description: Restart grid services. + name: nios_restartservices + namespace: '' + version_added: 1.1.0 nios_srv_record: description: Configure Infoblox NIOS SRV records name: nios_srv_record namespace: '' - version_added: null + version_added: 1.0.0 nios_txt_record: description: Configure Infoblox NIOS txt records name: nios_txt_record namespace: '' - version_added: null + version_added: 1.0.0 nios_zone: description: Configure Infoblox NIOS DNS zones name: nios_zone namespace: '' - version_added: null + version_added: 1.0.0 netconf: {} shell: {} strategy: {} vars: {} -version: 1.0.2 +version: 1.1.0 diff --git a/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml b/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml index 5eb4d70f..6b0cc0f9 100644 --- a/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml +++ b/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml @@ -80,3 +80,18 @@ releases: - Made it compatible for Ansible v3.0.0 release_summary: This release provides compatibilty for Ansible v3.0.0 release_date: '2021-01-27' + 1.1.0: + modules: + - description: Configure Infoblox NIOS DTC LBDN + name: nios_dtc_lbdn + namespace: '' + - description: Configure Infoblox NIOS DTC Pool + name: nios_dtc_pool + namespace: '' + - description: Configure Infoblox NIOS DTC Server + name: nios_dtc_server + namespace: '' + - description: Restart grid services. + name: nios_restartservices + namespace: '' + release_date: '2021-04-12' From 0f477086bb7e2750ad6e2bc6b2ea2f1e5a809c30 Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 19:07:06 +0530 Subject: [PATCH 6/9] Updated changelogs and galaxy.yml --- .../infoblox/nios_modules/changelogs/changelog.yaml | 2 ++ ansible_collections/infoblox/nios_modules/galaxy.yml | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml b/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml index 6b0cc0f9..2a652b01 100644 --- a/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml +++ b/ansible_collections/infoblox/nios_modules/changelogs/changelog.yaml @@ -81,6 +81,8 @@ releases: release_summary: This release provides compatibilty for Ansible v3.0.0 release_date: '2021-01-27' 1.1.0: + changes: + release_summary: This release provides plugins for NIOS DTC modules: - description: Configure Infoblox NIOS DTC LBDN name: nios_dtc_lbdn diff --git a/ansible_collections/infoblox/nios_modules/galaxy.yml b/ansible_collections/infoblox/nios_modules/galaxy.yml index 02f4f0e9..b591fb16 100644 --- a/ansible_collections/infoblox/nios_modules/galaxy.yml +++ b/ansible_collections/infoblox/nios_modules/galaxy.yml @@ -9,7 +9,7 @@ namespace: infoblox name: nios_modules # The version of the collection. Must be compatible with semantic versioning -version: 1.0.2 +version: 1.1.0 # The path to the Markdown (.md) readme file. This path is relative to the root of the collection readme: README.md From 557e43860116959e4f9a1af7297de0b7502badde Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Mon, 12 Apr 2021 19:07:24 +0530 Subject: [PATCH 7/9] Updated changelogs and galaxy.yml --- ansible_collections/infoblox/nios_modules/CHANGELOG.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/ansible_collections/infoblox/nios_modules/CHANGELOG.rst b/ansible_collections/infoblox/nios_modules/CHANGELOG.rst index 81d2385b..8d32cb3c 100644 --- a/ansible_collections/infoblox/nios_modules/CHANGELOG.rst +++ b/ansible_collections/infoblox/nios_modules/CHANGELOG.rst @@ -8,6 +8,11 @@ Infoblox.Nios_Modules Release Notes v1.1.0 ====== +Release Summary +--------------- + +This release provides plugins for NIOS DTC + New Modules ----------- From a9a2b0eca538f4d33d0c016d6a11e4495a0007df Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Wed, 14 Apr 2021 11:20:15 +0530 Subject: [PATCH 8/9] Updated README --- ansible_collections/infoblox/nios_modules/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ansible_collections/infoblox/nios_modules/README.md b/ansible_collections/infoblox/nios_modules/README.md index 0603489c..04a6f8b4 100644 --- a/ansible_collections/infoblox/nios_modules/README.md +++ b/ansible_collections/infoblox/nios_modules/README.md @@ -155,7 +155,7 @@ Dates TBD Current release --------------- -1.1.0 on 12 April 2021 +1.1.0 on 14 April 2021 Versioning ========= From 2b2d6b6d180a68adfa033def15486dd1e112b763 Mon Sep 17 00:00:00 2001 From: anagha-infoblox Date: Wed, 14 Apr 2021 11:20:29 +0530 Subject: [PATCH 9/9] Updated README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0603489c..04a6f8b4 100644 --- a/README.md +++ b/README.md @@ -155,7 +155,7 @@ Dates TBD Current release --------------- -1.1.0 on 12 April 2021 +1.1.0 on 14 April 2021 Versioning =========