diff --git a/library/decort_osimage.py b/library/decort_osimage.py index 9c91b30..46c485b 100644 --- a/library/decort_osimage.py +++ b/library/decort_osimage.py @@ -22,8 +22,7 @@ description: > This module can be used to obtain image ID of an OS image in DECORT cloud to use with subsequent calls to decort_vm module for batch VM provisioning. It will speed up VM creation and save a bunch of extra calls to DECORT cloud controller on each VM creation act. - Note that this module is effectively an information provisioner. It is not designed to and does not manage - nor change state of OS image (or any other) objects in DECORT cloud. + version_added: "2.2" author: - Sergey Shubin @@ -109,10 +108,6 @@ options: - 'This parameter is required when I(authenticator=legacy) and ignored for other authentication modes.' - If not specified in the playbook, the value will be taken from DECORT_USER environment variable. required: no - vdc_id: - description: - - ID of the VDC to limit the search of the OS image to. - required: no verify_ssl: description: - 'Controls SSL verification mode when making API calls to DECORT controller. Set it to False if you @@ -134,19 +129,138 @@ options: - 'This context data is expected to uniquely identify the task carried out by this module invocation so that up-level orchestrator could match returned information to the its internal entities.' required: no + + + + account_name: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + virt_id: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + virt_name: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + state: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + drivers: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + architecture: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + imagetype: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + boottype: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + url: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + sepId: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + poolName: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + hotresize: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + image_username: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + image_password: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + usernameDL: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + passwordDL: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + permanently: + description: + - 'Context data that will be included into the payload of the API call directed at I(workflow_callback) URL.' + required: no + + + + + + + + ''' EXAMPLES = ''' -- name: locate OS image specified by its name, store result in image_to_use variable. + - name: create_osimage + decort_osimage: + authenticator: oauth2 + verify_ssl: False + controller_url: "https://ds1.digitalenergy.online" + state: present + image_name: "alpine_linux3.14.0" + account_Id: 12345 + url: "https://dl-cdn.alpinelinux.org/alpine/v3.14/releases/x86_64/alpine-virt-3.14.0-x86_64.iso" + boottype: "uefi" + imagetype: "linux" + hotresize: False + image_username: "test" + image_password: "p@ssw0rd" + usernameDL: "testDL" + passwordDL: "p@ssw0rdDL" + architecture: "X86_64" + drivers: "KVM_X86" + delegate_to: localhost + register: osimage + + - name: get_osimage + decort_osimage: + authenticator: oauth2 + controller_url: "https://ds1.digitalenergy.online" + image_name: "alpine_linux_3.14.0" + account_Id: 12345 + delegate_to: localhost + register: osimage + + - name: create_virtual_osimage decort_osimage: authenticator: oauth2 - app_id: "{{ MY_APP_ID }}" - app_secret: "{{ MY_APP_SECRET }}" controller_url: "https://ds1.digitalenergy.online" - image_name: "Ubuntu 18.04 v1.2.5" - account_name: "GreyseDevelopment" + image_name: "alpine_linux_3.14.0" + virt_name: "alpine_last" delegate_to: localhost - register: image_to_use + register: osimage + + - name: rename_osimage + decort_osimage: + authenticator: oauth2 + controller_url: "https://ds1.digitalenergy.online" + image_name: "alpine_linux_3.14.0v2.0" + image_id: 54321 + delegate_to: localhost + register: osimage + + + ''' RETURN = ''' @@ -157,6 +271,7 @@ facts: sample: facts: id: 100 + linkto: 80 name: "Ubuntu 16.04 v1.0" size: 3 sep_id: 1 @@ -171,94 +286,205 @@ from ansible.module_utils.basic import env_fallback from ansible.module_utils.decort_utils import * +class decort_osimage(DecortController): + def __init__(self,amodule): + super(decort_osimage, self).__init__(amodule) -def decort_osimage_package_facts(arg_osimage_facts, arg_check_mode=False): - """Package a dictionary of OS image according to the decort_osimage module specification. This - dictionary will be returned to the upstream Ansible engine at the completion of the module run. + self.validated_image_id = 0 + self.validated_virt_image_id = 0 + self.validated_image_name = amodule.params['image_name'] + self.validated_virt_image_name = None + self.validated_virt_image_id = amodule.params['virt_id'] + if amodule.params['account_name']: + self.validated_account_id, _ = self.account_find(amodule.params['account_name']) + else: + self.validated_account_id = amodule.params['account_Id'] + + if self.validated_account_id == 0: + # we failed either to find or access the specified account - fail the module + self.result['failed'] = True + self.result['changed'] = False + self.result['msg'] = ("Cannot find account '{}'").format(amodule.params['account_name']) + amodule.fail_json(**self.result) - @param arg_osimage_facts: dictionary with OS image facts as returned by API call to .../images/list - @param arg_check_mode: boolean that tells if this Ansible module is run in check mode. - @return: dictionary with OS image specs populated from arg_osimage_facts. - """ + if amodule.params['image_id'] != 0 and amodule.params['image_name']: + self.validated_image_id = amodule.params['image_id'] + if amodule.params['image_name']: + decort_osimage.decort_image_rename(self,amodule) + self.result['msg'] = ("Image renamed successfully") - ret_dict = dict(id=0, - name="none", - size=0, - type="none", - state="CHECK_MODE", - ) - if arg_check_mode: - # in check mode return immediately with the default values - return ret_dict - if arg_osimage_facts is None: - # if void facts provided - change state value to ABSENT and return - ret_dict['state'] = "ABSENT" - return ret_dict + def decort_image_find(self, amodule): + # function that finds the OS image + image_id, image_facts = self.image_find(image_id=amodule.params['image_id'], image_name=self.validated_image_name, + account_id=self.validated_account_id, rg_id=0, + sepid=amodule.params['sep_id'], + pool=amodule.params['pool']) + return image_id, image_facts + + def decort_virt_image_find(self, amodule): + # function that finds a virtual image + image_id, image_facts = self.virt_image_find(image_id=amodule.params['virt_id'], + account_id=self.validated_account_id, rg_id=0, + sepid=amodule.params['sep_id'], + virt_name=amodule.params['virt_name'], + pool=amodule.params['pool']) + return image_id, image_facts + + + + def decort_image_create(self,amodule): + # function that creates OS image + image_facts = self.image_create(img_name=self.validated_image_name, + url=amodule.params['url'], + gid=amodule.params['gid'], + boottype=amodule.params['boottype'], + imagetype=amodule.params['imagetype'], + hotresize=amodule.params['hotresize'], + username=amodule.params['image_username'], + password=amodule.params['image_password'], + account_Id=amodule.params['account_Id'], + usernameDL=amodule.params['usernameDL'], + passwordDL=amodule.params['passwordDL'], + sepId=amodule.params['sepId'], + poolName=amodule.params['poolName'], + architecture=amodule.params['architecture'], + drivers=amodule.params['drivers']) + self.result['changed'] = True + return image_facts + + def decort_virt_image_link(self,amodule): + # function that links an OS image to a virtual one + self.virt_image_link(imageId=self.validated_virt_image_id, targetId=self.validated_image_id) + image_id, image_facts = decort_osimage.decort_virt_image_find(self, amodule) + self.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) + self.result['msg'] = ("Image '{}' linked to virtual image '{}'").format(self.validated_image_id, + decort_osimage.decort_osimage_package_facts(image_facts)['id'],) + return image_id, image_facts - ret_dict['id'] = arg_osimage_facts['id'] - ret_dict['name'] = arg_osimage_facts['name'] - ret_dict['size'] = arg_osimage_facts['size'] - ret_dict['type'] = arg_osimage_facts['type'] - # ret_dict['arch'] = arg_osimage_facts['architecture'] - ret_dict['sep_id'] = arg_osimage_facts['sepId'] - ret_dict['pool'] = arg_osimage_facts['pool'] - ret_dict['state'] = arg_osimage_facts['status'] - - return ret_dict - -def decort_osimage_parameters(): - """Build and return a dictionary of parameters expected by decort_osimage module in a form accepted - by AnsibleModule utility class.""" - - return dict( - app_id=dict(type='str', - required=False, - fallback=(env_fallback, ['DECORT_APP_ID'])), - app_secret=dict(type='str', - required=False, - fallback=(env_fallback, ['DECORT_APP_SECRET']), - no_log=True), - authenticator=dict(type='str', - required=True, - choices=['legacy', 'oauth2', 'jwt']), - controller_url=dict(type='str', required=True), - image_name=dict(type='str', required=True), - jwt=dict(type='str', - required=False, - fallback=(env_fallback, ['DECORT_JWT']), - no_log=True), - oauth2_url=dict(type='str', + def decort_image_delete(self,amodule): + # function that removes an image + self.image_delete(imageId=amodule.image_id_delete, permanently=amodule.params['permanently']) + self.result['changed'] = True + self.result['msg'] = ("Image '{}' deleted").format(amodule.image_id_delete) + + def decort_virt_image_create(self,amodule): + # function that creates a virtual image + image_facts = self.virt_image_create(name=amodule.params['virt_name'], targetId=self.validated_image_id) + image_id, image_facts = decort_osimage.decort_virt_image_find(self, amodule) + self.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) + return image_id, image_facts + + def decort_image_rename(self,amodule): + # image renaming function + image_facts = self.image_rename(imageId=self.validated_image_id, name=amodule.params['image_name']) + self.result['msg'] = ("Image renamed successfully") + image_id, image_facts = decort_osimage.decort_image_find(self, amodule) + return image_id, image_facts + + + def decort_osimage_package_facts(arg_osimage_facts, arg_check_mode=False): + """Package a dictionary of OS image according to the decort_osimage module specification. This + dictionary will be returned to the upstream Ansible engine at the completion of the module run. + + @param arg_osimage_facts: dictionary with OS image facts as returned by API call to .../images/list + @param arg_check_mode: boolean that tells if this Ansible module is run in check mode. + + @return: dictionary with OS image specs populated from arg_osimage_facts. + """ + + ret_dict = dict(id=0, + name="none", + size=0, + type="none", + state="CHECK_MODE", ) + + if arg_check_mode: + # in check mode return immediately with the default values + return ret_dict + + if arg_osimage_facts is None: + # if void facts provided - change state value to ABSENT and return + ret_dict['state'] = "ABSENT" + return ret_dict + + ret_dict['id'] = arg_osimage_facts['id'] + ret_dict['name'] = arg_osimage_facts['name'] + ret_dict['size'] = arg_osimage_facts['size'] + ret_dict['type'] = arg_osimage_facts['type'] + # ret_dict['arch'] = arg_osimage_facts['architecture'] + ret_dict['sep_id'] = arg_osimage_facts['sepId'] + ret_dict['pool'] = arg_osimage_facts['pool'] + ret_dict['state'] = arg_osimage_facts['status'] + ret_dict['linkto'] = arg_osimage_facts['linkTo'] + return ret_dict + + + def decort_osimage_parameters(): + """Build and return a dictionary of parameters expected by decort_osimage module in a form accepted + by AnsibleModule utility class.""" + + return dict( + app_id=dict(type='str', required=False, - fallback=(env_fallback, ['DECORT_OAUTH2_URL'])), - password=dict(type='str', + fallback=(env_fallback, ['DECORT_APP_ID'])), + app_secret=dict(type='str', + required=False, + fallback=(env_fallback, ['DECORT_APP_SECRET']), + no_log=True), + authenticator=dict(type='str', + required=True, + choices=['legacy', 'oauth2', 'jwt']), + controller_url=dict(type='str', required=True), + jwt=dict(type='str', + required=False, + fallback=(env_fallback, ['DECORT_JWT']), + no_log=True), + oauth2_url=dict(type='str', + required=False, + fallback=(env_fallback, ['DECORT_OAUTH2_URL'])), + password=dict(type='str', + required=False, + fallback=(env_fallback, ['DECORT_PASSWORD']), + no_log=True), + pool=dict(type='str', required=False, default=""), + sep_id=dict(type='int', required=False, default=0), + account_name=dict(type='str', required=False), + account_Id=dict(type='int', required=False), + user=dict(type='str', required=False, - fallback=(env_fallback, ['DECORT_PASSWORD']), - no_log=True), - pool=dict(type='str', required=False, default=""), - sep_id=dict(type='int', required=False, default=0), - account_name=dict(type='str', required=True), - user=dict(type='str', - required=False, - fallback=(env_fallback, ['DECORT_USER'])), - vdc_id=dict(type='int', required=False, default=0), - verify_ssl=dict(type='bool', required=False, default=True), - workflow_callback=dict(type='str', required=False), - workflow_context=dict(type='str', required=False), - ) - -# Workflow digest: -# 1) authenticate to DECORT controller & validate authentication by issuing API call - done when -# creating DecortController -# 2) obtain a list of OS images accessible to the specified account (and optionally - within -# the specified VDC) -# 3) match specified OS image by its name - if image is not found abort the module -# 5) report result to Ansible + fallback=(env_fallback, ['DECORT_USER'])), + verify_ssl=dict(type='bool', required=False, default=True), + workflow_callback=dict(type='str', required=False), + workflow_context=dict(type='str', required=False), + image_name=dict(type='str', required=False), + image_id=dict(type='int', required=False,default=0), + virt_id=dict(type='int', required=False, default=0), + virt_name=dict(type='str', required=False), + state=dict(type='str', + default='present', + choices=['absent', 'present']), + drivers=dict(type='str', required=False, default="KVM_X86"), + architecture=dict(type='str', required=False, default="X86_64"), + imagetype=dict(type='str', required=False, default="linux"), + boottype=dict(type='str', required=False, default="uefi"), + url=dict(type='str', required=False), + gid=dict(type='int', required=False, default=0), + sepId=dict(type='int', required=False, default=0), + poolName=dict(type='str', required=False), + hotresize=dict(type='bool', required=False, default=False), + image_username=dict(type='str', required=False), + image_password=dict(type='str', required=False), + usernameDL=dict(type='str', required=False), + passwordDL=dict(type='str', required=False), + permanently=dict(type='bool', required=False, default=False), + ) + def main(): - module_parameters = decort_osimage_parameters() + module_parameters = decort_osimage.decort_osimage_parameters() amodule = AnsibleModule(argument_spec=module_parameters, supports_check_mode=True, @@ -273,30 +499,67 @@ def main(): ], ) - decon = DecortController(amodule) + decon = decort_osimage(amodule) + + if amodule.params['image_name'] or amodule.params['image_id']: + image_id, image_facts = decort_osimage.decort_image_find(decon, amodule) + decon.validated_image_id = decort_osimage.decort_osimage_package_facts(image_facts)['id'] + if decort_osimage.decort_osimage_package_facts(image_facts)['id'] > 0: + decon.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) + + if amodule.params['state'] == "present" and decon.validated_image_id == 0 and amodule.params['image_name'] and amodule.params['url']: + decort_osimage.decort_image_create(decon,amodule) + decon.result['changed'] = True + image_id, image_facts = decort_osimage.decort_image_find(decon, amodule) + decon.result['msg'] = ("OS image '{}' created").format(decort_osimage.decort_osimage_package_facts(image_facts)['id']) + decon.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) + decon.validated_image_id = decort_osimage.decort_osimage_package_facts(image_facts)['id'] + + + elif amodule.params['state'] == "absent" and amodule.params['image_name'] or amodule.params['image_id'] and decort_osimage.decort_osimage_package_facts(image_facts)['accountId'] == amodule.params['account_Id']: + amodule.image_id_delete = decon.validated_image_id + decort_osimage.decort_image_delete(decon,amodule) + + + + if amodule.params['virt_name'] or amodule.params['virt_id']: + + image_id, image_facts = decort_osimage.decort_virt_image_find(decon, amodule) + if decort_osimage.decort_osimage_package_facts(image_facts)['id'] > 0: + decon.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) + decon.validated_virt_image_id = decort_osimage.decort_osimage_package_facts(image_facts)['id'] + decon.validated_virt_image_name = decort_osimage.decort_osimage_package_facts(image_facts)['name'] + + + if decort_osimage.decort_osimage_package_facts(image_facts)['id'] == 0 and amodule.params['state'] == "present" and decon.validated_image_id > 0: + image_id, image_facts = decort_osimage.decort_virt_image_create(decon,amodule) + decon.result['msg'] = ("Virtual image '{}' created").format(decort_osimage.decort_osimage_package_facts(image_facts)['id']) + decon.result['changed'] = True + elif decort_osimage.decort_osimage_package_facts(image_facts)['id'] == 0 and amodule.params['state'] == "present" and decon.validated_image_id == 0: + decon.result['msg'] = ("Cannot find OS image") + amodule.fail_json(**decon.result) + + + if decon.validated_image_id: + if decort_osimage.decort_osimage_package_facts(image_facts)['linkto'] != decon.validated_image_id: + decort_osimage.decort_virt_image_link(decon,amodule) + decon.result['changed'] = True + amodule.exit_json(**decon.result) + + + if decon.validated_virt_image_id > 0 and amodule.params['state'] == "absent": + decon.result['msg'] = ("Osimage module cannot delete virtual images.") + decon.result['failed'] = True + amodule.exit_json(**decon.result) - # we need account ID to locate OS images - find the account by the specified name and get its ID - validated_account_id, _ = decon.account_find(amodule.params['account_name']) - if validated_account_id == 0: - # we failed either to find or access the specified account - fail the module - decon.result['failed'] = True - decon.result['changed'] = False - decon.result['msg'] = ("Cannot find account '{}'").format(amodule.params['account_name']) - amodule.fail_json(**decon.result) - image_id, image_facts = decon.image_find(image_id=0, image_name=amodule.params['image_name'], - account_id=validated_account_id, rg_id=0, - sepid=amodule.params['sep_id'], - pool=amodule.params['pool']) if decon.result['failed'] == True: # we failed to find the specified image - fail the module decon.result['changed'] = False amodule.fail_json(**decon.result) - decon.result['facts'] = decort_osimage_package_facts(image_facts, amodule.check_mode) - decon.result['changed'] = False # decort_osimage is a read-only module - make sure the 'changed' flag is set to False amodule.exit_json(**decon.result) - + if __name__ == "__main__": main() diff --git a/module_utils/decort_utils.py b/module_utils/decort_utils.py index fd8bb7d..b5f1f87 100644 --- a/module_utils/decort_utils.py +++ b/module_utils/decort_utils.py @@ -1266,7 +1266,6 @@ class DecortController(object): @return: image ID and dictionary with image specs. If no matching image found, 0 for ID and None for dictionary are returned, and self.result['failed']=True. """ - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "image_find") if image_id > 0: @@ -1302,7 +1301,8 @@ class DecortController(object): full_match = False if full_match: return image_record['id'], image_record - + self.result['failed'] = False + self.result['failed'] = True self.result['msg'] = ("Failed to find OS image by name '{}', SEP ID {}, pool '{}' for " "account ID '{}'.").format(image_name, @@ -1310,6 +1310,138 @@ class DecortController(object): account_id) return 0, None + def virt_image_find(self, image_id, virt_name, account_id, rg_id=0, sepid=0, pool=""): + """Locates virtual image specified by name and returns its facts as dictionary. + Primary use of this function is to obtain the ID of the image identified by its name and, + optionally SEP ID and/or pool name. Also note that only virtual images in status CREATED are + returned. + + @param (string) image_id: ID of the OS image to find. If non-zero ID is specified, then + virt_name is ignored. + @param (string) virt_name: name of the OS image to find. This argument is ignored if non-zero + image ID is passed. + @param (int) account_id: ID of the account for which the image will be looked up. If set to 0, + the account ID will be obtained from the specified RG ID. + @param (int) rg_id: ID of the RG to use as a reference when listing OS images. This argument is + ignored if non-zero image id and/or non-zero account_id are specified. + @param (int) sepid: ID of the SEP where the image should be present. If set to 0, there will be no + filtering by SEP ID and the first matching image will be returned. + @param (string) pool: name of the pool where the image should be present. If set to empty string, there + will be no filtering by pool name and first matching image will be returned. + + @return: image ID and dictionary with image specs. If no matching image found, 0 for ID and None for + dictionary are returned, and self.result['failed']=True. + """ + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "virt_image_find") + + + + if image_id > 0: + ret_image_id, ret_image_dict = self._image_get_by_id(image_id) + if (ret_image_id and + (sepid == 0 or sepid == ret_image_dict['sepId']) and + (pool == "" or pool == ret_image_dict['pool'])): + return ret_image_id, ret_image_dict + else: + validated_acc_id = account_id + if account_id == 0: + validated_rg_id, rg_facts = self._rg_get_by_id(rg_id) + if not validated_rg_id: + self.result['failed'] = True + self.result['msg'] = ("Failed to find RG ID {}, and account ID is zero.").format(rg_id) + return 0, None + validated_acc_id = rg_facts['accountId'] + + api_params = dict(accountId=validated_acc_id) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/list", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + images_list = json.loads(api_resp.content.decode('utf8')) + for image_record in images_list: + if image_record['name'] == virt_name and image_record['status'] == "CREATED" and image_record['type'] == "virtual": + if sepid == 0 and pool == "": + # if no filtering by SEP ID or pool name is requested, return the first match + return image_record['id'], image_record + full_match = True + if full_match: + return image_record['id'], image_record + + self.result['failed'] = True + self.result['msg'] = ("Failed to find virtual OS image by name '{}', SEP ID {}, pool '{}' for " + "account ID '{}'.").format(virt_name, + sepid, pool, + account_id) + + return 0, None + + def virt_image_create(self, name, targetId): + + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "virt_image_create") + + api_params = dict(name=name, targetId=targetId,) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/createVirtual", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + virt_image_dict = json.loads(api_resp.content.decode('utf8')) + + self.result['failed'] = False + self.result['changed'] = True + return 0, None + + def image_delete(self, imageId, permanently): + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "image_delete") + + api_params = dict(imageId=imageId, permanently=permanently,) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/delete", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + image_dict = json.loads(api_resp.content.decode('utf8')) + + self.result['changed'] = True + return 0, None + + + def image_create(self,img_name,url,gid,boottype,imagetype,architecture,drivers,hotresize,username,password,account_Id,usernameDL,passwordDL,sepId,poolName): + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "image_create") + + api_params = dict(name=img_name, url=url, + gid=gid, boottype=boottype, + imagetype=imagetype, architecture=architecture, + drivers=drivers, accountId=account_Id, + hotresize=hotresize, username=username, + password=password, usernameDL=usernameDL, + passwordDL=passwordDL, sepId=sepId, + poolName=poolName, + ) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/create", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + virt_image_dict = json.loads(api_resp.content.decode('utf8')) + self.result['failed'] = False + self.result['changed'] = True + return 0, None + + def virt_image_link(self, imageId, targetId): + + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "virt_image_link") + + api_params = dict(imageId=imageId, targetId=targetId,) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/link", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + link_image_dict = json.loads(api_resp.content.decode('utf8')) + self.result['failed'] = False + self.result['changed'] = True + + + return 0, None + + def image_rename(self, imageId, name): + self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "image_rename") + api_params = dict(imageId=imageId, name=name,) + api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/rename", api_params) + # On success the above call will return here. On error it will abort execution by calling fail_json. + link_image_dict = json.loads(api_resp.content.decode('utf8')) + self.result['failed'] = False + self.result['changed'] = True + + + ################################### # Resource Group (RG) manipulation methods ################################### @@ -2146,10 +2278,10 @@ class DecortController(object): expected_state = "" if vins_dict['status'] in ["CREATED", "ENABLED"] and desired_state == 'disabled': - vinsstate_api = "/restmachine/cloudapi/vins/disable" + rgstate_api = "/restmachine/cloudapi/vins/disable" expected_state = "DISABLED" elif vins_dict['status'] == "DISABLED" and desired_state == 'enabled': - vinsstate_api = "/restmachine/cloudapi/vins/enable" + rgstate_api = "/restmachine/cloudapi/vins/enable" expected_state = "ENABLED" if vinsstate_api != "": @@ -2166,7 +2298,7 @@ class DecortController(object): desired_state) return - def vins_update(self, vins_dict, ext_net_id, ext_ip_addr="", mgmtaddr=""): + def vins_update(self, vins_dict, ext_net_id, ext_ip_addr=""): """Update ViNS. Currently only updates to the external network connection settings and external IP address assignment are implemented. Note that as ViNS created at account level cannot have external connections, attempt @@ -2191,11 +2323,6 @@ class DecortController(object): self.result['msg'] = ("vins_update() in check mode: updating ViNS ID {}, name '{}' " "was requested.").format(vins_dict['id'], vins_dict['name']) return - if self.amodule.params['config_save'] and vins_dict['VNFDev']['customPrecfg']: - # only save config,no other modifictaion - self.result['changed'] = True - self._vins_vnf_config_save(vins_dict['VNFDev']['id']) - return if not vins_dict['rgId']: # this ViNS exists at account level - no updates are possible @@ -2247,78 +2374,7 @@ class DecortController(object): "no reconnection to default network will be done.").format(vins_dict['id'], gw_config[ 'ext_net_id']) - for iface in vins_dict['VNFDev']['interfaces']: - if iface['ipAddress'] == mgmtaddr: - if not iface['listenSsh']: - self._vins_vnf_addmgmtaddr(vins_dict['VNFDev']['id'],mgmtaddr) - elif mgmtaddr =="": - if iface['listenSsh'] and iface['name'] != "ens9": - self._vins_vnf_delmgmtaddr(vins_dict['VNFDev']['id'],iface['ipAddress']) - - if self.amodule.params['custom_config']: - if not vins_dict['VNFDev']['customPrecfg']: - self._vins_vnf_config_save(vins_dict['VNFDev']['id']) - self._vins_vnf_customconfig_set(vins_dict['VNFDev']['id']) - else: - if vins_dict['VNFDev']['customPrecfg']: - self._vins_vnf_customconfig_set(vins_dict['VNFDev']['id'],False) - - return - - def _vins_vnf_addmgmtaddr(self,dev_id,mgmtip): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "vins_vnf_addmgmtaddr") - api_params = dict(devId=dev_id,ip=mgmtip) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudbroker/vnfdev/addMgmtAddr", api_params) - if api_resp.status_code == 200: - self.result['changed'] = True - self.result['failed'] = False - else: - self.result['warning'] = ("_vins_vnf_addmgmtaddr(): failed to add MGMT addr VNFID {} iface ADDR {}. HTTP code {}, " - "response {}.").format(dev_id,mgmtip,api_resp.status_code, api_resp.reason) - return - - def _vins_vnf_delmgmtaddr(self,dev_id,mgmtip): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "vins_vnf_delmgmtaddr") - api_params = dict(devId=dev_id,ip=mgmtip) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudbroker/vnfdev/delMgmtAddr", api_params) - if api_resp.status_code == 200: - self.result['changed'] = True - self.result['failed'] = False - else: - self.result['warning'] = ("_vins_vnf_delmgmtaddr(): failed to delete MGMT addr VNFID {} iface ADDR {}. HTTP code {}, " - "response {}.").format(dev_id,mgmtip,api_resp.status_code, api_resp.reason) - return - def _vins_vnf_customconfig_set(self,dev_id,arg_mode=True): - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "vins_vnf_customconfig_set") - api_params = dict(devId=dev_id,mode=arg_mode) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudbroker/vnfdev/customSet", api_params) - if api_resp.status_code == 200: - self.result['changed'] = True - self.result['failed'] = False - else: - self.result['warning'] = ("_vins_vnf_customconfig_set(): failed to enable or disable Custom pre-config mode on the VNF device. {}. HTTP code {}, " - "response {}.").format(dev_id,api_resp.status_code, api_resp.reason) - return - - def _vins_vnf_config_save(self,dev_id): - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "vins_vnf_config_save") - api_params = dict(devId=dev_id) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudbroker/vnfdev/configSave", api_params) - if api_resp.status_code == 200: - self.result['changed'] = True - self.result['failed'] = False - else: - self.result['warning'] = ("_vins_vnf_config_set(): failed to Save configuration on the VNF device. {}. HTTP code {}, " - "response {}.").format(dev_id,api_resp.status_code, api_resp.reason) - return - - def vins_vnf_ifaceadd(self): - return - - def vins_vnf_ifaceremove(self): return ############################## @@ -2967,9 +3023,12 @@ class DecortController(object): return def k8s_provision(self, k8s_name, - k8ci_id,rg_id, master_count, + wg_name, k8ci_id, + rg_id, master_count, master_cpu, master_ram, - master_disk, default_worker, extnet_id, + master_disk, worker_count, + worker_cpu, worker_ram, + worker_disk, extnet_id, with_lb, annotation, ): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "k8s_provision") @@ -2979,31 +3038,20 @@ class DecortController(object): self.result['msg'] = ("k8s_provision() in check mode. Provision k8s '{}' in RG ID {} " "was requested.").format(k8s_name, rg_id) return 0 - def_wg_name = default_worker['name'] - def_wg_count = default_worker['num'] - def_wg_cpu = default_worker['cpu'] - def_wg_ram = default_worker['ram'] - def_wg_disk = default_worker['disk'] - def_wg_lab = default_worker['labels'] if "labels" in default_worker else None - def_wg_taints = default_worker['taints'] if "taints" in default_worker else None - def_wg_ann = default_worker['annotations'] if "annotations" in default_worker else None api_url = "/restmachine/cloudapi/k8s/create" api_params = dict(name=k8s_name, rgId=rg_id, k8ciId=k8ci_id, - workerGroupName=def_wg_name, + workerGroupName=wg_name, masterNum=master_count, masterCpu=master_cpu, masterRam=master_ram, masterDisk=master_disk, - workerNum=def_wg_count, - workerCpu=def_wg_cpu, - workerRam=def_wg_ram, - workerDisk=def_wg_disk, - labels=def_wg_lab, - taints=def_wg_taints, - annotations=def_wg_ann, + workerNum=worker_count, + workerCpu=worker_cpu, + workerRam=worker_ram, + workerDisk=worker_disk, extnetId=extnet_id, withLB=with_lb, desc=annotation, @@ -3065,7 +3113,7 @@ class DecortController(object): for rec_inn in arg_k8swg['k8sGroups']['workers']: for rec_out in arg_modwg: - if rec_inn['num'] != rec_out['num'] and rec_out['num'] != 0: + if rec_inn['num'] != rec_out['num']: count = rec_inn['num']-rec_out['num'] cmp_list = [] if count > 0: @@ -3088,9 +3136,6 @@ class DecortController(object): workerCpu=wg['cpu'], workerRam=wg['ram'], workerDisk=wg['disk'], - labels=wg['labels'] if "labels" in wg else None, - taints=wg['taints'] if "taints" in wg else None, - annotations=wg['annotations'] if "annotations" in wg else None, ) api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/k8s/workersGroupAdd", api_params) self.result['changed'] = True @@ -3140,349 +3185,4 @@ class DecortController(object): api_params = dict(k8sId=self.k8s_id) api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/k8s/getConfig", api_params) ret_conf = api_resp.content.decode('utf8') - return ret_conf - - ############################## - # - # Bservice management - # - ############################## - def bservice_get_by_id(self,bs_id): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_get_by_id") - - ret_bs_id = 0 - ret_bs_dict = dict() - - if not bs_id: - self.result['failed'] = True - self.result['msg'] = "bservice_get_by_id(): zero B-Service ID specified." - self.amodule.fail_json(**self.result) - - api_params = dict(serviceId=bs_id, ) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/bservice/get", api_params) - if api_resp.status_code == 200: - ret_bs_id = bs_id - ret_bs_dict = json.loads(api_resp.content.decode('utf8')) - else: - self.result['warning'] = ("bservice_get_by_id(): failed to get B-service by ID {}. HTTP code {}, " - "response {}.").format(bs_id, api_resp.status_code, api_resp.reason) - - return ret_bs_id, ret_bs_dict - def _bservice_rg_list(self,acc_id,rg_id): - ret_bs_dict=dict() - api_params = dict(accountId=acc_id,rgId=rg_id ) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/bservice/list", api_params) - if api_resp.status_code == 200: - ret_bs_dict = json.loads(api_resp.content.decode('utf8')) - else: - self.result['warning'] = ("bservice_rg_list(): failed to get B-service list. HTTP code {}, " - "response {}.").format(api_resp.status_code, api_resp.reason) - return ret_bs_dict - - def bservice_find(self,account_id,rg_id,bservice_name="",bservice_id = 0,check_state=True): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_find") - - if bservice_id == 0: - bs_rg_list = self._bservice_rg_list(account_id,rg_id) - for srv in bs_rg_list: - if bservice_name == srv['name']: - bservice_id = int(srv['id']) - - if bservice_id > 0: - ret_bs_id,ret_bs_dict = self.bservice_get_by_id(bservice_id) - return ret_bs_id,ret_bs_dict - else: - return bservice_id,None - - def bservice_provision(self,bs_name,rgid,sshuser=None,sshkey=None): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_provision") - - api_url = "/restmachine/cloudapi/bservice/create" - api_params = dict( - name = bs_name, - rgId = rgid, - sshUser = sshuser, - sshKey = sshkey, - ) - api_resp = self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['changed'] = True - ret_bservice_id = int(api_resp.content.decode('utf8')) - return ret_bservice_id - - def bservice_state(self,bs_dict,desired_state,started=True): - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_state") - - if desired_state == "present": - desired_state = "enabled" - - NOP_STATES_FOR_BS_CHANGE = ["MODELED", "DISABLING", "ENABLING", "DELETING", "DELETED", "DESTROYING", - "DESTROYED","RESTORYNG","RECONFIGURING"] - VALID_TARGET_STATES = ["enabled", "disabled"] - - if bs_dict['status'] in NOP_STATES_FOR_BS_CHANGE: - self.result['failed'] = False - self.result['msg'] = ("bservice_state(): no state change possible for ViNS ID {} " - "in its current state '{}'.").format(bs_dict['id'], bs_dict['status']) - return - - if desired_state not in VALID_TARGET_STATES: - self.result['failed'] = False - self.result['warning'] = ("bservice_state(): unrecognized desired state '{}' requested " - "for B-service ID {}. No B-service state change will be done.").format(desired_state, - bs_dict['id']) - return - - if self.amodule.check_mode: - self.result['failed'] = False - self.result['msg'] = ("bservice_state() in check mode: setting state of B-service ID {}, name '{}' to " - "'{}' was requested.").format(bs_dict['id'], bs_dict['name'], - desired_state) - return - - bsstate_api = "" # this string will also be used as a flag to indicate that API call is necessary - api_params = dict(serviceId=bs_dict['id']) - expected_state = "" - - if bs_dict['status'] in ["CREATED", "ENABLED"] and desired_state == 'disabled': - bsstate_api = "/restmachine/cloudapi/bservice/disable" - expected_state = "DISABLED" - elif bs_dict['status'] in ["CREATED", "DISABLED"] and desired_state == 'enabled': - bsstate_api = "/restmachine/cloudapi/bservice/enable" - expected_state = "ENABLED" - - if bsstate_api != "": - self.decort_api_call(requests.post, bsstate_api, api_params) - # On success the above call will return here. On error it will abort execution by calling fail_json. - self.result['failed'] = False - self.result['changed'] = True - bs_dict['status'] = expected_state - else: - self.result['failed'] = False - self.result['msg'] = ("bservice_state(): no state change required for B-service ID {} from current " - "state '{}' to desired state '{}'.").format(bs_dict['id'], - bs_dict['status'], - desired_state) - - start_api = "" - - if bs_dict['status'] in ["ENABLED","enabled"]: - if started == True and bs_dict['techStatus'] == "STOPPED": - start_api = "/restmachine/cloudapi/bservice/start" - t_state_expected = "STARTED" - if started == False and bs_dict['techStatus'] == "STARTED": - start_api = "/restmachine/cloudapi/bservice/stop" - t_state_expected = "STOPPED" - - if start_api != "": - self.decort_api_call(requests.post, start_api, api_params) - # On success the above call will return here. On error it will abort execution by calling fail_json. - self.result['failed'] = False - self.result['changed'] = True - bs_dict['techStatus'] = t_state_expected - else: - self.result['failed'] = False - self.result['msg'] = ("bservice_state(): no start/stop action required for B-service ID {} from current " - "techStatus '{}' to desired started = '{}'.").format(bs_dict['id'], - bs_dict['techStatus'], - started) - return - - def bservice_delete(self,bs_id,permanently=True): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_delete") - - if self.amodule.check_mode: - self.result['failed'] = False - self.result['msg'] = "bservice_delete() in check mode: delete B-Service ID {} was requested.".format(bs_id) - return - - api_params = dict(serviceId=bs_id,permanently=permanently) - self.decort_api_call(requests.post, "/restmachine/cloudapi/bservice/delete", api_params) - # On success the above call will return here. On error it will abort execution by calling fail_json. - self.result['failed'] = False - self.result['msg'] = "bservice_delete() B-Service ID {} was deleted.".format(bs_id) - self.result['changed'] = True - - return - -# -# GROUP MANAGE -# - def _group_get_by_id(self,bs_id,g_id): - - api_params = dict(serviceId=bs_id,compgroupId=g_id) - api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/bservice/groupGet", api_params) - if api_resp.status_code == 200: - ret_gr_id = g_id - ret_gr_dict = json.loads(api_resp.content.decode('utf8')) - else: - self.result['warning'] = ("group_get_by_id(): failed to get Group by ID {}. HTTP code {}, " - "response {}.").format(g_id, api_resp.status_code, api_resp.reason) - return ret_gr_id,ret_gr_dict - - def group_find(self,bs_id,bs_info,group_id=0,group_name=""): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_find") - - if group_id == 0: - try: - i = bs_info['groupsName'].index(group_name) - except: - return 0,None - group_id = int(bs_info['groups'][i]) - return self._group_get_by_id(bs_id,group_id) - - def group_state(self,bs_id,gr_id,desired_state): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_state") - - group_api="" - if desired_state == 'stopped': - group_api = "/restmachine/cloudapi/bservice/groupStop" - state_expected = "STOPPED" - else: - group_api = "/restmachine/cloudapi/bservice/groupStart" - state_expected = "STARTED" - api_params = dict( - serviceId=bs_id, - compgroupId=gr_id - ) - if group_api != "": - self.decort_api_call(requests.post, group_api, api_params) - # On success the above call will return here. On error it will abort execution by calling fail_json. - self.result['failed'] = False - self.result['changed'] = True - else: - self.result['failed'] = False - self.result['msg'] = ("group_state(): no start/stop action required for B-service ID {} " - "to desired state '{}'.").format(bs_id,desired_state) - return - def group_resize_count(self,bs_id,gr_dict,desired_count): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_resize_count") - - count = len(gr_dict['computes']) - if desired_count != count: - api_params=dict( - serviceId=bs_id, - compgroupId=gr_dict['id'], - count=desired_count, - mode="ABSOLUTE" - ) - api_url = "/restmachine/cloudapi/bservice/groupResize" - self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['changed'] = True - self.need_update_group_info = True - else: - self.result['failed'] = False - self.result['msg'] = ("group_resize_count(): no need resize Group ID {}.").format(gr_dict['id']) - return - def group_update_hw(self,bs_id,gr_dict,arg_cpu,arg_disk,arg_name,arg_role,arg_ram): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_update_hw") - - api_params=dict( - serviceId=bs_id, - compgroupId=gr_dict['id'], - force=True, - ) - - if gr_dict['cpu'] != arg_cpu: - api_params.update({'cpu': arg_cpu}) - if gr_dict['ram'] != arg_ram: - api_params.update({'ram': arg_ram}) - if gr_dict['role'] != arg_role: - api_params.update({'role': arg_role}) - if gr_dict['disk'] != arg_disk: - api_params.update({'disk': arg_disk}) - if gr_dict['name'] != arg_name: - api_params.update({'name': arg_name}) - - api_url = "/restmachine/cloudapi/bservice/groupUpdate" - if len(api_params) > 3: - # - self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['changed'] = True - self.need_update_group_info = True - else: - self.result['failed'] = False - self.result['msg'] = ("group_update_hw(): no need update Group ID {}.").format(gr_dict['id']) - return - - def group_update_net(self,bs_id,gr_dict,arg_net): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_update_net") - - list_vins= list() - list_extnet= list() - for net in arg_net: - if net['type'] == 'VINS': - list_vins.append(net['id']) - else: - list_extnet.append(net['id']) - - if gr_dict['vinses'] != list_vins: - api_url = "/restmachine/cloudapi/bservice/groupUpdateVins" - api_params = dict( - serviceId=bs_id, - compgroupId=gr_dict['id'], - vinses=list_vins - ) - self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['changed'] = True - - #extnet connection need stoped status of group - #rly need connect group to extnet ? - return - def group_provision( - self,bs_id,arg_name,arg_count=1,arg_cpu=1,arg_ram=1024, - arg_boot_disk=10,arg_image_id=0,arg_driver="KVM_X86",arg_role="", - arg_network=None,arg_timeout=0 - ): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_provision") - - list_vins= list() - for net in arg_network: - if net['type'] == 'VINS': - list_vins.append(net['id']) - api_url = "/restmachine/cloudapi/bservice/groupAdd" - api_params = dict( - serviceId = bs_id, - name = arg_name, - count = arg_count, - cpu = arg_cpu, - ram = arg_ram, - disk = arg_boot_disk, - imageId = arg_image_id, - driver = arg_driver, - role = arg_role, - vinses = list_vins, - timeoutStart = arg_timeout - ) - self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['changed'] = True - return - - def group_delete(self,bs_id,gr_id): - - self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "group_delete") - - api_url = "/restmachine/cloudapi/bservice/groupRemove" - api_params=dict( - serviceId = bs_id, - compgroupId = gr_id - ) - self.decort_api_call(requests.post, api_url, api_params) - self.result['failed'] = False - self.result['msg'] = "group_delete() Group ID {} was deleted.".format(gr_id) - self.result['changed'] = True - return + return ret_conf \ No newline at end of file