mirror of https://github.com/ansible/ansible.git
Add Rest API to DNS (#59937)
* add rest to dns * fix issues with tests * fixes to netapp.py * fixes * fixes * add updates * fix issuespull/61294/head
parent
25db0c7678
commit
265fcaac40
@ -0,0 +1,276 @@
|
||||
# (c) 2018, NetApp, Inc
|
||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||
|
||||
''' unit tests for Ansible module: na_ontap_dns'''
|
||||
|
||||
from __future__ import (absolute_import, division, print_function)
|
||||
__metaclass__ = type
|
||||
import json
|
||||
import pytest
|
||||
|
||||
from units.compat import unittest
|
||||
from units.compat.mock import patch, Mock
|
||||
from ansible.module_utils import basic
|
||||
from ansible.module_utils._text import to_bytes
|
||||
import ansible.module_utils.netapp as netapp_utils
|
||||
|
||||
from ansible.modules.storage.netapp.na_ontap_dns \
|
||||
import NetAppOntapDns as dns_module # module under test
|
||||
|
||||
if not netapp_utils.has_netapp_lib():
|
||||
pytestmark = pytest.mark.skip('skipping as missing required netapp_lib')
|
||||
HAS_NETAPP_ZAPI_MSG = "pip install netapp_lib is required"
|
||||
|
||||
|
||||
# REST API canned responses when mocking send_request
|
||||
SRR = {
|
||||
# common responses
|
||||
'is_rest': (200, None),
|
||||
'is_zapi': (400, "Unreachable"),
|
||||
'empty_good': ({}, None),
|
||||
'end_of_sequence': (None, "Unexpected call to send_request"),
|
||||
'generic_error': (None, "Expected error"),
|
||||
'dns_record': ({"records": [{"domains": ['0.0.0.0'],
|
||||
"servers": ['0.0.0.0'],
|
||||
"svm": {"name": "svm1", "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"}}]}, None)}
|
||||
|
||||
|
||||
def set_module_args(args):
|
||||
"""prepare arguments so that they will be picked up during module creation"""
|
||||
args = json.dumps({'ANSIBLE_MODULE_ARGS': args})
|
||||
basic._ANSIBLE_ARGS = to_bytes(args) # pylint: disable=protected-access
|
||||
|
||||
|
||||
class AnsibleExitJson(Exception):
|
||||
"""Exception class to be raised by module.exit_json and caught by the test case"""
|
||||
pass
|
||||
|
||||
|
||||
class AnsibleFailJson(Exception):
|
||||
"""Exception class to be raised by module.fail_json and caught by the test case"""
|
||||
pass
|
||||
|
||||
|
||||
def exit_json(*args, **kwargs): # pylint: disable=unused-argument
|
||||
"""function to patch over exit_json; package return data into an exception"""
|
||||
if 'changed' not in kwargs:
|
||||
kwargs['changed'] = False
|
||||
raise AnsibleExitJson(kwargs)
|
||||
|
||||
|
||||
def fail_json(*args, **kwargs): # pylint: disable=unused-argument
|
||||
"""function to patch over fail_json; package return data into an exception"""
|
||||
kwargs['failed'] = True
|
||||
raise AnsibleFailJson(kwargs)
|
||||
|
||||
|
||||
class MockONTAPConnection(object):
|
||||
''' mock server connection to ONTAP host '''
|
||||
|
||||
def __init__(self, kind=None, data=None):
|
||||
''' save arguments '''
|
||||
self.kind = kind
|
||||
self.params = data
|
||||
self.xml_in = None
|
||||
self.xml_out = None
|
||||
|
||||
def invoke_successfully(self, xml, enable_tunneling): # pylint: disable=unused-argument
|
||||
''' mock invoke_successfully returning xml data '''
|
||||
self.xml_in = xml
|
||||
request = xml.to_string().decode('utf-8')
|
||||
if request.startswith("<ems-autosupport-log>"):
|
||||
xml = None # or something that may the logger happy, and you don't need @patch anymore
|
||||
# or
|
||||
# xml = build_ems_log_response()
|
||||
elif request == "<net-dns-get/>":
|
||||
if self.kind == 'create':
|
||||
raise netapp_utils.zapi.NaApiError(code="15661")
|
||||
else:
|
||||
xml = self.build_dns_status_info()
|
||||
elif request.startswith("<net-dns-create>"):
|
||||
xml = self.build_dns_status_info()
|
||||
if self.kind == 'enable':
|
||||
xml = self.build_dns_status_info()
|
||||
self.xml_out = xml
|
||||
return xml
|
||||
|
||||
@staticmethod
|
||||
def build_dns_status_info():
|
||||
xml = netapp_utils.zapi.NaElement('xml')
|
||||
nameservers = [{'ip-address': '0.0.0.0'}]
|
||||
domains = [{'string': '0.0.0.0'}]
|
||||
attributes = {'num-records': 1,
|
||||
'attributes': {'net-dns-info': {'name-servers': nameservers,
|
||||
'domains': domains,
|
||||
'skip-config-validation': 'false'}}}
|
||||
xml.translate_struct(attributes)
|
||||
return xml
|
||||
|
||||
|
||||
class TestMyModule(unittest.TestCase):
|
||||
''' Unit tests for na_ontap_job_schedule '''
|
||||
|
||||
def setUp(self):
|
||||
self.mock_module_helper = patch.multiple(basic.AnsibleModule,
|
||||
exit_json=exit_json,
|
||||
fail_json=fail_json)
|
||||
self.mock_module_helper.start()
|
||||
self.addCleanup(self.mock_module_helper.stop)
|
||||
|
||||
def mock_args(self):
|
||||
return {
|
||||
'state': 'present',
|
||||
'vserver': 'vserver',
|
||||
'nameservers': ['0.0.0.0'],
|
||||
'domains': ['0.0.0.0'],
|
||||
'hostname': 'test',
|
||||
'username': 'test_user',
|
||||
'password': 'test_pass!'
|
||||
}
|
||||
|
||||
def get_dns_mock_object(self, type='zapi', kind=None, status=None):
|
||||
dns_obj = dns_module()
|
||||
if type == 'zapi':
|
||||
if kind is None:
|
||||
dns_obj.server = MockONTAPConnection()
|
||||
else:
|
||||
dns_obj.server = MockONTAPConnection(kind=kind, data=status)
|
||||
return dns_obj
|
||||
|
||||
def test_module_fail_when_required_args_missing(self):
|
||||
''' required arguments are reported as errors '''
|
||||
with pytest.raises(AnsibleFailJson) as exc:
|
||||
set_module_args({})
|
||||
dns_module()
|
||||
print('Info: %s' % exc.value.args[0]['msg'])
|
||||
|
||||
def test_idempotent_modify_dns(self):
|
||||
data = self.mock_args()
|
||||
set_module_args(data)
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object('zapi', 'enable', 'false').apply()
|
||||
assert not exc.value.args[0]['changed']
|
||||
|
||||
def test_successfully_modify_dns(self):
|
||||
data = self.mock_args()
|
||||
data['domains'] = ['1.1.1.1']
|
||||
set_module_args(data)
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object('zapi', 'enable', 'false').apply()
|
||||
assert exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.ems_log_event')
|
||||
def test_idempotent_create_dns(self, mock_ems_log_event):
|
||||
data = self.mock_args()
|
||||
set_module_args(data)
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object('zapi').apply()
|
||||
assert not exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.ems_log_event')
|
||||
def test_successfully_create_dns(self, mock_ems_log_event):
|
||||
data = self.mock_args()
|
||||
print("create dns")
|
||||
data['domains'] = ['1.1.1.1']
|
||||
set_module_args(data)
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object('zapi', 'create').apply()
|
||||
assert exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_error(self, mock_request):
|
||||
data = self.mock_args()
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['generic_error'],
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleFailJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert exc.value.args[0]['msg'] == SRR['generic_error'][1]
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_successfully_create(self, mock_request):
|
||||
data = self.mock_args()
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['empty_good'], # get
|
||||
SRR['empty_good'], # post
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_idempotent_create_dns(self, mock_request):
|
||||
data = self.mock_args()
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['dns_record'], # get
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert not exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_successfully_destroy(self, mock_request):
|
||||
data = self.mock_args()
|
||||
data['state'] = 'absent'
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['dns_record'], # get
|
||||
SRR['empty_good'], # delete
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_idempotently_destroy(self, mock_request):
|
||||
data = self.mock_args()
|
||||
data['state'] = 'absent'
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['empty_good'], # get
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert not exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_successfully_modify(self, mock_request):
|
||||
data = self.mock_args()
|
||||
data['state'] = 'present'
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['empty_good'], # get
|
||||
SRR['empty_good'], # patch
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert exc.value.args[0]['changed']
|
||||
|
||||
@patch('ansible.module_utils.netapp.OntapRestAPI.send_request')
|
||||
def test_rest_idempotently_modify(self, mock_request):
|
||||
data = self.mock_args()
|
||||
data['state'] = 'present'
|
||||
set_module_args(data)
|
||||
mock_request.side_effect = [
|
||||
SRR['is_rest'],
|
||||
SRR['dns_record'], # get
|
||||
SRR['end_of_sequence']
|
||||
]
|
||||
with pytest.raises(AnsibleExitJson) as exc:
|
||||
self.get_dns_mock_object(type='rest').apply()
|
||||
assert not exc.value.args[0]['changed']
|
||||
Loading…
Reference in New Issue