Nameserver info module (#192)

Nameserver info module

Reviewed-by: Vladimir Vshivkov <None>
Reviewed-by: Anton Kachurin <[email protected]>
Reviewed-by: Irina Pereiaslavskaia <[email protected]>
Reviewed-by: Rodion Gyrbu <[email protected]>

Author: anton-sidelnikov

doc/source/dns.rst

@@ -6,5 +6,6 @@ Domain Name Service (DNS) Modules
 
    dns_floating_ip <dns_floating_ip_module>
    dns_recordset <dns_recordset_module>
+   dns_recordset_info <dns_recordset_info_module>
    dns_zone <dns_zone_module>
-
+   dns_nameserver_info <dns_nameserver_info_module>

doc/source/index.rst

@@ -1,7 +1,7 @@
 Opentelekomcloud.Cloud
 ======================
 
-Collection version 0.12.3
+Collection version 0.12.4
 
 
 

galaxy.yml

@@ -1,6 +1,6 @@
 namespace: opentelekomcloud
 name: cloud
-version: 0.12.3
+version: 0.12.4
 readme: README.md
 authors:
   - Artem Goncharov <[email protected]>

meta/runtime.yml

@@ -79,3 +79,4 @@ action_groups:
     - anti_ddos_fip_statuses_info.py
     - anti_ddos_optional_policies_info.py
     - object_info.py
+    - dns_nameserver_info.py

plugins/modules/dns_nameserver_info.py

@@ -0,0 +1,101 @@
+#!/usr/bin/python
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+DOCUMENTATION = '''
+module: dns_nameserver_info
+short_description: Get info about DNS nameservers.
+extends_documentation_fragment: opentelekomcloud.cloud.otc
+version_added: "0.12.2"
+author: "Anton Sidelnikov (@anton-sidelnikov)"
+description:
+  - Get DNS nameservers info from the OTC.
+options:
+  zone:
+    description:
+      - ID or name of the required zone. If name had been provided, only public zone could be\
+        returned. If private zone is required, only ID should be passed.
+    type: str
+    required: true
+requirements: ["openstacksdk", "otcextensions"]
+'''
+
+RETURN = '''
+nameservers:
+  description: List of dictionaries describing nameservers.
+  type: complex
+  returned: On Success.
+  contains:
+    hostname:
+      description: Host name of a name server.
+      type: str
+      sample: "ns1.example.com."
+    address:
+      description: IP address of a DNS server (Private Zone only).
+      type: str
+      sample: "100.125.0.81"
+    priority:
+      description: Priority of a name server.
+      type: int
+'''
+
+EXAMPLES = '''
+#Get info about choosen DNS recordset.
+- opentelekomcloud.cloud.dns_nameserver_info:
+    zone: "ff80808275f5fc0f017e886898315ee9"
+  register: nameservers
+'''
+
+from ansible_collections.opentelekomcloud.cloud.plugins.module_utils.otc import OTCModule
+
+
+class DNSNameserverInfoModule(OTCModule):
+
+    argument_spec = dict(
+        zone=dict(required=True),
+    )
+    module_kwargs = dict(
+        supports_check_mode=True,
+    )
+
+    def run(self):
+
+        data = []
+        query = {}
+
+        if self.params['zone']:
+            try:
+                query['zone'] = self.conn.dns.find_zone(
+                    name_or_id=self.params['zone'], ignore_missing=False).id
+            except self.sdk.exceptions.ResourceNotFound:
+                self.fail_json(msg="Zone not found")
+
+        for raw in self.conn.dns.nameservers(**query):
+            dt = raw.to_dict()
+            dt.pop('location')
+            dt.pop('name')
+            dt.pop('id')
+            data.append(dt)
+
+        self.exit(
+            changed=False,
+            nameservers=data
+        )
+
+
+def main():
+    module = DNSNameserverInfoModule()
+    module()
+
+
+if __name__ == '__main__':
+    main()

tests/integration/targets/dns/tasks/main.yaml

@@ -236,6 +236,28 @@
           - dns_zo_pr is success
           - dns_zo_pr.zone.description is defined
 
+    - name: Get a DNS Nameservers info for public zone
+      opentelekomcloud.cloud.dns_nameserver_info:
+        zone: "{{ zone_public_name }}"
+      register: dns_ns
+
+    - name: assert result
+      assert:
+        that:
+          - dns_ns is success
+          - dns_ns.nameservers[0].hostname is defined
+
+    - name: Get a DNS Nameservers info for private zone
+      opentelekomcloud.cloud.dns_nameserver_info:
+        zone: "{{ zone_private_name }}"
+      register: dns_ns
+
+    - name: assert result
+      assert:
+        that:
+          - dns_ns is success
+          - dns_ns.nameservers[0].address is defined
+
     - name: Creating a DNS Recordset - check mode
       opentelekomcloud.cloud.dns_recordset:
         zone_id: "{{ dns_zo.zone.id }}"

tests/sanity/ignore-2.10.txt

@@ -94,3 +94,4 @@ plugins/modules/anti_ddos_fip_statuses_info.py validate-modules:missing-gplv3-li
 plugins/modules/anti_ddos_optional_policies_info.py validate-modules:missing-gplv3-license
 plugins/modules/server_group_info.py validate-modules:missing-gplv3-license
 plugins/modules/object_info.py validate-modules:missing-gplv3-license
+plugins/modules/dns_nameserver_info.py validate-modules:missing-gplv3-license

tests/sanity/ignore-2.9.txt

@@ -95,3 +95,4 @@ plugins/modules/anti_ddos_fip_statuses_info.py validate-modules:missing-gplv3-li
 plugins/modules/anti_ddos_optional_policies_info.py validate-modules:missing-gplv3-license
 plugins/modules/server_group_info.py validate-modules:missing-gplv3-license
 plugins/modules/object_info.py validate-modules:missing-gplv3-license
+plugins/modules/dns_nameserver_info.py validate-modules:missing-gplv3-license