Vh8dZdZdZ ddlZddlmZddlmZddl m Z Gdd Z d Z ed k(re yy#e$rY4wxYw) a  --- module: elb_instance version_added: 1.0.0 short_description: De-registers or registers instances from EC2 ELBs description: - This module de-registers or registers an AWS EC2 instance from the ELBs that it belongs to. - Will be marked changed when called only if there are ELBs found to operate on. author: - "John Jarvis (@jarv)" options: state: description: - Register or deregister the instance. required: true choices: ['present', 'absent'] type: str instance_id: description: - EC2 Instance ID. required: true type: str ec2_elbs: description: - List of ELB names - Required when I(state=present). type: list elements: str enable_availability_zone: description: - Whether to enable the availability zone of the instance on the target ELB if the availability zone has not already been enabled. - If I(enable_availability_zone=no), the task will fail if the availability zone is not enabled on the ELB. type: bool default: true wait: description: - Wait for instance registration or deregistration to complete successfully before returning. type: bool default: true wait_timeout: description: - Number of seconds to wait for an instance to change state. - If I(wait_timeout=0) then this module may return an error if a transient error occurs. - If non-zero then any transient errors are ignored until the timeout is reached. - Ignored when I(wait=no). default: 0 type: int notes: - The ec2_elbs fact previously set by this module was deprecated in release 2.1.0 and since release 4.0.0 is no longer set. extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.boto3 a # basic pre_task and post_task example pre_tasks: - name: Instance De-register community.aws.elb_instance: instance_id: "{{ ansible_ec2_instance_id }}" state: absent register: deregister_instances delegate_to: localhost roles: - myrole post_tasks: - name: Instance Register community.aws.elb_instance: instance_id: "{{ ansible_ec2_instance_id }}" ec2_elbs: "{{ deregister_instances.updated_elbs }}" state: present delegate_to: localhost z updated_elbs: description: A list of ELB names that the instance has been added to or removed from. returned: always type: list elements: str N)is_boto3_error_code)AWSRetry)AnsibleCommunityAWSModulec~eZdZdZddZdZdZejdZ dZ dZ d Z d Z dd Zd Zd Zy) ElbManagerz9Handles EC2 instance ELB registration and de-registrationNc0tj}||_|jd||_|jd||_|jd||_||_|j||_ d|_ t|_ y)N autoscaling)retry_decoratorec2elbF) rjittered_backoffmoduleclient client_asg client_ec2 client_elb instance_id_get_instance_lbslbschangedset updated_elbs)selfrrec2_elbsr s n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/aws/plugins/modules/elb_instance.py__init__zElbManager.__init__ks~"335  -- -W ---O ---O&))(3 Ec|jD]}|dDcgc]}|d }}|j|vr'|jj|d|jj rd|_c |jjd|dd|jigd|_|r%|jD]}|j|d |yycc}w#tjjtjjf$r3}|jj|d||jYd}~d}~wwxYw) z_De-register the instance from all ELBs and wait for the ELB to report it out-of-service Instances InstanceIdLoadBalancerNameT aws_retryr!rz0Failed to deregister instance from load balancer load_balancerinstanceN Deregistered)rrraddr check_moderr'deregister_instances_from_load_balancerbotocore exceptions ClientError BotoCoreError fail_json_aws_await_elb_instance_state)rwaittimeoutlbi instance_idses r deregisterzElbManager.deregistervsK(( B57 _EAlOELE|3    ! !"%7"8 9{{%%#  GG"%'(:%; ,d.>.>?@H DL3 6 hh L..r>7K L 5F ''33X5H5H5V5VW  ))IY[fjfvfv* s C1.C7D? )D::D?c|jD]}|dDcgc]}|d }}|j|vr'|jj|d|r$|xj|j |zc_|j jrd|_ |jjd|dd|jigd|_|r%|jD]}|j|d |yycc}w#tjjtjjf$r3}|j j|d||jYd}~d}~wwxYw) zaRegister the instance for all ELBs and wait for the ELB to report the instance in-servicerr r!Tr"z.Failed to register instance with load balancerr$N InService)rrrr(r_enable_availailability_zonerr)r%register_instances_with_load_balancerr+r,r-r.r/r0)rr1enable_availability_zoner2r3r4r5r6s rregisterzElbManager.registersg(( B57 _EAlOELE</    ! !"%7"8 9'  A A" EE {{%%#  EE"%'(:%; ,d.>.>?@F DL3 6 hh I..r;H I 5F&''33X5H5H5V5VW  ))GWYdhdtdt* s C6.C;;7E%2)E  E%c |jjd}|jdi|j}|dS)Ndescribe_load_balancersLoadBalancerDescriptions)r get_paginatorpaginatebuild_full_result)rparams paginatorresultss r_describe_elbszElbManager._describe_elbssAOO112KL $)$$.v.@@B122rcFd}|jD]}|d|k(s d}|S|S)z)Verify that the named ELB actually existsFr!T)r)rlbtestfoundr3s rexistszElbManager.existss>(( B$%/   rc~|j}|dd}||dvry|jjry |jj d|d|gy#t j jt j jf$r)}|jj|d|| Yd }~yd }~wwxYw) zEnable the current instance's availability zone in the provided lb. Returns True if the zone was enabled or False if no change was made. lb: load balancer PlacementAvailabilityZoneAvailabilityZonesFTr!)r#r!rPz%Failed to enable AZ on load balancers)r%zoneN) _get_instancerr)r+enable_availability_zones_for_load_balancerr+r,r-r.r/)rr3r& desired_zoner6s rr:z'ElbManager._enable_availailability_zones%%' ,-?@ 212 2 ;; ! ! w OO G G!#$6!7#/. H ##//1D1D1R1RS w KK % %a)P`biu % v v ws"A7B<B77B<c|jjry|j|}||k(ry|dk(r|jj d}n_|dk(r|jj d}n>|dk(r|jj d}n|jj d| j |d d |jigd |d  y#tjj$r(}|jj|d|Yd}~yd}~wtjjtjjf$r(}|jj|d|Yd}~yd}~wwxYw)zWait for an ELB to change stateNr9instance_in_servicer'instance_deregistered OutOfServicez Could not wait for unknown state)msg awaited_stater!r )Delay MaxAttempts)r!r WaiterConfigz3Timeout waiting for instance to reach desired statez7Error while waiting for instance to reach desired state)rr)_get_instance_healthr get_waiter fail_jsonr1rr+r, WaiterErrorr/r-r.)rr3rZr2 initial_statewaiterr6s rr0z$ElbManager._await_elb_instance_statest ;; ! ! 11"5 M )  K '__//0EFF n ,__//0GHF n ,__//0GHF KK ! !&HXe ! f  KK!#$6!7($*:*:;<'(A   ""..  KK % %L\i &    ##//1D1D1R1RS  KK % %P`m &     s$0'CE:5D:E:E55E:c\ |jjd|dd|jigd}sy|d d S#td$rYytj j tj jf$r'}|jj|d Yd}~sd}~wwxYw) zt Check instance health, should return status object or None under certain error conditions. Tr!r r"InstanceStatesInvalidInstanceNzFailed to get instance healthrYrState) rdescribe_instance_healthrrr+r,r-r.rr/)rr3statusr6s rr_zElbManager._get_instance_healths N__==!#$6!7($*:*:;<>  Fay!!##45     + +    - -  N KK % %a-L % M M  Ns1>B+6B+B&&B+ct}|s|j}|r||d< |jdi|}|rSg}D]7}|dDcgc]}|d }}|j|vs'|j|9|S#tjj tjj f$r&}|jj|dYd}~d}~wwxYwcc}w)zReturns a list of ELBs attached to self.instance_id ec2_elbs: an optional list of elb names that will be used for elb lookup instead of returning what elbs are attached to self.instance_idLoadBalancerNamesz!Failed to describe load balancersNrr rA) dict_get_auto_scaling_group_lbsrHr+r,r-r.rr/rappend) rr list_paramselbsr6rr3r4r5s rrzElbManager._get_instance_lbss f 779H /7K+ , N&4&&55D K B57 _EAlOELE</ 2   ##//1D1D1R1RS N KK % %a)L M M NFsA; C;7C2CCc |jjd|jgd}tdkDr|jjd|sgS|d d } |jjd|g d }t|dk7r|jjd |d dS#tjj tjj f$r'}|jj|dYd}~d}~wwxYw#tjj tjj f$r'}|jj|dYd}~d}~wwxYw)ztReturns a list of ELBs associated with self.instance_id indirectly through its auto scaling group membershipTr# InstanceIdsAutoScalingInstancesFailed to describe ASG InstancerhNr[z8Illegal state, expected one auto scaling group instance.rAutoScalingGroupName)r#AutoScalingGroupNamesAutoScalingGroupsz/Illegal state, expected one auto scaling group.rm) rdescribe_auto_scaling_instancesrr+r,r-r.rr/lenradescribe_auto_scaling_groups)r asg_instancesr6asg_names rroz&ElbManager._get_auto_scaling_group_lbs>sq P OOKKT-=-=,>L$&M }  ! KK ! !&` ! aI #$:; P OOHHxjI!#M }  " KK ! !&W ! XQ 344-##//1D1D1R1RS P KK % %a-N % O O P ##//1D1D1R1RS P KK % %a-N % O O Ps/+B7$!D77D.DD7E6E11E6c2 |jjd|jg}ddddS#tjj tjj f$r'}|jj|dYd}~gd}~wwxYw) z&Returns the description of an instanceTrtrwrhN Reservationsrr) rdescribe_instancesrr+r,r-r.rr/)rresultr6s rrRzElbManager._get_instance^s P__77$UYUeUeTf7gFn%a(5a88##//1D1D1R1RS P KK % %a-N % O O Ps(87B/BB)NN)N)__name__ __module__ __qualname____doc__rr7r=rr rHrLr:r0r_rrorRrArrrrhs\C "!LF IDX 3!3 0"H"0>5@9rrc tdddgdddiddddd ddd d ddd d dd dd }dddgfg}t||d}|jd}|jd}|jd}|jd}|jd}t|||}|/|D]*} |j | r|j d| d,|jddk(r|j |||n$|jddk(r|j|||j|jt|jy)NTpresentabsent)requiredchoicesrFliststr)defaultrtypeelementsbool)rrr)rrrrint)staterrr<r1 wait_timeoutrr) argument_spec required_ifsupports_check_moder1r<rrzELB z does not existrh)rr) rnAnsibleAWSModulerErrLrar=r7 exit_jsonrrr) rrrrr1r<r2relb_manr s rmainrgszY,AB&!ufRWX-1uf!UD& A"'AuE M )j\*K# F }}Z(H == D%}}-GHmmN+G-- .Kh7G BC>>#&  tC5%@ A B}}W*7A w 8 +4) '../r__main__) DOCUMENTATIONEXAMPLESRETURNr+ ImportErroransible_collections.community.aws.plugins.module_utils.modulesrrrrrrArrrsk8 t (  ]Px|9|9~(V zFg   s9AA