관리-도구
편집 파일: copy.cpython-39.opt-1.pyc
a �)g� � @ s$ d dl mZmZmZ eZdZdZdZd dl Z d dl Z d dl Z d dl Z d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZmZ d dlmZ d dlmZ d d lm Z d d l m Z da G d d � d e �Z!d d� Z"dd� Z#dd� Z$dd� Z%dd� Z&dd� Z'dd� Z(dd � Z)e*d k�r e)� dS ) � )�absolute_import�division�print_functionaj --- module: copy version_added: historical short_description: Copy files to remote locations description: - The C(copy) module copies a file from the local or remote machine to a location on the remote machine. - Use the M(ansible.builtin.fetch) module to copy files from remote locations to the local box. - If you need variable interpolation in copied files, use the M(ansible.builtin.template) module. Using a variable in the C(content) field will result in unpredictable output. - For Windows targets, use the M(ansible.windows.win_copy) module instead. options: src: description: - Local path to a file to copy to the remote server. - This can be absolute or relative. - If path is a directory, it is copied recursively. In this case, if path ends with "/", only inside contents of that directory are copied to destination. Otherwise, if it does not end with "/", the directory itself with all contents is copied. This behavior is similar to the C(rsync) command line tool. type: path content: description: - When used instead of C(src), sets the contents of a file directly to the specified value. - Works only when C(dest) is a file. Creates the file if it does not exist. - For advanced formatting or if C(content) contains a variable, use the M(ansible.builtin.template) module. type: str version_added: '1.1' dest: description: - Remote absolute path where the file should be copied to. - If C(src) is a directory, this must be a directory too. - If C(dest) is a non-existent path and if either C(dest) ends with "/" or C(src) is a directory, C(dest) is created. - If I(dest) is a relative path, the starting directory is determined by the remote host. - If C(src) and C(dest) are files, the parent directory of C(dest) is not created and the task fails if it does not already exist. type: path required: yes 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: '0.7' force: description: - Influence whether the remote file must always be replaced. - If C(true), the remote file will be replaced when contents are different than the source. - If C(false), the file will only be transferred if the destination does not exist. type: bool default: yes version_added: '1.1' mode: description: - The permissions of the destination file or directory. - For those used to C(/usr/bin/chmod) remember that modes are actually octal numbers. You must either add a leading zero so that Ansible's YAML parser knows it is an octal number (like C(0644) or C(01777)) or quote it (like C('644') or C('1777')) so Ansible receives a string and can do its own conversion from string into number. Giving Ansible a number without following one of these rules will end up with a decimal number which will have unexpected results. - As of Ansible 1.8, the mode may be specified as a symbolic mode (for example, C(u+rwx) or C(u=rw,g=r,o=r)). - As of Ansible 2.3, the mode may also be the special string C(preserve). - C(preserve) means that the file will be given the same permissions as the source file. - When doing a recursive copy, see also C(directory_mode). - If C(mode) is not specified and the destination file B(does not) exist, the default C(umask) on the system will be used when setting the mode for the newly created file. - If C(mode) is not specified and the destination file B(does) exist, the mode of the existing file will be used. - Specifying C(mode) is the best way to ensure files are created with the correct permissions. See CVE-2020-1736 for further details. directory_mode: description: - When doing a recursive copy set the mode for the directories. - If this is not set we will use the system defaults. - The mode is only set on directories which are newly created, and will not affect those that already existed. type: raw version_added: '1.5' remote_src: description: - Influence whether C(src) needs to be transferred or already is present remotely. - If C(false), it will search for C(src) on the controller node. - If C(true) it will search for C(src) on the managed (remote) node. - C(remote_src) supports recursive copying as of version 2.8. - C(remote_src) only works with C(mode=preserve) as of version 2.6. - Autodecryption of files does not work when C(remote_src=yes). type: bool default: no version_added: '2.0' follow: description: - This flag indicates that filesystem links in the destination, if they exist, should be followed. type: bool default: no version_added: '1.8' local_follow: description: - This flag indicates that filesystem links in the source tree, if they exist, should be followed. type: bool default: yes version_added: '2.4' checksum: description: - SHA1 checksum of the file being transferred. - Used to validate that the copy of the file was successful. - If this is not provided, ansible will use the local calculated checksum of the src file. type: str version_added: '2.5' extends_documentation_fragment: - decrypt - files - validate - action_common_attributes - action_common_attributes.files - action_common_attributes.flow notes: - The M(ansible.builtin.copy) module recursively copy facility does not scale to lots (>hundreds) of files. seealso: - module: ansible.builtin.assemble - module: ansible.builtin.fetch - module: ansible.builtin.file - module: ansible.builtin.template - module: ansible.posix.synchronize - module: ansible.windows.win_copy author: - Ansible Core Team - Michael DeHaan attributes: action: support: full async: support: none bypass_host_loop: support: none check_mode: support: full diff_mode: support: full platform: platforms: posix safe_file_operations: support: full vault: support: full version_added: '2.2' a� - name: Copy file with owner and permissions ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: '0644' - name: Copy file with owner and permission, using symbolic representation ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: u=rw,g=r,o=r - name: Another symbolic mode example, adding some permissions and removing others ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: u+rw,g-wx,o-rwx - name: Copy a new "ntp.conf" file into place, backing up the original if it differs from the copied version ansible.builtin.copy: src: /mine/ntp.conf dest: /etc/ntp.conf owner: root group: root mode: '0644' backup: yes - name: Copy a new "sudoers" file into place, after passing validation with visudo ansible.builtin.copy: src: /mine/sudoers dest: /etc/sudoers validate: /usr/sbin/visudo -csf %s - name: Copy a "sudoers" file on the remote machine for editing ansible.builtin.copy: src: /etc/sudoers dest: /etc/sudoers.edit remote_src: yes validate: /usr/sbin/visudo -csf %s - name: Copy using inline content ansible.builtin.copy: content: '# This file was moved to /etc/other.conf' dest: /etc/mine.conf - name: If follow=yes, /path/to/file will be overwritten by contents of foo.conf ansible.builtin.copy: src: /etc/foo.conf dest: /path/to/link # link to /path/to/file follow: yes - name: If follow=no, /path/to/link will become a file and be overwritten by contents of foo.conf ansible.builtin.copy: src: /etc/foo.conf dest: /path/to/link # link to /path/to/file follow: no a; dest: description: Destination file/path. returned: success type: str sample: /path/to/file.txt src: description: Source file used for the copy on the target machine. returned: changed type: str sample: /home/httpd/.ansible/tmp/ansible-tmp-1423796390.97-147729857856000/source md5sum: description: MD5 checksum of the file after running copy. returned: when supported type: str sample: 2a5aeecc61dc98c4d780b14b330e3282 checksum: description: SHA1 checksum of the file after running copy. returned: success type: str sample: 6e642bb8dd5c2e027bf21dd923337cbb4214f827 backup_file: description: Name of backup file created. returned: changed and if backup=yes type: str sample: /path/to/file.txt.2015-02-12@22:09~ gid: description: Group id of the file, after execution. returned: success type: int sample: 100 group: description: Group of the file, after execution. returned: success type: str sample: httpd owner: description: Owner of the file, after execution. returned: success type: str sample: httpd uid: description: Owner id of the file, after execution. returned: success type: int sample: 100 mode: description: Permissions of the target, after execution. returned: success type: str sample: "0644" size: description: Size of the target, after execution. returned: success type: int sample: 1220 state: description: State of the target, after execution. returned: success type: str sample: file N)�to_bytes� to_native)� AnsibleModule)� get_bin_path)�get_best_parsable_locale)�PY3c @ s e Zd Zdd� ZdS )�AnsibleModuleErrorc C s || _ d S )N��results)�selfr � r �8/usr/lib/python3.9/site-packages/ansible/modules/copy.py�__init__4 s zAnsibleModuleError.__init__N)�__name__� __module__� __qualname__r r r r r r 3 s r c C sj t d�}|d| g}dd� |D �}tt�}tj|t|||d�d�\}}}|dkrftd�d �|�||���d S ) N�setfaclz-bc S s g | ] }t |��qS r )r )�.0�xr r r � <listcomp>@ � z clear_facls.<locals>.<listcomp>)�LANG�LC_ALL� LC_MESSAGES)Zenviron_updater z1Error running "{0}": stdout: "{1}"; stderr: "{2}"� )r r �module� run_command�dict� RuntimeError�format�join)�pathr Z acl_commandZ b_acl_command�locale�rc�out�errr r r � clear_facls< s r) c C sz t j�| �\}}t|dd�}|dkr.d|gfS t j�|�s^|dkrPtddid��t|�\}}n ||gfS |�|� ||fS ) zi Return the first pre-existing directory and a list of the new directories that will be created. �surrogate_or_strict��errors� �.�/�msgz0The '/' directory doesn't exist on this machine.r )�osr$ �splitr �existsr �split_pre_existing_dir�append)�dirname�head�tailZb_head�pre_existing_dir�new_directory_listr r r r4 G s r4 c C s@ |r<t j�| |�d��}||d< |�||�}t|||||�}|S )z] Walk the new directories list and make sure that permissions are as we would expect r r$ )r1 r$ r# �pop� set_fs_attributes_if_different�&adjust_recursive_directory_permissions)r9 r: r �directory_args�changedZ working_dirr r r r= Y s r= c s� d}|j d }|j d }|d u�rl|js�t�| �D ]�\� }}|�� |d�}|du rV|}� fdd�|D �D ] }|�||d�}|du rh|}qh� fdd�|D �D ] } |�| |d�}|du r�|}q�q2n�t�|�j} t�| �D ]�\� }}t�� �j | k}|du r�|}� fdd�|D �D ]$}t�|�j | k}|du �r |}�q � fd d�|D �D ]$} t�| �j | k}|du �rD|}�qDq�|d u�r�|j�s t�| �D ]�\� }}|� � |d�} | du �r�| }� fd d�|D �D ]"}|� ||d�} | du �r�| }�q�� fd d�|D �D ]"} |� | |d�} | du �r�| }�q��q�n�t � |�j } t�| �D ]�\� }}t�� �j| k} | du �r^| }� fd d�|D �D ]$}t�|�j| k} | du �rp| }�qp� fd d�|D �D ]$} t�| �j| k} | du �r�| }�q��q6|S )NF�owner�groupTc s g | ]}t j�� |��qS r �r1 r$ r# �r �d��dirpathr r r q r z#chown_recursive.<locals>.<listcomp>c s g | ]}t j�� |��qS r rB �r �frE r r r u r c s g | ]}t j�� |��qS r rB rC rE r r r r c s g | ]}t j�� |��qS r rB rG rE r r r � r c s g | ]}t j�� |��qS r rB rC rE r r r � r c s g | ]}t j�� |��qS r rB rG rE r r r � r c s g | ]}t j�� |��qS r rB rC rE r r r � r c s g | ]}t j�� |��qS r rB rG rE r r r � r )�params� check_moder1 �walk�set_owner_if_different�pwd�getpwnam�pw_uid�stat�st_uid�set_group_if_different�grp�getgrnam�gr_gid�st_gid) r$ r r? r@ rA �dirnames� filenamesZ owner_changed�dir�file�uidZ group_changed�gidr rE r �chown_recursivef st r] c C s� d}|j d }|j d }|j d }t�| |�j}t|�r<d}|js�|D ]�}tj�| |�} tj�||�} t | dd�} t | dd�} tj� | �r�|du r�t� | �} t� | | � nt �| | � t �| | � |dur�|�| |d� |dur�|�| |d� d}qF|S ) zKCopy files that are different between `src` directory and `dest` directory.Fr@ rA � local_followTr* r+ N)rI �filecmp�dircmp� diff_files�lenrJ r1 r$ r# r �islink�readlink�symlink�shutil�copyfile�copymoderL rR )�src�destr r? r@ rA r^ ra �item� src_item_path�dest_item_path�b_src_item_path�b_dest_item_path�linktor r r �copy_diff_files� s0 rq c C s8 d}|j d }|j d }|j d }t�| |�j}t|�r<d}|j�s4|D �]�}tj�| |�} tj�||�} t | dd�} t | dd�} tj� | �r�tj� | �r�|du r�t j | | | d� t| |� tj� | �r�tj� | �r�|du r�t�| �} t�| | � tj� | ��rVtj�| ��rV|du �rVt �| | � |d u�r>|�| |d� |d u�rV|�| |d� tj� | ��r�tj�| ��r�|du �r�t�| �} t�| | � tj� | ��s�tj�| ��r�t �| | � t �| | � |d u�r�|�| |d� |d u�r�|�| |d� tj� | ��s.tj� | ��r.t j | | | d� t| |� d}qH|S ) zFCopy files that exist in `src` directory only to the `dest` directory.Fr@ rA r^ Tr* r+ ��symlinksN)rI r_ r` � left_onlyrb rJ r1 r$ r# r rc �isdirrf �copytreer] rd re �isfilerg rL rR rh )ri rj r r? r@ rA r^ rt rk rl rm rn ro rp r r r �copy_left_only� sP & & rx c C s� d}t �| |�j}|D ]�}tj�| |�}tj�||�}t|dd�}t|dd�} t|| |�} t|| |�} | sn| rrd}|p�t tj�| |�tj�||�|�}q|S )NFr* r+ T) r_ r` � common_dirsr1 r$ r# r rq rx �copy_common_dirs) ri rj r r? ry rk rl rm rn ro �diff_files_changed�left_only_changedr r r rz � s &rz c ) C s� t ttdd�tdd�tddd�tddd�tddd �tddd �tdd�td d�tdd�tdd�tdd�tddd �d � ddd �atjd } t| dd�}tjd }tjj|vr�d�tjj|�}t|dd�}tjd }tjd }tj� dd �}tj� dd �}tjd }tjd } tjd } tjd } tjd } tjd } tjd }tj� |��sXtj d | d � t� |tj ��sxtj d | d � tjd d k�r�d!t�t�|�j� tjd< tjd } d}d }d }d }tj�| ��r>zt�| �}W n< ttf�y } z t�d"t|� � W Y d }~n d }~0 0 zt�| �}W n t�y: Y n0 n&| �rdtj�| ��sdt� d#t| � � |�r�||k�r�tj d$||d%� |�tj��r�|�r�tj�||�}t|dd�}tj� |�}t|dd�}tj� |��s�zt |�\}}W nP t �y8 } z6|j d& d'�|�7 < tj f i |j �� W Y d }~n d }~0 0 tj!�rVtj"d(| d| d)� t�#|� t�$tj�}tjd* }|d u�r�||d< nd |d< t%||t||� tj�|��r�tj�&| �}|�r�|}tj�||�}t|dd�}tj� |��r\tj�'|��r|�rtj�(|�}t|dd�}|�s2tj"d+| |dd,� t� |tj ��r�tj�|��r�t�|�}n�tj� tj� |���s�zt�tj� |�� W nP t�y� } z6d-t|��)� v �r�tj d.tj� |� d � W Y d }~n d }~0 0 tj d/tj� |� d � t� tj� |�tj*��s.tjd0 �s.tj d1tj� |� d � d }||k�sJtj�'|��r tj!�s�z�|�rttj� |��rtt�+|�}tj�'|��r�t�,|� t-|d2��.� |�r2| d u�r�t�/| | d� | d u�r�t�0| | d� | d u�r�t�1| | d� d3|v�rtj d4| d � t�2|| �\} } } | d5k�r2tj d6| | | d7� |} | �r�tj�|��r�t3j4tj� |�d8�\} } t5�6|| � zt5�7|| � W nV t�y� } z<| j8t8j9k�r�| d k�r�t�d9�t|��� n� W Y d } ~ n d } ~ 0 0 t:�r&t;td:��r&zd;t�<| �v }!W n* t=�y$ } zd}!W Y d }~n d }~0 0 tj>| |tjd0 d<� t:�r�t;td:��r�t?�@� d=k�r�| �s�|!�r�z tA|� W nn t�y� } z d>t|�v �r�n� W Y d }~n@d }~0 tB�y� } z d?t|�v �r�n� W Y d }~n d }~0 0 W n2 ttf�y tj d@| |f tC�D� dA� Y n0 d}nd}|d u � r||d u � r|| � r|tj�tjd �� r|ttjd dd�}ttjd dd�}| �tjj��r�tj�tjd ��r�tE||t�}"tF||t�}#tG||t�}$tH|t�}%|"�s�|#�s�|$�s�|%�r�d}| �tjj�� rvtj� tjd �� svttj�&| �dd�}&ttj�||&�dd�}ttj�tjd dB�dd�}tj!� sht5jI||| dC� tH|t� d}| �tjj�� s�tj�tjd �� r�ttj�&| �dd�}&ttj�||&�dd�}ttj�tjd dB�dd�}tj!� stj� |�� st5jI||| dC� d}tH|t� tj!� r0tj� |�� s0d}tj� |�� r�tE||t�}"tF||t�}#tG||t�}$tH|t�}%|"� s�|#� s�|$� s�|%� r�d}| �tjj�� s|tj� tjd �� s|ttj�&tjd �dd�}&ttj�||&�dd�}tj!� sbtj� |�� sbt�#|� ttj�tjd dB�dd�}tE||t�}"tF||t�}#tG||t�}$tH|t�}%|"� s^|#� s^|$� s^|%� rbd}tj!� r|tj� |�� s|d}t|| |||dD�}'|� r�||'dE< tj$tj|dF�}(t�J|(|'dG �|'dG< tj"f i |'�� d S )HNr$ )�type�strT)r} Zno_log)r} �required�boolF)r} �default�raw) ri �_original_basenameZcontentrj �backup�force�validate�directory_mode� remote_srcr^ �checksum�follow)Z argument_specZadd_file_common_argsZsupports_check_moderi r* r+ rj z.{0}{1}r� r� r� r� r� r^ �moder@ rA r� r� zSource %s not found)r0 zSource %s not readableZpreservez0%03oz5Unable to calculate src checksum, assuming change: %sz+Cannot copy invalid source '%s': not a filezBCopied file does not match the expected checksum. Transfer failed.)r0 r� Zexpected_checksumr0 z Could not copy to {0}z"dest directory %s would be created)r0 r? ri r� zfile already exists)r0 ri rj r? zpermission deniedz*Destination directory %s is not accessiblez'Destination directory %s does not exist� unsafe_writeszDestination %s not writable�wz%sz validate must contain %%s: %sr zfailed to validate)r0 � exit_status�stdout�stderr)rY zUnable to copy stats {0}� listxattrzsystem.posix_acl_access)r� ZLinuxr zOperation not supportedzfailed to copy: %s to %s)r0 � tracebackr- rr )rj ri Zmd5sumr� r? � backup_file)r$ r? )Kr r r rI r r1 r$ �sepr" �getr3 Z fail_json�access�R_OKrP �S_IMODE�st_moderw Zsha1�OSError�IOError�warnr Zmd5� ValueErrorru �endswithr# r6 r4 r �resultr rJ Z exit_json�makedirsZload_file_common_argumentsr= �basenamerc �realpath�lower�W_OKZ backup_local�unlink�open�closeZset_mode_if_differentrL rR r �tempfileZmkstemprf rg �copystat�errnoZENOSYSr �hasattrr� � ExceptionZ atomic_move�platform�systemr) r! r� � format_excrq rx rz r] rv r< ))ri Zb_srcrj Zb_destr� r� r� r� r� r^ r� r@ rA r� r� r? Z checksum_destZ checksum_srcZ md5sum_src�er6 Z b_dirnamer9 r: r> r� r� r� r& r' r( Zb_mysrc�_Z src_has_aclsr{ r| Zcommon_dirs_changedZowner_group_changedZ b_basenameZres_argsZ file_argsr r r �main s� �� (� ( .$ & $ $ $ $ �r� �__main__)+Z __future__r r r r} Z __metaclass__Z DOCUMENTATIONZEXAMPLESZRETURNr� r_ rS r1 Zos.pathr� rM rf rP r� r� Zansible.module_utils._textr r Zansible.module_utils.basicr Z#ansible.module_utils.common.processr Z"ansible.module_utils.common.localer Zansible.module_utils.sixr r r� r r) r4 r= r] rq rx rz r� r r r r r �<module> sF A? A 5 .