mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
b531ecdc9b
* Move files. * Update imports and references. * Move wrongly placed files. * Reverse redirects, deprecate long → short name redirects. * Simplify contribution guidelines for new modules. * Rewrite BOTMETA. * Add changelog fragment. * Fix ignore.txt files.
296 lines
10 KiB
Python
296 lines
10 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright (c) 2016, Hugh Ma <Hugh.Ma@flextronics.com>
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: stacki_host
|
|
short_description: Add or remove host to stacki front-end
|
|
description:
|
|
- Use this module to add or remove hosts to a stacki front-end via API.
|
|
- Information on stacki can be found at U(https://github.com/StackIQ/stacki).
|
|
options:
|
|
name:
|
|
description:
|
|
- Name of the host to be added to Stacki.
|
|
required: true
|
|
type: str
|
|
stacki_user:
|
|
description:
|
|
- Username for authenticating with Stacki API, but if not specified, the environment variable C(stacki_user) is used instead.
|
|
required: true
|
|
type: str
|
|
stacki_password:
|
|
description:
|
|
- Password for authenticating with Stacki API, but if not
|
|
specified, the environment variable C(stacki_password) is used instead.
|
|
required: true
|
|
type: str
|
|
stacki_endpoint:
|
|
description:
|
|
- URL for the Stacki API Endpoint.
|
|
required: true
|
|
type: str
|
|
prim_intf_mac:
|
|
description:
|
|
- MAC Address for the primary PXE boot network interface.
|
|
- Currently not used by the module.
|
|
type: str
|
|
prim_intf_ip:
|
|
description:
|
|
- IP Address for the primary network interface.
|
|
- Currently not used by the module.
|
|
type: str
|
|
prim_intf:
|
|
description:
|
|
- Name of the primary network interface.
|
|
- Currently not used by the module.
|
|
type: str
|
|
force_install:
|
|
description:
|
|
- Set value to C(true) to force node into install state if it already exists in stacki.
|
|
type: bool
|
|
default: false
|
|
state:
|
|
description:
|
|
- Set value to the desired state for the specified host.
|
|
type: str
|
|
choices: [ absent, present ]
|
|
default: present
|
|
appliance:
|
|
description:
|
|
- Applicance to be used in host creation.
|
|
- Required if I(state) is C(present) and host does not yet exist.
|
|
type: str
|
|
default: backend
|
|
rack:
|
|
description:
|
|
- Rack to be used in host creation.
|
|
- Required if I(state) is C(present) and host does not yet exist.
|
|
type: int
|
|
default: 0
|
|
rank:
|
|
description:
|
|
- Rank to be used in host creation.
|
|
- In Stacki terminology, the rank is the position of the machine in a rack.
|
|
- Required if I(state) is C(present) and host does not yet exist.
|
|
type: int
|
|
default: 0
|
|
network:
|
|
description:
|
|
- Network to be configured in the host.
|
|
- Currently not used by the module.
|
|
type: str
|
|
default: private
|
|
author:
|
|
- Hugh Ma (@bbyhuy) <Hugh.Ma@flextronics.com>
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- name: Add a host named test-1
|
|
community.general.stacki_host:
|
|
name: test-1
|
|
stacki_user: usr
|
|
stacki_password: pwd
|
|
stacki_endpoint: url
|
|
prim_intf_mac: mac_addr
|
|
prim_intf_ip: x.x.x.x
|
|
prim_intf: eth0
|
|
|
|
- name: Remove a host named test-1
|
|
community.general.stacki_host:
|
|
name: test-1
|
|
stacki_user: usr
|
|
stacki_password: pwd
|
|
stacki_endpoint: url
|
|
state: absent
|
|
'''
|
|
|
|
RETURN = '''
|
|
changed:
|
|
description: response to whether or not the api call completed successfully
|
|
returned: always
|
|
type: bool
|
|
sample: true
|
|
|
|
stdout:
|
|
description: the set of responses from the commands
|
|
returned: always
|
|
type: list
|
|
sample: ['...', '...']
|
|
|
|
stdout_lines:
|
|
description: the value of stdout split into a list
|
|
returned: always
|
|
type: list
|
|
sample: [['...', '...'], ['...'], ['...']]
|
|
'''
|
|
|
|
import json
|
|
|
|
from ansible.module_utils.basic import AnsibleModule, env_fallback
|
|
from ansible.module_utils.six.moves.urllib.parse import urlencode
|
|
from ansible.module_utils.urls import fetch_url
|
|
|
|
|
|
class StackiHost(object):
|
|
|
|
def __init__(self, module):
|
|
self.module = module
|
|
self.hostname = module.params['name']
|
|
self.rack = module.params['rack']
|
|
self.rank = module.params['rank']
|
|
self.appliance = module.params['appliance']
|
|
self.prim_intf = module.params['prim_intf']
|
|
self.prim_intf_ip = module.params['prim_intf_ip']
|
|
self.network = module.params['network']
|
|
self.prim_intf_mac = module.params['prim_intf_mac']
|
|
self.endpoint = module.params['stacki_endpoint']
|
|
|
|
auth_creds = {'USERNAME': module.params['stacki_user'],
|
|
'PASSWORD': module.params['stacki_password']}
|
|
|
|
# Get Initial CSRF
|
|
cred_a = self.do_request(self.endpoint, method="GET")
|
|
cookie_a = cred_a.headers.get('Set-Cookie').split(';')
|
|
init_csrftoken = None
|
|
for c in cookie_a:
|
|
if "csrftoken" in c:
|
|
init_csrftoken = c.replace("csrftoken=", "")
|
|
init_csrftoken = init_csrftoken.rstrip("\r\n")
|
|
break
|
|
|
|
# Make Header Dictionary with initial CSRF
|
|
header = {'csrftoken': init_csrftoken, 'X-CSRFToken': init_csrftoken,
|
|
'Content-type': 'application/x-www-form-urlencoded', 'Cookie': cred_a.headers.get('Set-Cookie')}
|
|
|
|
# Endpoint to get final authentication header
|
|
login_endpoint = self.endpoint + "/login"
|
|
|
|
# Get Final CSRF and Session ID
|
|
login_req = self.do_request(login_endpoint, headers=header, payload=urlencode(auth_creds), method='POST')
|
|
|
|
cookie_f = login_req.headers.get('Set-Cookie').split(';')
|
|
csrftoken = None
|
|
for f in cookie_f:
|
|
if "csrftoken" in f:
|
|
csrftoken = f.replace("csrftoken=", "")
|
|
if "sessionid" in f:
|
|
sessionid = c.split("sessionid=", 1)[-1]
|
|
sessionid = sessionid.rstrip("\r\n")
|
|
|
|
self.header = {'csrftoken': csrftoken,
|
|
'X-CSRFToken': csrftoken,
|
|
'sessionid': sessionid,
|
|
'Content-type': 'application/json',
|
|
'Cookie': login_req.headers.get('Set-Cookie')}
|
|
|
|
def do_request(self, url, payload=None, headers=None, method=None):
|
|
res, info = fetch_url(self.module, url, data=payload, headers=headers, method=method)
|
|
|
|
if info['status'] != 200:
|
|
self.module.fail_json(changed=False, msg=info['msg'])
|
|
|
|
return res
|
|
|
|
def stack_check_host(self):
|
|
res = self.do_request(self.endpoint, payload=json.dumps({"cmd": "list host"}), headers=self.header, method="POST")
|
|
return self.hostname in res.read()
|
|
|
|
def stack_sync(self):
|
|
self.do_request(self.endpoint, payload=json.dumps({"cmd": "sync config"}), headers=self.header, method="POST")
|
|
self.do_request(self.endpoint, payload=json.dumps({"cmd": "sync host config"}), headers=self.header, method="POST")
|
|
|
|
def stack_force_install(self, result):
|
|
data = {'cmd': "set host boot {0} action=install".format(self.hostname)}
|
|
self.do_request(self.endpoint, payload=json.dumps(data), headers=self.header, method="POST")
|
|
changed = True
|
|
|
|
self.stack_sync()
|
|
|
|
result['changed'] = changed
|
|
result['stdout'] = "api call successful".rstrip("\r\n")
|
|
|
|
def stack_add(self, result):
|
|
data = dict()
|
|
changed = False
|
|
|
|
data['cmd'] = "add host {0} rack={1} rank={2} appliance={3}"\
|
|
.format(self.hostname, self.rack, self.rank, self.appliance)
|
|
self.do_request(self.endpoint, payload=json.dumps(data), headers=self.header, method="POST")
|
|
|
|
self.stack_sync()
|
|
|
|
result['changed'] = changed
|
|
result['stdout'] = "api call successful".rstrip("\r\n")
|
|
|
|
def stack_remove(self, result):
|
|
data = dict()
|
|
|
|
data['cmd'] = "remove host {0}"\
|
|
.format(self.hostname)
|
|
self.do_request(self.endpoint, payload=json.dumps(data), headers=self.header, method="POST")
|
|
|
|
self.stack_sync()
|
|
|
|
result['changed'] = True
|
|
result['stdout'] = "api call successful".rstrip("\r\n")
|
|
|
|
|
|
def main():
|
|
module = AnsibleModule(
|
|
argument_spec=dict(
|
|
state=dict(type='str', default='present', choices=['absent', 'present']),
|
|
name=dict(type='str', required=True),
|
|
rack=dict(type='int', default=0),
|
|
rank=dict(type='int', default=0),
|
|
appliance=dict(type='str', default='backend'),
|
|
prim_intf=dict(type='str'),
|
|
prim_intf_ip=dict(type='str'),
|
|
network=dict(type='str', default='private'),
|
|
prim_intf_mac=dict(type='str'),
|
|
stacki_user=dict(type='str', required=True, fallback=(env_fallback, ['stacki_user'])),
|
|
stacki_password=dict(type='str', required=True, fallback=(env_fallback, ['stacki_password']), no_log=True),
|
|
stacki_endpoint=dict(type='str', required=True, fallback=(env_fallback, ['stacki_endpoint'])),
|
|
force_install=dict(type='bool', default=False),
|
|
),
|
|
supports_check_mode=False,
|
|
)
|
|
|
|
result = {'changed': False}
|
|
missing_params = list()
|
|
|
|
stacki = StackiHost(module)
|
|
host_exists = stacki.stack_check_host()
|
|
|
|
# If state is present, but host exists, need force_install flag to put host back into install state
|
|
if module.params['state'] == 'present' and host_exists and module.params['force_install']:
|
|
stacki.stack_force_install(result)
|
|
# If state is present, but host exists, and force_install and false, do nothing
|
|
elif module.params['state'] == 'present' and host_exists and not module.params['force_install']:
|
|
result['stdout'] = "{0} already exists. Set 'force_install' to true to bootstrap"\
|
|
.format(module.params['name'])
|
|
# Otherwise, state is present, but host doesn't exists, require more params to add host
|
|
elif module.params['state'] == 'present' and not host_exists:
|
|
for param in ['appliance', 'rack', 'rank', 'prim_intf', 'prim_intf_ip', 'network', 'prim_intf_mac']:
|
|
if not module.params[param]:
|
|
missing_params.append(param)
|
|
if len(missing_params) > 0: # @FIXME replace with required_if
|
|
module.fail_json(msg="missing required arguments: {0}".format(missing_params))
|
|
|
|
stacki.stack_add(result)
|
|
# If state is absent, and host exists, lets remove it.
|
|
elif module.params['state'] == 'absent' and host_exists:
|
|
stacki.stack_remove(result)
|
|
|
|
module.exit_json(**result)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|