summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortomww <1033608+tomww@users.noreply.github.com>2018-09-25 12:27:24 +0200
committerJohn R Barker <john@johnrbarker.com>2018-09-25 11:27:24 +0100
commitc44de1069ca137280350781b13bab13f01ecd95a (patch)
tree4a75bdb91ae272ff3272a2d8a07ea847d258541b
parentd1688adefcde8f71d39aeeb009f7c8853b5b7c50 (diff)
downloadansible-c44de1069ca137280350781b13bab13f01ecd95a.tar.gz
Update synchronize.py, mention variable ansible_rsync_path needed for different local rsync binary (#41870)
* Update synchronize.py If you want a different rsync binary on the local side, you need to set task variable ansible_rsync_path. See examples. Variable ansible_rsync_path looks to not be documented anywhere. If documented, needs to be said that is does not belong to synchronise options, instead belongs to tasks. (Sorry, I have no better wording)
-rw-r--r--lib/ansible/modules/files/synchronize.py16
1 files changed, 15 insertions, 1 deletions
diff --git a/lib/ansible/modules/files/synchronize.py b/lib/ansible/modules/files/synchronize.py
index 616cfcbdee..198d515d67 100644
--- a/lib/ansible/modules/files/synchronize.py
+++ b/lib/ansible/modules/files/synchronize.py
@@ -114,9 +114,10 @@ options:
rsync_path:
description:
- Specify the rsync command to run on the remote host. See C(--rsync-path) on the rsync man page.
+ - To specify the rsync command to run on the local host, you need to set this your task var C(ansible_rsync_path).
rsync_timeout:
description:
- - Specify a --timeout for the rsync command in seconds.
+ - Specify a C(--timeout) for the rsync command in seconds.
default: 0
set_remote_user:
description:
@@ -301,6 +302,19 @@ EXAMPLES = '''
src: /tmp/path_a/foo.txt
dest: /tmp/path_b/foo.txt
link_dest: /tmp/path_a/
+
+# Specify the rsync binary to use on remote host and on local host
+- hosts: groupofhosts
+ vars:
+ ansible_rsync_path: "/usr/gnu/bin/rsync"
+
+ tasks:
+ - name: copy /tmp/localpath/ to remote location /tmp/remotepath
+ synchronize:
+ src: "/tmp/localpath/"
+ dest: "/tmp/remotepath"
+ rsync_path: "/usr/gnu/bin/rsync"
+
'''