�
�Udac @` s� d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d
Z d d l
Z
d d l Z d d l Z d d l
Z
d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z m Z m Z d d
l m Z e Z d Z y d d l Z e Z Wn e! k
rCe j" � Z n Xd e# f d � � YZ$ d e$ f d � � YZ% d � Z& d � Z' d � Z( d � Z) d � Z* d � Z+ e, d k r�e+ � n d S( i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont stableinterfacet statust coret supported_bys�
---
module: wait_for
short_description: Waits for a condition before continuing
description:
- You can wait for a set amount of time C(timeout), this is the default if nothing is specified or just C(timeout) is specified.
This does not produce an error.
- Waiting for a port to become available is useful for when services are not immediately available after their init scripts return
which is true of certain Java application servers.
- It is also useful when starting guests with the M(virt) module and needing to pause until they are ready.
- This module can also be used to wait for a regex match a string to be present in a file.
- In Ansible 1.6 and later, this module can also be used to wait for a file to be available or
absent on the filesystem.
- In Ansible 1.8 and later, this module can also be used to wait for active connections to be closed before continuing, useful if a node
is being rotated out of a load balancer pool.
- For Windows targets, use the M(win_wait_for) module instead.
version_added: "0.7"
options:
host:
description:
- A resolvable hostname or IP address to wait for.
type: str
default: 127.0.0.1
timeout:
description:
- Maximum number of seconds to wait for, when used with another condition it will force an error.
- When used without other conditions it is equivalent of just sleeping.
type: int
default: 300
connect_timeout:
description:
- Maximum number of seconds to wait for a connection to happen before closing and retrying.
type: int
default: 5
delay:
description:
- Number of seconds to wait before starting to poll.
type: int
default: 0
port:
description:
- Port number to poll.
- C(path) and C(port) are mutually exclusive parameters.
type: int
active_connection_states:
description:
- The list of TCP connection states which are counted as active connections.
type: list
default: [ ESTABLISHED, FIN_WAIT1, FIN_WAIT2, SYN_RECV, SYN_SENT, TIME_WAIT ]
version_added: "2.3"
state:
description:
- Either C(present), C(started), or C(stopped), C(absent), or C(drained).
- When checking a port C(started) will ensure the port is open, C(stopped) will check that it is closed, C(drained) will check for active connections.
- When checking for a file or a search string C(present) or C(started) will ensure that the file or string is present before continuing,
C(absent) will check that file is absent or removed.
type: str
choices: [ absent, drained, present, started, stopped ]
default: started
path:
description:
- Path to a file on the filesystem that must exist before continuing.
- C(path) and C(port) are mutually exclusive parameters.
type: path
version_added: "1.4"
search_regex:
description:
- Can be used to match a string in either a file or a socket connection.
- Defaults to a multiline regex.
type: str
version_added: "1.4"
exclude_hosts:
description:
- List of hosts or IPs to ignore when looking for active TCP connections for C(drained) state.
type: list
version_added: "1.8"
sleep:
description:
- Number of seconds to sleep between checks.
- Before Ansible 2.3 this was hardcoded to 1 second.
type: int
default: 1
version_added: "2.3"
msg:
description:
- This overrides the normal error message from a failure to meet the required conditions.
type: str
version_added: "2.4"
notes:
- The ability to use search_regex with a port connection was added in Ansible 1.7.
- Prior to Ansible 2.4, testing for the absence of a directory or UNIX socket did not work correctly.
- Prior to Ansible 2.4, testing for the presence of a file did not work correctly if the remote user did not have read access to that file.
- Under some circumstances when using mandatory access control, a path may always be treated as being absent even if it exists, but
can't be modified or created by the remote user either.
- When waiting for a path, symbolic links will be followed. Many other modules that manipulate files do not follow symbolic links,
so operations on the path using other modules may not work exactly as expected.
seealso:
- module: wait_for_connection
- module: win_wait_for
- module: win_wait_for_process
author:
- Jeroen Hoekx (@jhoekx)
- John Jarvis (@jarv)
- Andrii Radyk (@AnderEnder)
s�
- name: sleep for 300 seconds and continue with play
wait_for:
timeout: 300
delegate_to: localhost
- name: Wait for port 8000 to become open on the host, don't start checking for 10 seconds
wait_for:
port: 8000
delay: 10
- name: Waits for port 8000 of any IP to close active connections, don't start checking for 10 seconds
wait_for:
host: 0.0.0.0
port: 8000
delay: 10
state: drained
- name: Wait for port 8000 of any IP to close active connections, ignoring connections for specified hosts
wait_for:
host: 0.0.0.0
port: 8000
state: drained
exclude_hosts: 10.2.1.2,10.2.1.3
- name: Wait until the file /tmp/foo is present before continuing
wait_for:
path: /tmp/foo
- name: Wait until the string "completed" is in the file /tmp/foo before continuing
wait_for:
path: /tmp/foo
search_regex: completed
- name: Wait until regex pattern matches in the file /tmp/foo and print the matched group
wait_for:
path: /tmp/foo
search_regex: completed (?P<task>\w+)
register: waitfor
- debug:
msg: Completed {{ waitfor['groupdict']['task'] }}
- name: Wait until the lock file is removed
wait_for:
path: /var/lock/file.lock
state: absent
- name: Wait until the process is finished and pid was destroyed
wait_for:
path: /proc/3466/status
state: absent
- name: Output customized message when failed
wait_for:
path: /tmp/foo
state: present
msg: Timeout to find file /tmp/foo
# Do not assume the inventory_hostname is resolvable and delay 10 seconds at start
- name: Wait 300 seconds for port 22 to become open and contain "OpenSSH"
wait_for:
port: 22
host: '{{ (ansible_ssh_host|default(ansible_host))|default(inventory_hostname) }}'
search_regex: OpenSSH
delay: 10
connection: local
# Same as above but you normally have ansible_connection set in inventory, which overrides 'connection'
- name: Wait 300 seconds for port 22 to become open and contain "OpenSSH"
wait_for:
port: 22
host: '{{ (ansible_ssh_host|default(ansible_host))|default(inventory_hostname) }}'
search_regex: OpenSSH
delay: 10
vars:
ansible_connection: local
st
elapsed:
description: The number of seconds that elapsed while waiting
returned: always
type: int
sample: 23
match_groups:
description: Tuple containing all the subgroups of the match as returned by U(https://docs.python.org/2/library/re.html#re.MatchObject.groups)
returned: always
type: list
sample: ['match 1', 'match 2']
match_groupdict:
description: Dictionary containing all the named subgroups of the match, keyed by the subgroup name,
as returned by U(https://docs.python.org/2/library/re.html#re.MatchObject.groupdict)
returned: always
type: dict
sample:
{
'group': 'match'
}
N( t
AnsibleModulet load_platform_subclasst missing_required_lib( t to_nativet TCPConnectionInfoc B` sl e Z d Z d Z d Z i d e j 6d e j 6Z i d d 6d d 6Z
d � Z d � Z d
� Z
d � Z RS(
s�
This is a generic TCP Connection Info strategy class that relies
on the psutil module, which is not ideal for targets, but necessary
for cross platform support.
A subclass may wish to override some or all of these methods.
- _get_exclude_ips()
- get_active_connections()
All subclasses MUST define platform and distribution (which may be None).
t Generics 0.0.0.0s ::s ::fffft prefixs ::ffff:0.0.0.0t match_allc O` s t t | | � S( N( R R ( t clst argst kwargs( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt __new__ s c C` sp | | _ t | j d � | _ t | j j d � | _ | j � | _ t sl | j d t
d � d t � n d S( Nt hostt portt msgt psutilt exception( t modulet _convert_host_to_ipt paramst ipst intR t _get_exclude_ipst exclude_ipst
HAS_PSUTILt fail_jsonR
t PSUTIL_IMP_ERR( t selfR ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt __init__ s c C` sM | j j d } g } | d k rI x$ | D] } | j t | � � q) Wn | S( Nt
exclude_hosts( R R t Nonet extendR ( R# R% R R ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR s
c C` s� d } x�t j � D]�} y: t | d � r@ | j d d � } n | j d d � } Wn t j k
rl q n Xx?| D]7} | j | j j d k r� qt n t | d � r� | j \ } } n | j
\ } } | j | k r� qt n t | d � r� | j \ } } n | j
\ } } | j | f | j k r,qt n t | j | f | j k | j | j | j f | j k | j | j d � o�| j | j d f | j k f � rt | d
7} qt qt Wq W| S( Ni t get_connectionst kindt inett active_connection_statest
local_addresst remote_addressR R i ( R t process_itert hasattrR( t connectionst ErrorR R R R, t laddrR R- t raddrt familyR t anyR t
match_all_ipst
startswitht ipv4_mapped_ipv6_address( R# t active_connectionst pR0 t connt local_ipt
local_portt remote_ipt remote_port( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt get_active_connections_count! s8
%N( t __name__t
__module__t __doc__t platformR& t distributiont sockett AF_INETt AF_INET6R6 R8 R R$ R R@ ( ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR � s
t LinuxTCPConnectionInfoc B` s� e Z d Z d Z d Z i d e j 6d e j 6Z i d e j 6d e j 6Z
i d d 6d d 6Z d
Z d Z
d Z d
� Z d � Z d � Z RS( s�
This is a TCP Connection Info evaluation strategy class
that utilizes information from Linux's procfs. While less universal,
does allow Linux targets to not require an additional library.
t Linuxs
/proc/net/tcps /proc/net/tcp6t 00000000t 00000000000000000000000000000000t 0000000000000000FFFF0000R t 0000000000000000FFFF000000000000R i i i c C` sL | | _ t | j d � | _ d t | j d � | _ | j � | _ d S( NR s %0.4XR ( R t _convert_host_to_hexR R R R R R ( R# R ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR$ a s c C` sM | j j d } g } | d k rI x$ | D] } | j t | � � q) Wn | S( NR% ( R R R& R' RO ( R# R% R R ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR g s
c
C` s� d } x�| j j � D]�} t j j | j | � s; q n t | j | � } xV| j � D]H} | j � j � } | | j d k r� q[ n | | j
g | j j d D] } t
| � ^ q� k r� q[ n | | j j d � \ } } | j | k r� q[ n | | j j d � \ } } | | f | j k r0q[ n t | | f | j k | | j | f | j k | j | j d � o�| | j d f | j k f � r[ | d 7} q[ q[ W| j � q W| S( Ni R, R+ t :R R i ( t source_filet keyst ost patht isfilet opent readlinest stript splitt local_address_fieldt connection_state_fieldR R t get_connection_state_idR t remote_address_fieldR R5 R R6 R7 R8 t close(
R# R9 R4 t ft tcp_connectiont _connection_stateR< R= R> R? ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR@ o s4
, "N( RA RB RC RD R& RE RF RG RH RQ R6 R8 RZ R] R[ R$ R R@ ( ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyRI H s$
c C` s� t j | d d d t j � } g } xf | D]^ \ } } } } } | d } | j | | f � | t j k r+ | j t j d | f � q+ q+ W| S( s�
Perform forward DNS resolution on host, IP will give the same IP
Args:
host: String with either hostname, IPv4, or IPv6 address
Returns:
List of tuples containing address family and IP
iP i s ::ffff:( RF t getaddrinfot SOL_TCPt appendRG RH ( R t addrinfoR R4 t socktypet protot canonnamet sockaddrt ip( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR � s
!c C` s� g } | d k r� x� t | � D]� \ } } t j t j | | � � } d } x\ t d t | � d � D]B } | | | d !} t j t | d d �� } d | | f } qe W| j
| | f � q Wn | S( ss
Convert the provided host to the format in /proc/net/tcp*
/proc/net/tcp uses little-endian four byte hex for ipv4
/proc/net/tcp6 uses little-endian per 4B word for ipv6
Args:
host: String with either hostname, IPv4, or IPv6 address
Returns:
List of tuples containing address family and the
little-endian converted host
t i i t basei s %s%08XN( R& R t binasciit b2a_hexRF t inet_ptont ranget lent ntohlR Rd ( R R R4 Rj t hexip_nft hexip_hft it
ipgroup_nft
ipgroup_hf( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyRO � s c C` sy t j d k r] t | � d \ } } t j | t j � } | j | � | j | | f � n t j | | f | � } | S( s�
Connect to a 2-tuple (host, port) and return
the socket object.
Args:
2-tuple (host, port) and connection timeout
Returns:
Socket object
i i i ( i i ( t syst version_infoR RF t SOCK_STREAMt
settimeoutt connectt create_connection( R R t connect_timeoutR4 t _t connect_socket( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt _create_connection� s
c C` s) | j d | j | j d d d d S( Ng i i i
i i@B i@B ( t microsecondst secondst days( t timedelta( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt _timedelta_total_seconds� s
c C` s8 i d d 6d d 6d d 6d d 6d d
6d d 6} | | S(
Nt 01t ESTABLISHEDt 02t SYN_SENTt 03t SYN_RECVt 04t FIN_WAIT1t 05t FIN_WAIT2t 06t TIME_WAIT( ( t statet connection_state_id( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyR\ � s
c C` s� t d t d t d d d d � d t d d d d � d
t d d d d � d t d d d d
� d t d d � d t d d d d d d d d d g � d t d d � d t d d � d t d d d d d d d d d d g � d t d d � d! t d d d d" � d# t d d � � � } | j d } | j d } | j d
} | j d } | j d } | j d } | j d } | j d } | j d# } | d k r�t j | t j � }
n d }
i } d: } | r�| r�| j d# d$ d% d
� n | r| d k r| j d# d& d% d
� n | r=| d k r=| j d# d' d% d
� n | j d d k ru| d k ru| j d# d( d% d
� n xQ | j d D]B }
y t |
� Wq�t k
r�| j d# d) |
d% d
� q�Xq�Wt
j
j � } | r�t j
| � n | r| r| d k rt j
| � n5| d; k rg| t
j d* | � } xt
j
j � | k r�| r�y t j | t j � stPn Wq�t k
r�Pq�XnN | r�y0 t | | | � } | j t j � | j � Wq�t k
r�Pq�Xn t j
| j d! � q=Wt
j
j � | } | r8| j d# | p(d+ | | f d% | j � qM | rM | j d# | pTd, | d% | j � qM n�| d< k r�| t
j d* | � } x�t
j
j � | k r�| r�y t j | � Wnd t k
r } | j d- k r�t
j
j � | } | j d# | p d. | | j f d% | j � q�q�X|
s)Pn yz t | � } z\ t j |
| j � � } | r�| j � rt| j � } n | j! � r�| j! � } n Pn Wd | j � XWq�t k
r�q�Xn�| r�t" j# t$ | t
j
j � � � } y t | | t% | | � � } Wn t k
rq�X|
r<d/ } t& } x� t
j
j � | k r�t" j# t$ | t
j
j � � � } t' j' | g g g | � \ } } } | s�q*n | j( d0 � } | s�Pn | t) | d1 d2 �7} t j |
| � r*t* } Pq*q*Wy | j t j � Wn. t j+ k
r$} | j t j, k r/� q/n X| j � | r�Pq�q�y | j t j � Wn. t j+ k
r�} | j t j, k r�� q�n X| j � Pn t j
| j d! � q�Wt
j
j � | } | r!| r�| j d# | p�d3 | | | f d% | j � q| j d# | pd4 | | f d% | j � qM | rM | rY| j d# | pId5 | | f d% | j � q| j d# | pod6 | d% | j � qM n� | d k rM | t
j d* | � } t- | � } x� t
j
j � | k r
y | j. � d
k r�Pn Wn t k
r�n Xt j
| j d! � q�Wt
j
j � | } | j d# | p= d7 | | f d% | j � n t
j
j � | } | j/ d | d | d | d8 | d9 | d | d% | j � d S(= Nt
argument_specR t typet strt defaults 127.0.0.1t timeoutR i, R~ i t delayi R R+ t listR� R� R� R� R� R� RT t search_regexR� t startedt choicest absentt drainedt presentt stoppedR% t sleepi R s: port and path parameter can not both be passed to wait_fort elapsedsL state=stopped should only be used for checking a port in the wait_for modulesL state=drained should only be used for checking a port in the wait_for modules/ exclude_hosts should only be with state=draineds, unknown active_connection_state (%s) definedR� s' Timeout when waiting for %s:%s to stop.s) Timeout when waiting for %s to be absent.i s Failed to stat %s, %sRk i t errorst surrogate_or_stricts2 Timeout when waiting for search string %s in %s:%ss Timeout when waiting for %s:%ss/ Timeout when waiting for search string %s in %ss Timeout when waiting for file %ss' Timeout when waiting for %s:%s to draint match_groupst match_groupdict( ( R� R� ( R� R� (0 R t dictR R& t ret compilet MULTILINER! R\ t Exceptiont datetimet utcnowt timeR� R� RS t accesst F_OKt IOErrorR� t shutdownRF t SHUT_RDWRR^ R� t statt OSErrort errnot strerrorRV t searcht readt groupdictt groupst matht ceilR� t mint Falset selectt recvR t Truet errort ENOTCONNR R@ t exit_json( R R R� R~ R� R R� RT R� R t compiled_search_reR� R� Ra t startt endt sR� t eR_ R� t alt_connect_timeoutt datat matchedt max_timeoutt readablet wt responset tcpconns( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt main� s4 '*
"
,) 3
"
"$
/,,)
,-t __main__(- t
__future__R R R R� t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNRm R� R� R� RS R� R� RF Rx R� t tracebackt ansible.module_utils.basicR R R
t ansible.module_utils._textR R� R R& R" R R� t ImportErrort
format_exct objectR RI R RO R� R� R\ R� RA ( ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/utilities/logic/wait_for.pyt <module> sJ
jN
RE �
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell