mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
0c68e200d5
This module allows an administrator to provision new module functionality on a BIG-IP. BIG-IP modules provide enhanced ADC and security features that are commonly used by customers such as GTM, ASM, and AFM. Unit tests are provided. Integration tests can be found here https://github.com/F5Networks/f5-ansible/blob/devel/test/integration/bigip_provision.yaml#L23 https://github.com/F5Networks/f5-ansible/tree/devel/test/integration/targets/bigip_provision/tasks
152 lines
4.7 KiB
Python
152 lines
4.7 KiB
Python
# -*- coding: utf-8 -*-
|
|
#
|
|
# Copyright 2017 F5 Networks Inc.
|
|
#
|
|
# This file is part of Ansible
|
|
#
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
import sys
|
|
|
|
if sys.version_info < (2, 7):
|
|
from nose.plugins.skip import SkipTest
|
|
raise SkipTest("F5 Ansible modules require Python >= 2.7")
|
|
|
|
import os
|
|
import json
|
|
|
|
from ansible.compat.tests import unittest
|
|
from ansible.compat.tests.mock import patch, Mock
|
|
from ansible.module_utils import basic
|
|
from ansible.module_utils._text import to_bytes
|
|
from ansible.module_utils.f5_utils import AnsibleF5Client
|
|
|
|
try:
|
|
from library.bigip_provision import Parameters
|
|
from library.bigip_provision import ModuleManager
|
|
from library.bigip_provision import ArgumentSpec
|
|
except ImportError:
|
|
from ansible.modules.network.f5.bigip_provision import Parameters
|
|
from ansible.modules.network.f5.bigip_provision import ModuleManager
|
|
from ansible.modules.network.f5.bigip_provision import ArgumentSpec
|
|
|
|
fixture_path = os.path.join(os.path.dirname(__file__), 'fixtures')
|
|
fixture_data = {}
|
|
|
|
|
|
def set_module_args(args):
|
|
args = json.dumps({'ANSIBLE_MODULE_ARGS': args})
|
|
basic._ANSIBLE_ARGS = to_bytes(args)
|
|
|
|
|
|
def load_fixture(name):
|
|
path = os.path.join(fixture_path, name)
|
|
|
|
if path in fixture_data:
|
|
return fixture_data[path]
|
|
|
|
with open(path) as f:
|
|
data = f.read()
|
|
|
|
try:
|
|
data = json.loads(data)
|
|
except Exception:
|
|
pass
|
|
|
|
fixture_data[path] = data
|
|
return data
|
|
|
|
|
|
class TestParameters(unittest.TestCase):
|
|
def test_module_parameters(self):
|
|
args = dict(
|
|
module='gtm',
|
|
password='password',
|
|
server='localhost',
|
|
user='admin'
|
|
)
|
|
p = Parameters(args)
|
|
assert p.module == 'gtm'
|
|
|
|
|
|
@patch('ansible.module_utils.f5_utils.AnsibleF5Client._get_mgmt_root',
|
|
return_value=True)
|
|
class TestManager(unittest.TestCase):
|
|
|
|
def setUp(self):
|
|
self.spec = ArgumentSpec()
|
|
|
|
def test_provision_one_module_default_level(self, *args):
|
|
# Configure the arguments that would be sent to the Ansible module
|
|
set_module_args(dict(
|
|
module='gtm',
|
|
password='passsword',
|
|
server='localhost',
|
|
user='admin'
|
|
))
|
|
|
|
# Configure the parameters that would be returned by querying the
|
|
# remote device
|
|
current = Parameters(
|
|
dict(
|
|
module='gtm',
|
|
level='none'
|
|
)
|
|
)
|
|
client = AnsibleF5Client(
|
|
argument_spec=self.spec.argument_spec,
|
|
supports_check_mode=self.spec.supports_check_mode,
|
|
f5_product_name=self.spec.f5_product_name
|
|
)
|
|
mm = ModuleManager(client)
|
|
|
|
# Override methods to force specific logic in the module to happen
|
|
mm.update_on_device = Mock(return_value=True)
|
|
mm.read_current_from_device = Mock(return_value=current)
|
|
|
|
# this forced sleeping can cause these tests to take 15
|
|
# or more seconds to run. This is deliberate.
|
|
mm._is_mprov_running_on_device = Mock(side_effect=[True, False, False, False, False])
|
|
|
|
results = mm.exec_module()
|
|
|
|
assert results['changed'] is True
|
|
assert results['level'] == 'nominal'
|
|
|
|
def test_provision_all_modules(self, *args):
|
|
modules = [
|
|
'afm', 'am', 'sam', 'asm', 'avr', 'fps',
|
|
'gtm', 'lc', 'ltm', 'pem', 'swg', 'ilx',
|
|
'apm',
|
|
]
|
|
|
|
for module in modules:
|
|
# Configure the arguments that would be sent to the Ansible module
|
|
set_module_args(dict(
|
|
module=module,
|
|
password='passsword',
|
|
server='localhost',
|
|
user='admin'
|
|
))
|
|
|
|
with patch('ansible.module_utils.basic.AnsibleModule.fail_json') as mo:
|
|
AnsibleF5Client(
|
|
argument_spec=self.spec.argument_spec,
|
|
supports_check_mode=self.spec.supports_check_mode,
|
|
f5_product_name=self.spec.f5_product_name
|
|
)
|
|
mo.assert_not_called()
|