Adds tcp profile module for BIGIP (#39268)

This patch adds a module to support manipulation of TCP profiles
on a BIGIP
This commit is contained in:
Tim Rupp 2018-04-24 20:05:31 -07:00 committed by GitHub
commit 434ad97c39
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 611 additions and 0 deletions

View file

@ -0,0 +1,92 @@
{
"kind": "tm:ltm:profile:tcp:tcpstate",
"name": "foo",
"partition": "Common",
"fullPath": "/Common/foo",
"generation": 92,
"selfLink": "https://localhost/mgmt/tm/ltm/profile/tcp/~Common~foo?ver=13.1.0.4",
"abc": "enabled",
"ackOnPush": "enabled",
"appService": "none",
"autoProxyBufferSize": "disabled",
"autoReceiveWindowSize": "disabled",
"autoSendBufferSize": "disabled",
"closeWaitTimeout": 5,
"cmetricsCache": "enabled",
"cmetricsCacheTimeout": 0,
"congestionControl": "high-speed",
"defaultsFrom": "/Common/tcp",
"defaultsFromReference": {
"link": "https://localhost/mgmt/tm/ltm/profile/tcp/~Common~tcp?ver=13.1.0.4"
},
"deferredAccept": "disabled",
"delayWindowControl": "disabled",
"delayedAcks": "enabled",
"description": "none",
"dsack": "disabled",
"earlyRetransmit": "enabled",
"ecn": "enabled",
"enhancedLossRecovery": "disabled",
"fastOpen": "disabled",
"fastOpenCookieExpiration": 21600,
"finWait_2Timeout": 300,
"finWaitTimeout": 5,
"hardwareSynCookie": "enabled",
"idleTimeout": 300,
"initCwnd": 3,
"initRwnd": 3,
"ipDfMode": "pmtu",
"ipTosToClient": "0",
"ipTtlMode": "proxy",
"ipTtlV4": 255,
"ipTtlV6": 64,
"keepAliveInterval": 1800,
"limitedTransmit": "enabled",
"linkQosToClient": "0",
"maxRetrans": 8,
"maxSegmentSize": 1460,
"md5Signature": "disabled",
"minimumRto": 1000,
"mptcp": "disabled",
"mptcpCsum": "disabled",
"mptcpCsumVerify": "disabled",
"mptcpDebug": "disabled",
"mptcpFallback": "reset",
"mptcpFastjoin": "disabled",
"mptcpIdleTimeout": 300,
"mptcpJoinMax": 5,
"mptcpMakeafterbreak": "disabled",
"mptcpNojoindssack": "disabled",
"mptcpRtomax": 5,
"mptcpRxmitmin": 1000,
"mptcpSubflowmax": 6,
"mptcpTimeout": 3600,
"nagle": "disabled",
"pktLossIgnoreBurst": 0,
"pktLossIgnoreRate": 0,
"proxyBufferHigh": 49152,
"proxyBufferLow": 32768,
"proxyMss": "enabled",
"proxyOptions": "disabled",
"pushFlag": "default",
"ratePace": "disabled",
"ratePaceMaxRate": 0,
"receiveWindowSize": 65535,
"resetOnTimeout": "enabled",
"rexmtThresh": 3,
"selectiveAcks": "enabled",
"selectiveNack": "disabled",
"sendBufferSize": 65535,
"slowStart": "enabled",
"synCookieEnable": "enabled",
"synCookieWhitelist": "disabled",
"synMaxRetrans": 3,
"synRtoBase": 3000,
"tailLossProbe": "disabled",
"tcpOptions": "none",
"timeWaitRecycle": "enabled",
"timeWaitTimeout": "2000",
"timestamps": "enabled",
"verifiedAccept": "disabled",
"zeroWindowTimeout": 20000
}

View file

@ -0,0 +1,114 @@
# -*- coding: utf-8 -*-
#
# Copyright: (c) 2017, F5 Networks Inc.
# GNU General Public License v3.0 (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
import os
import json
import pytest
import sys
from nose.plugins.skip import SkipTest
if sys.version_info < (2, 7):
raise SkipTest("F5 Ansible modules require Python >= 2.7")
from ansible.compat.tests import unittest
from ansible.compat.tests.mock import Mock
from ansible.compat.tests.mock import patch
from ansible.module_utils.basic import AnsibleModule
try:
from library.modules.bigip_profile_tcp import ApiParameters
from library.modules.bigip_profile_tcp import ModuleParameters
from library.modules.bigip_profile_tcp import ModuleManager
from library.modules.bigip_profile_tcp import ArgumentSpec
from library.module_utils.network.f5.common import F5ModuleError
from library.module_utils.network.f5.common import iControlUnexpectedHTTPError
from test.unit.modules.utils import set_module_args
except ImportError:
try:
from ansible.modules.network.f5.bigip_profile_tcp import ApiParameters
from ansible.modules.network.f5.bigip_profile_tcp import ModuleParameters
from ansible.modules.network.f5.bigip_profile_tcp import ModuleManager
from ansible.modules.network.f5.bigip_profile_tcp import ArgumentSpec
from ansible.module_utils.network.f5.common import F5ModuleError
from ansible.module_utils.network.f5.common import iControlUnexpectedHTTPError
from units.modules.utils import set_module_args
except ImportError:
raise SkipTest("F5 Ansible modules require the f5-sdk Python library")
fixture_path = os.path.join(os.path.dirname(__file__), 'fixtures')
fixture_data = {}
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',
parent='bar',
idle_timeout='500'
)
p = ModuleParameters(params=args)
assert p.name == 'foo'
assert p.parent == '/Common/bar'
assert p.idle_timeout == 500
def test_api_parameters(self):
args = load_fixture('load_ltm_profile_tcp_1.json')
p = ApiParameters(params=args)
assert p.name == 'foo'
assert p.idle_timeout == 300
class TestManager(unittest.TestCase):
def setUp(self):
self.spec = ArgumentSpec()
def test_create(self, *args):
# Configure the arguments that would be sent to the Ansible module
set_module_args(dict(
name='foo',
parent='bar',
idle_timeout=500,
password='password',
server='localhost',
user='admin'
))
module = AnsibleModule(
argument_spec=self.spec.argument_spec,
supports_check_mode=self.spec.supports_check_mode
)
mm = ModuleManager(module=module)
# Override methods to force specific logic in the module to happen
mm.exists = Mock(return_value=False)
mm.create_on_device = Mock(return_value=True)
results = mm.exec_module()
assert results['changed'] is True
assert results['idle_timeout'] == 500