From 95ede22a1eae272461aec1ec9f98cdbaab2a4213 Mon Sep 17 00:00:00 2001 From: Toshio Kuratomi Date: Mon, 28 Sep 2015 22:50:06 -0700 Subject: [PATCH] Add a comment about the docker connection and usage by non-root users --- lib/ansible/plugins/connection/docker.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/lib/ansible/plugins/connection/docker.py b/lib/ansible/plugins/connection/docker.py index 5c3e4ac25f9..785c3a31a53 100644 --- a/lib/ansible/plugins/connection/docker.py +++ b/lib/ansible/plugins/connection/docker.py @@ -46,6 +46,12 @@ class Connection(ConnectionBase): def __init__(self, play_context, new_stdin, *args, **kwargs): super(Connection, self).__init__(play_context, new_stdin, *args, **kwargs) + # Note: docker supports running as non-root in some configurations. + # (For instance, setting the UNIX socket file to be readable and + # writable by a specific UNIX group and then putting users into that + # group). But if the user is getting a permission denied error it + # probably means that docker on their system is only configured to be + # connected to by root and they are not running as root. if 'docker_command' in kwargs: self.docker_cmd = kwargs['docker_command'] else: