VhbdZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z ddlZddlZe j d ZGd d ZGd d ZGddZGddZGddZdZdZedk(reyy)z] Ansible module for managing resource group deployments on Dell Technologies (Dell) PowerFlex)absolute_importdivisionprint_functiona module: resource_group version_added: '2.3.0' short_description: Manage resource group deployments on Dell PowerFlex. description: - Managing resource group deployments on PowerFlex storage system includes deploying, editing, adding nodes and deleting a resource group deployment. author: - Jennifer John (@johnj9) - Trisha Datta (@trisha-dell) extends_documentation_fragment: - dellemc.powerflex.powerflex options: resource_group_name: description: - The name of the resource group. - This is a required field to deploy a resource group. - Either I(resource_group_id) or I(resource_group_name) must be specified to perform resource group operations. - Mutually exclusive with I(resource_group_id). type: str resource_group_id: description: - The ID of the resource group. - Either I(resource_group_id) or I(resource_group_name) must be specified to perform resource group operations. - Mutually exclusive with I(resource_group_name). type: str template_name: description: - The name of the published template. - Either I(template_id) or I(template_name) must be specified to deploy a resource group. - Mutually exclusive with I(template_id). type: str template_id: description: - The ID of the published template. - Either I(template_id) or I(template_name) must be specified to deploy a resource group. - Mutually exclusive with I(template_name). type: str firmware_repository_id: description: - The ID of the firmware repository if not using the appliance default catalog. - Mutually exclusive with I(firmware_repository_name). type: str firmware_repository_name: description: - The name of the firmware repository if not using the appliance default catalog. - Mutually exclusive with I(firmware_repository_id). type: str new_resource_group_name: description: - New name of the resource group to rename to. type: str description: description: - The description of the resource group. type: str scaleup: description: - Whether to scale up the resource group. Specify as true to add nodes to the resource group. type: bool default: false clone_node: description: - Resource to duplicate during scaleup, if more than one nodes are available in the resource group. type: str node_count: description: - Number of nodes to clone during scaleup. type: int default: 1 validate: description: - Specify as true to validate the deployment of resource group. type: bool default: false schedule_date: description: - Scheduled date for the resource group deployment. - Specify in YYYY-MM-DD HH:MM:SS.sss or YYYY-MM-DD format. type: str state: description: - The state of the resource group. type: str choices: ['absent', 'present'] default: 'present' notes: - The I(check_mode) is supported. - Resource group scale up can be done only when deployment is complete. aJ - name: Validate deployment of a resource group dellemc.powerflex.resource_group: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" port: "{{ port }}" resource_group_name: "{{ resource_group_name_1 }}" description: ans_rg template_id: c65d0172-8666-48ab-935e-9a0bf69ed66d firmware_repository_id: 8aaa80788b5755d1018b576126d51ba3 validate: true - name: Deploy a resource group dellemc.powerflex.resource_group: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" port: "{{ port }}" resource_group_name: "{{ resource_group_name_1 }}" description: ans_rg template_id: c65d0172-8666-48ab-935e-9a0bf69ed66d firmware_repository_id: 8aaa80788b5755d1018b576126d51ba3 - name: Add a node to a resource group dellemc.powerflex.resource_group: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" resource_group_name: "{{ resource_group_name_1 }}" scaleup: true clone_node: "{{ node_1 }}" node_count: "{{ node_count }}" - name: Modify a resource group dellemc.powerflex.resource_group: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" resource_group_name: "{{ resource_group_name_1 }}" new_resource_group_name: "{{ new_resource_group_name }}" description: "description new" - name: Delete a resource group dellemc.powerflex.resource_group: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" port: "{{ port }}" resource_group_name: ans_rg state: "absent" a changed: description: Whether or not the resource has changed. returned: always type: bool sample: 'false' resource_group_details: description: Details of the resource group deployment. returned: When resource group exists. type: dict contains: id: description: The ID of the deployed resource group. type: str deploymentName: description: The name of the resource group deployment. type: str deploymentDescription: description: The description of the resource group deployment. type: str serviceTemplate: description: The service template of the resource group. type: dict contains: id: description: The ID of the service template. type: str templateName: description: The name of the service template. type: str status: description: The status of the deployment of the resource group. type: str firmwareRepositoryId: description: The ID of the firmware repository of the resource group. type: str sample: { "id": "8aaa03a88de961fa018de96a88d80008", "deploymentName": "dep-ans-test-rg1", "deploymentDescription": "ans test rg", "retry": true, "teardown": false, "serviceTemplate": { "id": "8aaa03a88de961fa018de96a88d80008", "templateName": "update-template (8aaa03a88de961fa018de96a88d80008)" }, "scheduleDate": null, "status": "error", "compliant": true, "deploymentDevice": [ { "refId": "scaleio-block-legacy-gateway", "refType": "SCALEIO", "deviceHealth": "GREEN", "compliantState": "COMPLIANT", "deviceType": "scaleio", "currentIpAddress": "1.3.9.2", "componentId": "910bf934-d45a-4fe3-8ea2-dc481e063a81", "statusMessage": "The processing of PowerFlex is unsuccessful.", "model": "PowerFlex Gateway", "brownfield": false } ], "updateServerFirmware": true, "useDefaultCatalog": true, "firmwareRepository": { "id": "8aaa80788b5755d1018b576126d51ba3", "name": "PowerFlex 4.5.0.0", "rcmapproved": false }, "firmwareRepositoryId": "8aaa80788b5755d1018b576126d51ba3", "deploymentHealthStatusType": "red", "allUsersAllowed": false, "owner": "admin", "numberOfDeployments": 0, "lifecycleMode": false, "vds": false, "scaleUp": false, "brownfield": false, "templateValid": true, "configurationChange": false } ) AnsibleModule)utilsNresource_groupcZeZdZdZddZddZdZdZdZdZ d Z d Z dd Z d Z d Zy)PowerFlexResourceGroupcPtj|_|jjt ddgddgddgg}ddgg}t |j||d|_tj|j  tj|j j|_ tjd y #t$rM}tjt||j j!t| Yd }~y d }~wwxYw) z. Define all parameters required by this moduleresource_group_nameresource_group_id template_name template_idfirmware_repository_idfirmware_repository_nameT) argument_specmutually_exclusiverequired_one_ofsupports_check_modez3Got the PowerFlex system connection object instancemsgN)r%get_powerflex_gateway_host_parameters module_paramsupdate'get_powerflex_resource_group_parametersrmoduleensure_required_libs%get_powerflex_gateway_host_connectionparamspowerflex_connLOGinfo Exceptionerrorstr fail_json)self mut_ex_argsrequired_one_of_argses t/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/powerflex/plugins/modules/resource_group.py__init__zPowerFlexResourceGroup.__init__s"HHJ !!"I"KL-/BC'702LMO "78K LM$,,*0 $ & ""4;;/ ."'"M"M ""#$D  HHJ K . IIc!f  KK ! !c!f ! - - .s AC D%AD  D%Ncj|s|s|jjd|r`tj|}|jj j |g}|s"d|d}|jj||xsdd}|jj j||S)a, Retrieves a service template based on the provided parameters. Args: template_id (str, optional): The ID of the service template. Defaults to None. template_name (str, optional): The name of the service template. Defaults to None. for_deployment (bool, optional): Indicates whether the template is for deployment. Defaults to True. Returns: ServiceTemplate: The retrieved service template. Raises: AnsibleFailJson: If either `template_id` or `template_name` is not specified for resource group deployment. AnsibleFailJson: If the service template with the specified `template_name` is not found. AnsibleFailJson: If the service template with the specified `template_id` is not found. zSEither template_id or template_name must be specified for resource group deploymentrfilterszService template is not foundrid)rr&r get_filterr service_templateget get_by_id)r'rrfor_deployment filter_querytemplate error_msgs r+get_service_templatez+PowerFlexResourceGroup.get_service_templates"} KK ! !&{ ! |  ++M:L**;;???WH/ mL  %%)%4!6Xa[%6 ""33==k>ZZc|jjj}rtfd|Dd}ntfd|Dd}|s$|jj dxsd|dS)a Retrieves the firmware repository ID based on the provided firmware repository name or ID. Args: firmware_repo_id (str, optional): The ID of the firmware repository. Defaults to None. firmware_repo_name (str, optional): The name of the firmware repository. Defaults to None. Returns: str: The ID of the firmware repository. Raises: ValueError: If the firmware repository is not found. c3LK|]}|jdk(s|yw)r1Nr4).0repofirmware_repo_ids r+ z;PowerFlexResourceGroup.get_firmware_repo..Gs!!h4TXXd^WgEg$!h$$Nc3LK|]}|jdk(s|yw)nameNr>)r?r@firmware_repo_names r+rBz;PowerFlexResourceGroup.get_firmware_repo..Is"!l4TXXfEUYkEk$!lrCzFirmware repository r0rr1)r firmware_repositoryr4nextrr&)r'rArFfirmware_repos firmware_repos `` r+get_firmware_repoz(PowerFlexResourceGroup.get_firmware_repo7s~,,@@DDF  !h>!hjnoM !l>!lnrsM KK ! !(<=M=cQc %%%*C*CCF*K%LL  Ms$AA=$A== C1$C,/8C,,C1c X|jsttttd}n+ttttttttd}|j j d}|j j d}|j j}|j|||fS)z Get the operation mapping based on the deployment details and module parameters. :return: The operation mapping for the given state, validate, and check_mode. )presentTTrTFrFTrFF))absentTT)rTF)rFT)rFFrrrrstatevalidate) deployment_detailsValidateDeployDeploy DeleteDeployModifyResourceGrouprrrr4)r'operation_mappingrrrs r+get_operation_mappingz,PowerFlexResourceGroup.get_operation_mappings &&)7*8*8+1 ! )5)5)5*6)<*=*=+> !  ""7+;;%%j1[[++  $$eXz%BCCr;cBtdg}|j|jjd|jjd|_|j }|r|j |\}}||d<||d<|jjd i|y) z} Perform the module operation. :return: A dictionary containing the result of the module operation. F)changedresource_group_detailsr r )rrrrN)dictrrrrrexecute exit_json)r'resultresource_group_operationrrs r+perform_module_operationz/PowerFlexResourceGroup.perform_module_operation s #%  #'"="= KK../DE++,,-@A#>#C$(#=#=#? #.F.N.Nt.T +G+/EF+ , 'F9  ''r;)NNT)NN)__name__ __module__ __qualname__r,r:rKrMrVrfr}rrrrrrr;r+r r sC.6[:#.# (4.@+BM8D>(r;r ceZdZdZy)rc |j}|jjj|}d|fS#t$rG}dt j t|}|jj|Yd}~yd}~wwxYw)NTz-Deploying a resource group failed with error r) rr rcreater#rrr%rr&r'rresponser*rs r+rzDeploy.execute%s ...0G**55< ! .DUE^E^_bcd_eEfDghF KK ! !f ! - - .8; B =BB Nrrrrrr;r+rr$.r;rceZdZdZy)rc |j}|jjj|}d|fS#t$rG}dt j t|}|jj|Yd}~yd}~wwxYw)NFz9Validating a resource group deployment failed with error r) rr rrr#rrr%rr&rs r+rzValidateDeploy.execute0s ...0G**55>>wGH(? " .PQVQjQjknopkqQrPstF KK ! !f ! - - .rNrrr;r+rr/rr;rceZdZdZy)rcD d}|j}|j|r|j|d}|j|d}||fS#t$rG}dt j t|}|jj|Yd}~yd}~wwxYw)NF)rTTr1)rz+Editing a resource group failed with error r) rrVrrr#rrr%rr&)r'rrrr*rs r+rzModifyResourceGroup.execute;s .G--G$$W$=2272K222OHH$ $ .B5C\C\]`ab]cCdBefF KK ! !f ! - - .sA A B=BBNrrr;r+rr: .r;rceZdZdZy)rc d}|jrn|jjsV|jjj |jd|j |jd|_d}||jfS#t$rG}dtjt|}|jj|Yd}~yd}~wwxYw)NFr1rP)rTz7Deleting a resource group deployment failed with error r) rrrr rdeleterr#rrr%r&)r'rr*rs r+rzDeleteDeploy.executeKs .G&&{{--''2299$:Q:QRV:WX33DD[D[\lDm3n+D333 3 .NuOhOhilmnioOpNqrF KK ! !f ! - - .sB B C=CCNrrr;r+rrJrr;rc8t}|jy)zk Create PowerFlex resource group object and perform actions on it based on user input from playbookN)r r)objs r+mainrZs ! "C  "r;c0ttttttttttddttddtddttddgd S) zWThis method provides parameters required for the resource group module on PowerFlexboolF)rZdefaultintr\rr)choicesr)r r rrrrrOrQrSr]rrrr)rrr;r+rrasp  F&fF#v!% $F&%06UA.651fIx0)D r;__main__)__doc__ __future__rrrrZ __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrGansible_collections.dellemc.powerflex.plugins.module_utils.storage.dellrrr get_loggerr!r rrrrrrrrr;r+rs dBB Y v8 tR j5 e'(c(c(L .... . . . . #* zFr;