�
�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 m Z d d
l m Z d d l m Z d d l m Z m Z d � Z d d d 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_bys9
---
module: get_url
short_description: Downloads files from HTTP, HTTPS, or FTP to node
description:
- Downloads files from HTTP, HTTPS, or FTP to the remote server. The remote
server I(must) have direct access to the remote resource.
- By default, if an environment variable C(<protocol>_proxy) is set on
the target host, requests will be sent through that proxy. This
behaviour can be overridden by setting a variable for this task
(see `setting the environment
<https://docs.ansible.com/playbooks_environment.html>`_),
or by using the use_proxy option.
- HTTP redirects can redirect from HTTP to HTTPS so you should be sure that
your proxy environment for both protocols is correct.
- From Ansible 2.4 when run with C(--check), it will do a HEAD request to validate the URL but
will not download the entire file or verify it against hashes.
- For Windows targets, use the M(win_get_url) module instead.
version_added: '0.6'
options:
url:
description:
- HTTP, HTTPS, or FTP URL in the form (http|https|ftp)://[user[:pass]]@host.domain[:port]/path
type: str
required: true
dest:
description:
- Absolute path of where to download the file to.
- If C(dest) is a directory, either the server provided filename or, if
none provided, the base name of the URL on the remote server will be
used. If a directory, C(force) has no effect.
- If C(dest) is a directory, the file will always be downloaded
(regardless of the C(force) option), but replaced only if the contents changed..
type: path
required: true
tmp_dest:
description:
- Absolute path of where temporary file is downloaded to.
- When run on Ansible 2.5 or greater, path defaults to ansible's remote_tmp setting
- When run on Ansible prior to 2.5, it defaults to C(TMPDIR), C(TEMP) or C(TMP) env variables or a platform specific value.
- U(https://docs.python.org/2/library/tempfile.html#tempfile.tempdir)
type: path
version_added: '2.1'
force:
description:
- If C(yes) and C(dest) is not a directory, will download the file every
time and replace the file if the contents change. If C(no), the file
will only be downloaded if the destination does not exist. Generally
should be C(yes) only for small local files.
- Prior to 0.6, this module behaved as if C(yes) was the default.
- Alias C(thirsty) has been deprecated and will be removed in 2.13.
type: bool
default: no
aliases: [ thirsty ]
version_added: '0.7'
backup:
description:
- Create a backup file including the timestamp information so you can get
the original file back if you somehow clobbered it incorrectly.
type: bool
default: no
version_added: '2.1'
sha256sum:
description:
- If a SHA-256 checksum is passed to this parameter, the digest of the
destination file will be calculated after it is downloaded to ensure
its integrity and verify that the transfer completed successfully.
This option is deprecated. Use C(checksum) instead.
default: ''
version_added: "1.3"
checksum:
description:
- 'If a checksum is passed to this parameter, the digest of the
destination file will be calculated after it is downloaded to ensure
its integrity and verify that the transfer completed successfully.
Format: <algorithm>:<checksum|url>, e.g. checksum="sha256:D98291AC[...]B6DC7B97",
checksum="sha256:http://example.com/path/sha256sum.txt"'
- If you worry about portability, only the sha1 algorithm is available
on all platforms and python versions.
- The third party hashlib library can be installed for access to additional algorithms.
- Additionally, if a checksum is passed to this parameter, and the file exist under
the C(dest) location, the I(destination_checksum) would be calculated, and if
checksum equals I(destination_checksum), the file download would be skipped
(unless C(force) is true). If the checksum does not equal I(destination_checksum),
the destination file is deleted.
type: str
default: ''
version_added: "2.0"
use_proxy:
description:
- if C(no), it will not use a proxy, even if one is defined in
an environment variable on the target hosts.
type: bool
default: yes
validate_certs:
description:
- If C(no), SSL certificates will not be validated.
- This should only be used on personally controlled sites using self-signed certificates.
type: bool
default: yes
timeout:
description:
- Timeout in seconds for URL request.
type: int
default: 10
version_added: '1.8'
headers:
description:
- Add custom HTTP headers to a request in hash/dict format.
- The hash/dict format was added in Ansible 2.6.
- Previous versions used a C("key:value,key:value") string format.
- The C("key:value,key:value") string format is deprecated and will be removed in version 2.10.
type: raw
version_added: '2.0'
url_username:
description:
- The username for use in HTTP basic authentication.
- This parameter can be used without C(url_password) for sites that allow empty passwords.
- Since version 2.8 you can also use the C(username) alias for this option.
type: str
aliases: ['username']
version_added: '1.6'
url_password:
description:
- The password for use in HTTP basic authentication.
- If the C(url_username) parameter is not specified, the C(url_password) parameter will not be used.
- Since version 2.8 you can also use the 'password' alias for this option.
type: str
aliases: ['password']
version_added: '1.6'
force_basic_auth:
description:
- Force the sending of the Basic authentication header upon initial request.
- httplib2, the library used by the uri module only sends authentication information when a webservice
responds to an initial request with a 401 status. Since some basic auth services do not properly
send a 401, logins will fail.
type: bool
default: no
version_added: '2.0'
client_cert:
description:
- PEM formatted certificate chain file to be used for SSL client authentication.
- This file can also include the key as well, and if the key is included, C(client_key) is not required.
type: path
version_added: '2.4'
client_key:
description:
- PEM formatted file that contains your private key to be used for SSL client authentication.
- If C(client_cert) contains both the certificate and key, this option is not required.
type: path
version_added: '2.4'
http_agent:
description:
- Header to identify as, generally appears in web server logs.
type: str
default: ansible-httpget
# informational: requirements for nodes
extends_documentation_fragment:
- files
notes:
- For Windows targets, use the M(win_get_url) module instead.
seealso:
- module: uri
- module: win_get_url
author:
- Jan-Piet Mens (@jpmens)
s~
- name: Download foo.conf
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
mode: '0440'
- name: Download file and force basic auth
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
force_basic_auth: yes
- name: Download file with custom HTTP headers
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
headers:
key1: one
key2: two
- name: Download file with check (sha256)
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
checksum: sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c
- name: Download file with check (md5)
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
checksum: md5:66dffb5228a211e61d6d7ef4a86f5758
- name: Download file with checksum url (sha256)
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
checksum: sha256:http://example.com/path/sha256sum.txt
- name: Download file from a file path
get_url:
url: file:///tmp/afile.txt
dest: /tmp/afilecopy.txt
- name: < Fetch file that requires authentication.
username/password only available since 2.8, in older versions you need to use url_username/url_password
get_url:
url: http://example.com/path/file.conf
dest: /etc/foo.conf
username: bar
password: '{{ mysecret }}'
s�
backup_file:
description: name of backup file created after download
returned: changed and if backup=yes
type: str
sample: /path/to/file.txt.2015-02-12@22:09~
checksum_dest:
description: sha1 checksum of the file after copy
returned: success
type: str
sample: 6e642bb8dd5c2e027bf21dd923337cbb4214f827
checksum_src:
description: sha1 checksum of the file
returned: success
type: str
sample: 6e642bb8dd5c2e027bf21dd923337cbb4214f827
dest:
description: destination file/path
returned: success
type: str
sample: /path/to/file.txt
elapsed:
description: The number of seconds that elapsed while performing the download
returned: always
type: int
sample: 23
gid:
description: group id of the file
returned: success
type: int
sample: 100
group:
description: group of the file
returned: success
type: str
sample: "httpd"
md5sum:
description: md5 checksum of the file after download
returned: when supported
type: str
sample: "2a5aeecc61dc98c4d780b14b330e3282"
mode:
description: permissions of the target
returned: success
type: str
sample: "0644"
msg:
description: the HTTP message from the request
returned: always
type: str
sample: OK (unknown bytes)
owner:
description: owner of the file
returned: success
type: str
sample: httpd
secontext:
description: the SELinux security context of the file
returned: success
type: str
sample: unconfined_u:object_r:user_tmp_t:s0
size:
description: size of the target
returned: success
type: int
sample: 1220
src:
description: source file used after download
returned: always
type: str
sample: /tmp/tmpAdFLdV
state:
description: state of the target
returned: success
type: str
sample: file
status_code:
description: the HTTP status code from the request
returned: always
type: int
sample: 200
uid:
description: owner id of the file, after execution
returned: success
type: int
sample: 100
url:
description: the actual URL used for the request
returned: always
type: str
sample: https://www.ansible.com/
N( t
AnsibleModule( t urlsplit( t to_native( t fetch_urlt url_argument_specc C` s0 t j j t | � d � } | d k r, d S| S( Ni t s
index.html( t ost patht basenameR ( t urlt fn( ( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pyt url_filenameX s i
R
c C` s� | j r d } n d } t j j � }
t | | d | d | d | d | d | d | �\ } } t j j � |
j }
| d d
k r� | j d | d | d
t d | j d d � d |
� n | d d k r� | j d | d d | d | d |
� n | d d k rz| j d � rz| j d � o=| j d d � j d � rz| j d d d | d d | d d | d | d |
� n | r�t
j j | � } | s�t
j j
| � r�| j d d | d |
� q�| j d d | d |
� q�n | j } t j d | � \ } } t
j | d � } y t j | | � WnL t k
r|} t
j | � | j d d t | � d |
d t j � � n X| j � | j � | | f S( sr
Download data from the url and store in a temporary file.
Return (tempfile, info about the request)
t HEADt GETt use_proxyt forcet
last_mod_timet timeoutt headerst methodR i0 R t destt changedt msgR
t elapsedi����i� s file:/s ftp:/t OKs Request failedt status_codet responses' %s is a file but should be a directory.s %s directory does not exist.t dirt wbs+ failed to create temporary content file: %st exception( t
check_modet datetimet utcnowR t secondst exit_jsont Falset gett fail_jsont
startswithR R t isdirt existst tmpdirt tempfilet mkstempt fdopent shutilt copyfileobjt Exceptiont removeR
t tracebackt
format_exct close( t moduleR R R R R R R t tmp_destR t startt rspt infoR t tmp_dest_is_dirt fdt tempnamet ft e( ( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pyt url_get_ s: 97)K9
0
c C` se d } d } d | k ra | d } t j | | � } | ra | j d � } t j j | � } qa n | S( s�
Extracts a filename from the given dict of HTTP headers.
Looks for the content-disposition header and applies a regex.
Returns the filename if successful, else None.s attachment; ?filename="?([^"]+)s content-dispositioni N( t Nonet ret matcht groupR R R ( R t cont_disp_regext rest cont_dispRI ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pyt extract_filename_from_headers� s
c " ` s�
t � } d g | d d <d g | d d <| j d t d d d t � d
t d d d t � d t 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 � � t d | d t d t d d d g g � } | j j d � r | j d d d �n | j d } | j d
} | j d } | j d } | j d } | j d } | j d! } | j d } | j d }
t d" t d# d d$ d d
| d% d& d | � } t
| j d t � r�| j d } nz | j d rYy= t d' � | j d j d( � D� � } | j d) d d* �Wq_t k
rU| j
d+ d, | � q_Xn d } t j j | � }
d } | r�d- | } n | r�y | j d. d/ � \ } } Wn$ t k
r�| j
d+ d0 | � n X| j d1 � s | j d2 � s | j d3 � r0| } t | | | | | | | | |
� \ } } t | � �) } g | D] } | j d4 � ^ qF} Wd QXt j | � i } xG | D]? } | j d d/ � } t | � d5 k r�| d/ | | d& <q�q�Wt | � � x1 � f d6 � | j � D� D]
} | } Pq�Wd } | d k r0| j
d+ d7 � | f � q0n t j d8 d | � j � } y t | d9 � Wq�t k
r�| j
d+ d: | � q�Xn |
r�t j j | � r�t } | r�| d k r�| j | | � } | | k r�t } q�n | rk| rk| rk| | j d <| j | j � } | | d <| j! | t � | d" <| d" rU| j" d+ d; | � n | j" d+ d< | � n t j j# | � } t$ j$ j% | � } | r�t } q�n t$ j$ j& � } t | | | | | | | | |
� \ } } t$ j$ j& � | j' | d% <| | d= <|
rKt( | � � � s)t | d � � n t j j) | � � } | | d
<n t j j | � s�t j | � | j
d+ d> d? | d@ dA | d+ | � n t j* | t j+ � s�t j | � | j
d+ dB | | � n | j, | � | d$ <t j j | � r�t j* | t j- � s1t j | � | j
d+ dC | | � n t j* | t j+ � smt j | � | j
d+ dD | | � n | j, | � | d# <n� t j j t j j. | � � s�t j | � | j
d+ dE t j j. | � | � n t j* t j j. | � t j- � s(t j | � | j
d+ dC t j j. | � | � n | j/ r�t j j | � rSt j | � n d# | k pp| d$ | d# k | d" <| j" d+ | j d+ d � | � n d } | d$ | d# k rx yN | r�t j j | � r�| j0 | � } q�n | j1 | | dF | j dF �Wng t k
rj }! t j j | � r5 t j | � n | j
d+ dG | | t2 |! � f dH t3 j4 � | � n Xt | d" <n, t | d" <t j j | � r� t j | � n | d k r
| j | | � } | | k r
t j | � | j
d+ dI | | | f | � q
n | | j d <| j | j � } | | d <| j! | | d" � | d" <y | j5 | � | dJ <Wn t k
rx
d | dJ <n X| r�
| | dK <n | j" d+ | j d+ d � d? | j d@ d � | � d S(L Nt usernamet url_usernamet aliasest passwordt url_passwordR t typet strt requiredR R t backupt boolt sha256sumt defaultR
t checksumR t inti
R t rawR= t
argument_spect add_file_common_argst supports_check_modet mutually_exclusivet thirstysP The alias "thirsty" has been deprecated and will be removed, use "force" insteadt versions 2.13R R R t
checksum_destt checksum_srcR i c s` s! | ] } | j d d � Vq d S( t :i N( t split( t .0t item( ( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pys <genexpr>� s t ,sX Supplying `headers` as a string is deprecated. Please use dict/hash format for `headers`s 2.10R sr The string representation for the `headers` parameter requires a key:value,key:value syntax to be properly parsed.s sha256:%sRf i sA The checksum parameter has to be in format <algorithm>:<checksum>s http://s https://s ftp://s
i c 3` s0 | ]& \ } } | j d � � k r | Vq d S( s ./N( t strip( Rh t sRD ( t filename( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pys <genexpr> s s/ Unable to find a checksum for file '%s' in '%s's \W+i s The checksum format is invalids/ file already exists but file attributes changeds file already existst srcs Request failedR! R R" s Source %s is not readables Destination %s is not writables Destination %s is not readables Destination %s does not existt
unsafe_writess failed to copy %s to %s: %sR% s0 The checksum for %s did not match %s; it was %s.t md5sumt backup_file(6 R t updatet dictt TrueR t paramsR, t deprecateR+ RG t
isinstanceRg R7 R- R R R/ t
ValueErrorR. RF t opent rstripR8 t lenR t itemsRH t subt lowerR\ R0 t digest_from_filet load_file_common_argumentst set_fs_attributes_if_differentR* t getmtimeR' t utcfromtimestampR( R) RN t joint accesst R_OKt sha1t W_OKt dirnameR& t backup_localt atomic_moveR
R9 R: t md5(" R^ R< R R RW R RY R[ R R R= t resultR t dest_is_dirR t algorithmt checksum_urlt checksum_tmpsrct
checksum_infoRD t linet linest checksum_mapt partst cksumt checksum_mismatcht destination_checksumt file_argst mtimeR> t tmpsrcR@ Rq RE ( ( Rm sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pyt main� sF
&
-*(
#
*
*
&!
& "!"
&
t __main__( t
__future__R R R RT t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR' R RH R5 R2 R9 t ansible.module_utils.basicR t+ ansible.module_utils.six.moves.urllib.parseR t ansible.module_utils._textR
t ansible.module_utils.urlsR R R RG RF RN R� t __name__( ( ( sL /usr/lib/python2.7/site-packages/ansible/modules/net_tools/basics/get_url.pyt <module> s.
�5] 2 �
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell