From 6b6026789839f136596828d7706788f625c84eb8 Mon Sep 17 00:00:00 2001 From: James Tanner Date: Tue, 15 Oct 2013 09:40:37 -0400 Subject: [PATCH] Document per task remote_user, based on #3932 --- docsite/rst/playbooks.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docsite/rst/playbooks.rst b/docsite/rst/playbooks.rst index 4cd9f23b2d..a4e58b9f2c 100644 --- a/docsite/rst/playbooks.rst +++ b/docsite/rst/playbooks.rst @@ -103,6 +103,21 @@ documentation. The `remote_user` is just the name of the user account:: The `remote_user` parameter was formerly called just `user`. It was renamed in Ansible 1.4 to make it more distinguishable from the `user` module (used to create users on remote systems). +Remote users can also be defined per task:: + + --- + - hosts: webservers + remote_user: root + tasks: + - name: test connection + ping: + remote_user: yourname + +.. Note:: + + The `remote_user` parameter for tasks was added in 1.4. + + Support for running things from sudo is also available:: ---