mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-10-22 12:03:58 -07:00
Adds the bigip_gtm_pool module (#25275)
This module is used to manage GTM(DNS) pools in a BIG-IP. Unit tests are provided. Integration tests can be found here https://github.com/F5Networks/f5-ansible/blob/devel/test/integration/bigip_gtm_pool.yaml#L23 https://github.com/F5Networks/f5-ansible/tree/devel/test/integration/targets/bigip_gtm_pool/tasks
This commit is contained in:
Tim Rupp
John R Barker
parent
1476e30c26
commit
0133a5a763
4 changed files with 1056 additions and 0 deletions
|
|
@ -0,0 +1,38 @@
|
|||
{
|
||||
"kind": "tm:gtm:pool:a:astate",
|
||||
"name": "asdf",
|
||||
"partition": "Common",
|
||||
"fullPath": "/Common/asdf",
|
||||
"generation": 94,
|
||||
"selfLink": "https://localhost/mgmt/tm/gtm/pool/a/~Common~asdf?ver=12.1.2",
|
||||
"alternateMode": "round-robin",
|
||||
"dynamicRatio": "disabled",
|
||||
"enabled": true,
|
||||
"fallbackIp": "any",
|
||||
"fallbackMode": "return-to-dns",
|
||||
"limitMaxBps": 0,
|
||||
"limitMaxBpsStatus": "disabled",
|
||||
"limitMaxConnections": 0,
|
||||
"limitMaxConnectionsStatus": "disabled",
|
||||
"limitMaxPps": 0,
|
||||
"limitMaxPpsStatus": "disabled",
|
||||
"loadBalancingMode": "round-robin",
|
||||
"manualResume": "disabled",
|
||||
"maxAnswersReturned": 1,
|
||||
"monitor": "default",
|
||||
"qosHitRatio": 5,
|
||||
"qosHops": 0,
|
||||
"qosKilobytesSecond": 3,
|
||||
"qosLcs": 30,
|
||||
"qosPacketRate": 1,
|
||||
"qosRtt": 50,
|
||||
"qosTopology": 0,
|
||||
"qosVsCapacity": 0,
|
||||
"qosVsScore": 0,
|
||||
"ttl": 30,
|
||||
"verifyMemberAvailability": "enabled",
|
||||
"membersReference": {
|
||||
"link": "https://localhost/mgmt/tm/gtm/pool/a/~Common~asdf/members?ver=12.1.2",
|
||||
"isSubcollection": true
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,39 @@
|
|||
{
|
||||
"kind": "tm:gtm:pool:poolstate",
|
||||
"name": "asdf",
|
||||
"partition": "Common",
|
||||
"fullPath": "/Common/asdf",
|
||||
"generation": 92,
|
||||
"selfLink": "https://localhost/mgmt/tm/gtm/pool/~Common~asdf?ver=11.6.1",
|
||||
"alternateMode": "round-robin",
|
||||
"dynamicRatio": "disabled",
|
||||
"enabled": true,
|
||||
"fallbackIpv4": "any",
|
||||
"fallbackIpv6": "any6",
|
||||
"fallbackMode": "return-to-dns",
|
||||
"limitMaxBps": 0,
|
||||
"limitMaxBpsStatus": "disabled",
|
||||
"limitMaxConnections": 0,
|
||||
"limitMaxConnectionsStatus": "disabled",
|
||||
"limitMaxPps": 0,
|
||||
"limitMaxPpsStatus": "disabled",
|
||||
"loadBalancingMode": "round-robin",
|
||||
"manualResume": "disabled",
|
||||
"maxAddressReturned": 1,
|
||||
"monitor": "default",
|
||||
"qosHitRatio": 5,
|
||||
"qosHops": 0,
|
||||
"qosKilobytesSecond": 3,
|
||||
"qosLcs": 30,
|
||||
"qosPacketRate": 1,
|
||||
"qosRtt": 50,
|
||||
"qosTopology": 0,
|
||||
"qosVsCapacity": 0,
|
||||
"qosVsScore": 0,
|
||||
"ttl": 30,
|
||||
"verifyMemberAvailability": "enabled",
|
||||
"membersReference": {
|
||||
"link": "https://localhost/mgmt/tm/gtm/pool/~Common~asdf/members?ver=11.6.1",
|
||||
"isSubcollection": true
|
||||
}
|
||||
}
|
||||
326
test/units/modules/network/f5/test_bigip_gtm_pool.py
Normal file
326
test/units/modules/network/f5/test_bigip_gtm_pool.py
Normal file
|
|
@ -0,0 +1,326 @@
|
|||
# -*- 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_gtm_pool import Parameters
|
||||
from library.bigip_gtm_pool import ModuleManager
|
||||
from library.bigip_gtm_pool import ArgumentSpec
|
||||
from library.bigip_gtm_pool import UntypedManager
|
||||
from library.bigip_gtm_pool import TypedManager
|
||||
except ImportError:
|
||||
from ansible.modules.network.f5.bigip_gtm_pool import Parameters
|
||||
from ansible.modules.network.f5.bigip_gtm_pool import ModuleManager
|
||||
from ansible.modules.network.f5.bigip_gtm_pool import ArgumentSpec
|
||||
from ansible.modules.network.f5.bigip_gtm_pool import UntypedManager
|
||||
from ansible.modules.network.f5.bigip_gtm_pool import TypedManager
|
||||
|
||||
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(
|
||||
name='foo',
|
||||
preferred_lb_method='topology',
|
||||
alternate_lb_method='ratio',
|
||||
fallback_lb_method='fewest-hops',
|
||||
fallback_ip='10.10.10.10',
|
||||
type='a'
|
||||
)
|
||||
p = Parameters(args)
|
||||
assert p.name == 'foo'
|
||||
assert p.preferred_lb_method == 'topology'
|
||||
assert p.alternate_lb_method == 'ratio'
|
||||
assert p.fallback_lb_method == 'fewest-hops'
|
||||
assert p.fallback_ip == '10.10.10.10'
|
||||
assert p.type == 'a'
|
||||
|
||||
def test_api_parameters(self):
|
||||
args = dict(
|
||||
name='foo',
|
||||
loadBalancingMode='topology',
|
||||
alternateMode='ratio',
|
||||
fallbackMode='fewest-hops',
|
||||
fallbackIp='10.10.10.10'
|
||||
)
|
||||
p = Parameters(args)
|
||||
assert p.name == 'foo'
|
||||
assert p.preferred_lb_method == 'topology'
|
||||
assert p.alternate_lb_method == 'ratio'
|
||||
assert p.fallback_lb_method == 'fewest-hops'
|
||||
assert p.fallback_ip == '10.10.10.10'
|
||||
|
||||
|
||||
@patch('ansible.module_utils.f5_utils.AnsibleF5Client._get_mgmt_root',
|
||||
return_value=True)
|
||||
class TestUntypedManager(unittest.TestCase):
|
||||
|
||||
def setUp(self):
|
||||
self.spec = ArgumentSpec()
|
||||
|
||||
def test_create_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
preferred_lb_method='round-robin',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = UntypedManager(client)
|
||||
tm.exists = Mock(side_effect=[False, True])
|
||||
tm.create_on_device = Mock(return_value=True)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=True)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
assert results['preferred_lb_method'] == 'round-robin'
|
||||
|
||||
def test_update_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
preferred_lb_method='topology',
|
||||
alternate_lb_method='drop-packet',
|
||||
fallback_lb_method='cpu',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
current = Parameters(load_fixture('load_gtm_pool_untyped_default.json'))
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = UntypedManager(client)
|
||||
tm.exists = Mock(side_effect=[True, True])
|
||||
tm.update_on_device = Mock(return_value=True)
|
||||
tm.read_current_from_device = Mock(return_value=current)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=True)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
assert results['preferred_lb_method'] == 'topology'
|
||||
assert results['alternate_lb_method'] == 'drop-packet'
|
||||
assert results['fallback_lb_method'] == 'cpu'
|
||||
|
||||
def test_delete_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
state='absent',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = UntypedManager(client)
|
||||
tm.exists = Mock(side_effect=[True, False])
|
||||
tm.remove_from_device = Mock(return_value=True)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=True)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
|
||||
|
||||
@patch('ansible.module_utils.f5_utils.AnsibleF5Client._get_mgmt_root',
|
||||
return_value=True)
|
||||
class TestTypedManager(unittest.TestCase):
|
||||
|
||||
def setUp(self):
|
||||
self.spec = ArgumentSpec()
|
||||
|
||||
def test_create_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
preferred_lb_method='round-robin',
|
||||
type='a',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = TypedManager(client)
|
||||
tm.exists = Mock(side_effect=[False, True])
|
||||
tm.create_on_device = Mock(return_value=True)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=False)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
assert results['preferred_lb_method'] == 'round-robin'
|
||||
|
||||
def test_update_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
preferred_lb_method='topology',
|
||||
alternate_lb_method='drop-packet',
|
||||
fallback_lb_method='cpu',
|
||||
type='a',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
current = Parameters(load_fixture('load_gtm_pool_a_default.json'))
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = TypedManager(client)
|
||||
tm.exists = Mock(side_effect=[True, True])
|
||||
tm.update_on_device = Mock(return_value=True)
|
||||
tm.read_current_from_device = Mock(return_value=current)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=False)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
assert results['preferred_lb_method'] == 'topology'
|
||||
assert results['alternate_lb_method'] == 'drop-packet'
|
||||
assert results['fallback_lb_method'] == 'cpu'
|
||||
|
||||
def test_delete_pool(self, *args):
|
||||
set_module_args(dict(
|
||||
name='foo',
|
||||
type='a',
|
||||
state='absent',
|
||||
password='passsword',
|
||||
server='localhost',
|
||||
user='admin'
|
||||
))
|
||||
|
||||
client = AnsibleF5Client(
|
||||
argument_spec=self.spec.argument_spec,
|
||||
supports_check_mode=self.spec.supports_check_mode,
|
||||
f5_product_name=self.spec.f5_product_name
|
||||
)
|
||||
|
||||
# Override methods in the specific type of manager
|
||||
tm = TypedManager(client)
|
||||
tm.exists = Mock(side_effect=[True, False])
|
||||
tm.remove_from_device = Mock(return_value=True)
|
||||
|
||||
# Override methods to force specific logic in the module to happen
|
||||
mm = ModuleManager(client)
|
||||
mm.version_is_less_than_12 = Mock(return_value=False)
|
||||
mm.get_manager = Mock(return_value=tm)
|
||||
mm.gtm_provisioned = Mock(return_value=True)
|
||||
|
||||
results = mm.exec_module()
|
||||
|
||||
assert results['changed'] is True
|
||||
Loading…
Add table
Add a link
Reference in a new issue