VhLddlmZmZmZeZdZdZdZdZ ddl Z ddl Z ddl Z ddl mZddlmZdZ ddlZd ZdZ ddlZdd lmZd Zdd lmZmZGd dZdZe dk(reyy#e$re j*Zd ZYLwxYw#e$re j*Zd ZdZY]wxYw))absolute_importdivisionprint_functiona module: clc_loadbalancer short_description: Create, Delete shared loadbalancers in CenturyLink Cloud description: - An Ansible module to Create, Delete shared loadbalancers in CenturyLink Cloud. deprecated: removed_in: 11.0.0 why: > Lumen Public Cloud (formerly known as CenturyLink Cloud) has gone End-of-Life in September 2023. See more at U(https://www.ctl.io/knowledge-base/release-notes/2023/lumen-public-cloud-platform-end-of-life-notice/?). alternative: There is none. extends_documentation_fragment: - community.general.attributes - community.general.clc author: - "CLC Runner (@clc-runner)" attributes: check_mode: support: full diff_mode: support: none options: name: description: - The name of the loadbalancer. type: str required: true description: description: - A description for the loadbalancer. type: str alias: description: - The alias of your CLC Account. type: str required: true location: description: - The location of the datacenter where the load balancer resides in. type: str required: true method: description: - The balancing method for the load balancer pool. type: str choices: ['leastConnection', 'roundRobin'] persistence: description: - The persistence method for the load balancer. type: str choices: ['standard', 'sticky'] port: description: - Port to configure on the public-facing side of the load balancer pool. type: str choices: ['80', '443'] nodes: description: - A list of nodes that needs to be added to the load balancer pool. type: list default: [] elements: dict status: description: - The status of the loadbalancer. type: str default: enabled choices: ['enabled', 'disabled'] state: description: - Whether to create or delete the load balancer pool. type: str default: present choices: ['present', 'absent', 'port_absent', 'nodes_present', 'nodes_absent'] a # Note - You must set the CLC_V2_API_USERNAME And CLC_V2_API_PASSWD Environment variables before running these examples - name: Create Loadbalancer hosts: localhost connection: local tasks: - name: Actually Create things community.general.clc_loadbalancer: name: test description: test alias: TEST location: WA1 port: 443 nodes: - ipAddress: 10.11.22.123 privatePort: 80 state: present - name: Add node to an existing loadbalancer pool hosts: localhost connection: local tasks: - name: Actually Create things community.general.clc_loadbalancer: name: test description: test alias: TEST location: WA1 port: 443 nodes: - ipAddress: 10.11.22.234 privatePort: 80 state: nodes_present - name: Remove node from an existing loadbalancer pool hosts: localhost connection: local tasks: - name: Actually Create things community.general.clc_loadbalancer: name: test description: test alias: TEST location: WA1 port: 443 nodes: - ipAddress: 10.11.22.234 privatePort: 80 state: nodes_absent - name: Delete LoadbalancerPool hosts: localhost connection: local tasks: - name: Actually Delete things community.general.clc_loadbalancer: name: test description: test alias: TEST location: WA1 port: 443 nodes: - ipAddress: 10.11.22.123 privatePort: 80 state: port_absent - name: Delete Loadbalancer hosts: localhost connection: local tasks: - name: Actually Delete things community.general.clc_loadbalancer: name: test description: test alias: TEST location: WA1 port: 443 nodes: - ipAddress: 10.11.22.123 privatePort: 80 state: absent a loadbalancer: description: The load balancer result object from CLC. returned: success type: dict sample: { "description":"test-lb", "id":"ab5b18cb81e94ab9925b61d1ca043fb5", "ipAddress":"66.150.174.197", "links":[ { "href":"/v2/sharedLoadBalancers/wfad/wa1/ab5b18cb81e94ab9925b61d1ca043fb5", "rel":"self", "verbs":[ "GET", "PUT", "DELETE" ] }, { "href":"/v2/sharedLoadBalancers/wfad/wa1/ab5b18cb81e94ab9925b61d1ca043fb5/pools", "rel":"pools", "verbs":[ "GET", "POST" ] } ], "name":"test-lb", "pools":[ ], "status":"enabled" } z ${version}N)sleep) LooseVersionTF)APIFailedResponse) AnsibleModulemissing_required_libceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZedZdZedZy)ClcLoadBalancerNct|_||_i|_ts*|jj t dtts*|jj t dttjrAttjtdkr|jj d|j|jy)z" Construct module zclc-sdk)msg exceptionrequestsz2.5.0z,requests library version should be >= 2.5.0rN)clc_sdkclcmodulelb_dict CLC_FOUND fail_jsonr CLC_IMP_ERRREQUESTS_FOUNDREQUESTS_IMP_ERRr __version__r_set_user_agent)selfrs v/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/clc_loadbalancer.py__init__zClcLoadBalancer.__init__s   KK ! !&:9&EQ\ ! ] KK ! !&::&FRb ! c   L1E1E$FV]I^$^ KK ! !B " D TXX&c"d}d}|jjjd}|jjjd}|jjjd}|jjjd}|jjjd}|jjjd}|jjjd } |jjjd } |jjjd } |jjjd } ||}|j|j || |_| dk(rS|j ||||| \}}} |r|j| |||| |\}}}| r|j||||| \}}nx| dk(r|j|||\}}n[| dk(r|j||||\}}n=| dk(r|j||||| \}}n| dk(r|j||||| \}}|jj||y)zZ Execute the main code path, and handle the request :return: none FNnamealiaslocation descriptionportmethod persistencenodesstatusstate)r#r$presentr"r#r$r%r*)lb_idr#r$r'r(r&)r#r$r"r&r)absent)r"r#r$ port_absent)r#r$r"r& nodes_present nodes_absent)changed loadbalancer)rparamsget_set_clc_credentials_from_env_get_loadbalancer_listrensure_loadbalancer_presentensure_loadbalancerpool_presentensure_lbpool_nodes_setensure_loadbalancer_absentensure_loadbalancerpool_absentensure_lbpool_nodes_presentensure_lbpool_nodes_absent exit_json)rr3 result_lbloadbalancer_nameloadbalancer_aliasloadbalancer_locationloadbalancer_descriptionloadbalancer_portloadbalancer_methodloadbalancer_persistenceloadbalancer_nodesloadbalancer_statusr+r. result_poolpool_id result_nodess rprocess_requestzClcLoadBalancer.process_request s   KK..226:![[//33G< $ 2 2 6 6z B#';;#5#5#9#9-#H  KK..226:"kk0044X>#';;#5#5#9#9-#H ![[//33G<"kk0044X> ""&&w/ # +'8 $ **,22$*3,  I (,(H(H&(.4* )I), %GY !040T0T,2. 8* 1U1,-g&,0,H,H0!6..0 -I-2)G\ h !%!@!@&(."A"0 GY m #!%!D!D(.&& "E"( GY o %!%!A!A(.&&( "B"* GYn $!%!@!@(.&&( "A"* GY gIFr cd}|}|j|}|s?|jjs'|j|||||}|j d}d}|||fS)a Checks to see if a load balancer exists and creates one if it does not. :param name: Name of loadbalancer :param alias: Alias of account :param location: Datacenter :param description: Description of loadbalancer :param status: Enabled / Disabled :return: (changed, result, lb_id) changed: Boolean whether a change was made result: The result object from the CLC load balancer request lb_id: The load balancer id Fr"r-idT)_loadbalancer_existsr check_modecreate_loadbalancerr6) rr"r#r$r%r*r3resultr.s rr9z+ClcLoadBalancer.ensure_loadbalancer_present[sw))t)4;;))11t8=;C>I9? 2A  4(G%%r cd}|}|s|ddfS|j||||} | s@|jjs(|j||||||}|j d} d}||| fS)a Checks to see if a load balancer pool exists and creates one if it does not. :param lb_id: The loadbalancer id :param alias: The account alias :param location: the datacenter the load balancer resides in :param method: the load balancing method :param persistence: the load balancing persistence type :param port: the port that the load balancer will listen on :return: (changed, group, pool_id) - changed: Boolean whether a change was made result: The result from the CLC API call pool_id: The string id of the load balancer pool FNr#r$r&r.)r#r$r.r'r(r&rQT)_loadbalancerpool_existsrrScreate_loadbalancerpoolr6) rr.r#r$r'r(r&r3rUrLs rr:z/ClcLoadBalancer.ensure_loadbalancerpool_presentxsD$& &// 0 ;;))55%! + 6!**T*G''r cd}|}|j|}|r,|jjs|j|||}d}||fS)a\ Checks to see if a load balancer exists and deletes it if it does :param name: Name of the load balancer :param alias: Alias of account :param location: Datacenter :return: (changed, result) changed: Boolean whether a change was made result: The result from the CLC API Call FrP)r#r$r"T)rRrrSdelete_loadbalancer)rr"r#r$r3rU lb_existss rr<z*ClcLoadBalancer.ensure_loadbalancer_absents_--4-8 ;;))11;C7;2=Gr cd}d}|j|}|r`|j|}|j||||} | r1d}|jjs|j |||| }||fSd}||fSd}||fS) a Checks to see if a load balancer pool exists and deletes it if it does :param alias: The account alias :param location: the datacenter the load balancer resides in :param name: the name of the load balancer :param port: the port that the load balancer listens on :return: (changed, result) - changed: Boolean whether a change was made result: The result from the CLC API call FNrPrWT)r#r$r.rLPool doesn't existzLB Doesn't Exist)rR_get_loadbalancer_idrXrrSdelete_loadbalancerpool) rr#r$r"r&r3rUr\r.rLs rr=z.ClcLoadBalancer.ensure_loadbalancerpool_absents--4-8 --4-8E33! 4G {{--!99#!)# ' :)F.(Fr ci}d}|j|}|rc|j|} |j|||| } | r4|j||| | |} | sd}|j ||| | |}||fSd}||fSd}||fS) aI Checks to see if the provided list of nodes exist for the pool and set the nodes if any in the list those doesn't exist :param alias: The account alias :param location: the datacenter the load balancer resides in :param name: the name of the load balancer :param port: the port that the load balancer will listen on :param nodes: The list of nodes to be updated to the pool :return: (changed, result) - changed: Boolean whether a change was made result: The result from the CLC API call FrPrW)r#r$r.rLnodes_to_checkT)r#r$r.rLr)r^Load balancer doesn't Exist)rRr_rX_loadbalancerpool_nodes_existsset_loadbalancernodes) rr#r$r"r&r)rUr3r\r.rL nodes_exists rr;z'ClcLoadBalancer.ensure_lbpool_nodes_sets--4-8 --4-8E33! 4G "AAKSHMJQQV BX #"G!77eAI>C@G>C 8EF.3Fr cd}|j|}|rL|j|}|j||||} | r|j|||| |\}} || fSd} || fSd} || fS)a Checks to see if the provided list of nodes exist for the pool and add the missing nodes to the pool :param alias: The account alias :param location: the datacenter the load balancer resides in :param name: the name of the load balancer :param port: the port that the load balancer will listen on :param nodes: the list of nodes to be added :return: (changed, result) - changed: Boolean whether a change was made result: The result from the CLC API call FrPrW)r#r$r.rL nodes_to_addr^rc)rRr_rXadd_lbpool_nodes rr#r$r"r&r)r3r\r.rLrUs rr>z+ClcLoadBalancer.ensure_lbpool_nodes_presents--4-8 --4-8E33! 4G "&"7"7eAI>C@GEJ #8#L.3Fr cd}|j|}|rL|j|}|j||||} | r|j|||| |\}} || fSd} || fSd} || fS)a Checks to see if the provided list of nodes exist for the pool and removes them if found any :param alias: The account alias :param location: the datacenter the load balancer resides in :param name: the name of the load balancer :param port: the port that the load balancer will listen on :param nodes: the list of nodes to be removed :return: (changed, result) - changed: Boolean whether a change was made result: The result from the CLC API call FrPrW)r#r$r.rLnodes_to_remover^rc)rRr_rXremove_lbpool_nodesrjs rr?z*ClcLoadBalancer.ensure_lbpool_nodes_absent!s--4-8 --4-8E33! 4G "&":":DLAFCJKP #;#R.3Fr c jd} |jjjjdd|d|t j |||d}t d|S#t$rJ}|jjdj|t|jYd}~|Sd}~wwxYw) aQ Create a loadbalancer w/ params :param name: Name of loadbalancer :param alias: Alias of account :param location: Datacenter :param description: Description for loadbalancer to be created :param status: Enabled / Disabled :return: result: The result from the CLC API call NPOST/v2/sharedLoadBalancers//)r"r%r*z)Unable to create load balancer "{0}". {1}r) rv2APICalljsondumpsrrrrformatstr response_text)rr"r#r$r%r*rUes rrTz#ClcLoadBalancer.create_loadbalancerBs 1XX[[__))&MRMU+W*.**dEP@F6H+IJF !H  ! 1 KK ! !?FF#aoo.0 " 1 1  1sAA B2(?B--B2c \d} |jjjjdd|d|d|dt j |||d}|S#t $rJ}|jjdj|t|jYd}~|Sd}~wwxYw) a Creates a pool on the provided load balancer :param alias: the account alias :param location: the datacenter the load balancer resides in :param lb_id: the id string of the load balancer :param method: the load balancing method :param persistence: the load balancing persistence type :param port: the port that the load balancer will listen on :return: result: The result from the create API call Nrorprq/pools)r&r'r(z5Unable to create pool for load balancer id "{0}". {1}r) rrsrtrurvrwrrrrxryrz) rr#r$r.r'r(r&rUr{s rrYz'ClcLoadBalancer.create_loadbalancerpool[s 2XX[[__))%)*.** ${+F ! 2 KK ! !KRR3q/1 " 2 2  2sAA B+!?B&&B+c Nd}|j|} |jjjj dd|d|d|}|S#t $rJ}|j jdj|t|jYd}~|Sd}~wwxYw)z Delete CLC loadbalancer :param alias: Alias for account :param location: Datacenter :param name: Name of the loadbalancer to delete :return: result: The result from the CLC API call NrPDELETErprqz)Unable to delete load balancer "{0}". {1}r) r_rrsrtrurrrrxryrz)rr#r$r"rUr.r{s rr[z#ClcLoadBalancer.delete_loadbalancerus))t)4 1XX[[__))%)*F ! 1 KK ! !?FF#aoo.0 " 1 1  1s9A B$?BB$c 0d} |jjjjdd|d|d|d|}|S#t$rJ}|j j dj|t|jYd}~|Sd}~wwxYw)ab Delete the pool on the provided load balancer :param alias: The account alias :param location: the datacenter the load balancer resides in :param lb_id: the id string of the load balancer :param pool_id: the id string of the load balancer pool :return: result: The result from the delete API call Nrrprq/pools/z5Unable to delete pool for load balancer id "{0}". {1}r rrsrtrurrrrxryrzrr#r$r.rLrUr{s rr`z'ClcLoadBalancer.delete_loadbalancerpools 2XX[[__))%23F ! 2 KK ! !KRR3q/1 " 2 2  2sC C Cc~d}|j||||}|D]!}|jdsd|d<||vrd} d}#|S)a Checks to see if a set of nodes exists on the specified port on the provided load balancer :param alias: the account alias :param location: the datacenter the load balancer resides in :param lb_id: the id string of the provided load balancer :param pool_id: the id string of the load balancer pool :param nodes_to_check: the list of nodes to check for :return: result: True / False indicating if the given nodes exist Fr*enabledT)_get_lbpool_nodesr6) rr#r$r.rLrbrUr)nodes rrdz.ClcLoadBalancer._loadbalancerpool_nodes_existss[&&uhwG" D88H%!*Xu}   r c d}|s|S|jjsT |jjjj dd|d|d|d|d t j|}|S|S#t$rJ}|jjdj|t|jYd}~|Sd}~wwxYw) a Updates nodes to the provided pool :param alias: the account alias :param location: the datacenter the load balancer resides in :param lb_id: the id string of the load balancer :param pool_id: the id string of the pool :param nodes: a list of dictionaries containing the nodes to set :return: result: The result from the CLC API call NPUTrprqr/nodeszr?rTrYr[r`r_r8rRrXrdrerirmr staticmethodrr7rr rr r s C'$OGb&:$(L*!F(TBB24(( " .,0<>(4-8((r r cxttjd}t|}|jy)zb The main function. Instantiates the module and calls process_request. :return: none T)rsupports_check_modeN)r r rrN)rclc_loadbalancers rmainrs3 )M)M)O/35F&v.$$&r __main__)! __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrvr tracebacktimerBansible_collections.community.general.plugins.module_utils.versionrrrr ImportError format_excrrrrransible.module_utils.basicr r r rrrr rrsA@ J XQ f# J [ N  % IJg (g (T' zF[+y++-N&)&&(KIGs"A( B(BBB#"B#