Repository URL to install this package:
Version:
6.0.0 ▾
|
#!/usr/bin/python
# Copyright (c) 2018-2019 Red Hat, Inc.
# Copyright (c) 2020 Infoblox, 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
DOCUMENTATION = '''
---
module: nios_dtc_lbdn
author: "Mauricio Teixeira (@badnetmask)"
version_added: "1.1.0"
short_description: Configure Infoblox NIOS DTC LBDN
description:
- Adds and/or removes instances of DTC Load Balanced Domain Name (LBDN)
objects from Infoblox NIOS servers. This module manages NIOS
C(dtc:lbdn) objects using the Infoblox WAPI interface over REST.
requirements:
- infoblox-client
extends_documentation_fragment: infoblox.nios_modules.nios
notes:
- This module supports C(check_mode).
options:
name:
description:
- Specifies the display name of the DTC LBDN, not DNS related.
required: true
type: str
lb_method:
description:
- Configures the load balancing method. Used to select pool.
required: true
type: str
choices:
- GLOBAL_AVAILABILITY
- RATIO
- ROUND_ROBIN
- TOPOLOGY
auth_zones:
description:
- List of linked authoritative zones.
- When using I(auth_zones), you must specify at least one
I(patterns)
required: false
type: list
elements: str
patterns:
description:
- Specify LBDN wildcards for pattern match.
required: false
type: list
elements: str
types:
description:
- Specifies the list of resource record types supported by LBDN.
- This option will work properly only if you set the C(wapi_version)
variable on your C(provider) variable to a
number higher than "2.6".
required: false
type: list
elements: str
choices:
- A
- AAAA
- CNAME
- NAPTR
- SRV
pools:
description:
- The pools used for load balancing.
required: false
type: list
elements: dict
suboptions:
pool:
description:
- Provide the name of the pool to link with
required: true
type: str
ratio:
description:
- Provide the weight of the pool
default: 1
required: false
type: int
ttl:
description:
- The Time To Live (TTL) value for the DTC LBDN. A 32-bit unsigned
integer that represents the duration, in seconds, for which the
record is valid (cached). Zero indicates that the record should
not be cached.
type: int
extattrs:
description:
- Allows for the configuration of Extensible Attributes on the
instance of the object. This argument accepts a set of key / value
pairs for configuration.
type: dict
comment:
description:
- Configures a text string comment to be associated with the instance
of this object. The provided text string will be configured on the
object instance.
type: str
state:
description:
- Configures the intended state of the instance of the object on
the NIOS server. When this value is set to C(present), the object
is configured on the device and when this value is set to C(absent)
the value is removed (if necessary) from the device.
default: present
choices:
- present
- absent
type: str
'''
EXAMPLES = '''
- name: Configure a DTC LBDN
infoblox.nios_modules.nios_dtc_lbdn:
name: web.ansible.com
lb_method: ROUND_ROBIN
pools:
- pool: web_pool
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Add a comment to a DTC LBDN
infoblox.nios_modules.nios_dtc_lbdn:
name: web.ansible.com
lb_method: ROUND_ROBIN
comment: this is a test comment
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Remove a DTC LBDN from the system
infoblox.nios_modules.nios_dtc_lbdn:
name: web.ansible.com
lb_method: ROUND_ROBIN
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
'''
RETURN = ''' # '''
from ..module_utils.api import NIOS_DTC_LBDN
from ..module_utils.api import WapiModule
from ..module_utils.api import normalize_ib_spec
from ansible.module_utils.six import iteritems
from ansible.module_utils.basic import AnsibleModule
def main():
''' Main entry point for module execution
'''
def auth_zones_transform(module):
zone_list = list()
if module.params['auth_zones']:
for zone in module.params['auth_zones']:
zone_obj = wapi.get_object('zone_auth',
{'fqdn': zone})
if zone_obj is not None:
zone_list.append(zone_obj[0]['_ref'])
else:
module.fail_json(
msg='auth_zone %s cannot be found.' % zone)
# epdb.serve()
return zone_list
def pools_transform(module):
pool_list = list()
if module.params['pools']:
for pool in module.params['pools']:
pool_obj = wapi.get_object('dtc:pool',
{'name': pool['pool']})
if 'ratio' not in pool:
pool['ratio'] = 1
if pool_obj is not None:
pool_list.append({'pool': pool_obj[0]['_ref'],
'ratio': pool['ratio']})
else:
module.fail_json(msg='pool %s cannot be found.' % pool)
return pool_list
auth_zones_spec = dict()
pools_spec = dict(
pool=dict(required=True),
ratio=dict(type='int', default=1)
)
ib_spec = dict(
name=dict(required=True, ib_req=True),
lb_method=dict(required=True, choices=['GLOBAL_AVAILABILITY',
'RATIO', 'ROUND_ROBIN', 'TOPOLOGY']),
auth_zones=dict(type='list', elements='str', options=auth_zones_spec,
transform=auth_zones_transform),
patterns=dict(type='list', elements='str'),
types=dict(type='list', elements='str', choices=['A', 'AAAA', 'CNAME', 'NAPTR',
'SRV']),
pools=dict(type='list', elements='dict', options=pools_spec,
transform=pools_transform),
ttl=dict(type='int'),
extattrs=dict(type='dict'),
comment=dict(),
)
argument_spec = dict(
provider=dict(required=True),
state=dict(default='present', choices=['present', 'absent'])
)
argument_spec.update(normalize_ib_spec(ib_spec))
argument_spec.update(WapiModule.provider_spec)
module = AnsibleModule(argument_spec=argument_spec,
supports_check_mode=True)
wapi = WapiModule(module)
result = wapi.run(NIOS_DTC_LBDN, ib_spec)
module.exit_json(**result)
if __name__ == '__main__':
main()