[PATCH 3/4] docs: Document SELinux issues

[Daniel Axtens]

Stephen Finucane <stephenfinucane at hotmail.com> writes:

> Initial Docker setup caused me some heartache on Fedora. Briefly
> document the issues encountered to help other users.

Sorry to hear that! Thanks for documenting this - I'll have to start
testing with Fedora at some point.

Regards,
Daniel

>
> Signed-off-by: Stephen Finucane <stephenfinucane at hotmail.com>
> ---
>  docs/development.md        | 16 ++++++++++++++++
>  tools/docker/entrypoint.sh |  2 ++
>  2 files changed, 18 insertions(+)
>
> diff --git a/docs/development.md b/docs/development.md
> index eaf3182..60ea904 100644
> --- a/docs/development.md
> +++ b/docs/development.md
> @@ -54,6 +54,22 @@ the Docker container, and so should be picked up by the Django auto-reloader.
>  For more information on Docker itself, please refer to the [Docker][ref-docker]
>  and [docker-compose][ref-compose] documentation.
>  
> +**NOTE:** If using SELinux, you will need to create a custom SELinux rule to
> +allow the Docker process to access your working directory. Run:
> +
> +    $ chcon -RT svirt_sandbox_file_t $PATCHWORK_DIR
> +
> +where `$PATCHWORK_DIR` is the absolute patch to the `patchwork` folder created
> +when you cloned the repo. For more information, see `man docker run`.
> +
> +**NOTE:** If you see an error like the below:
> +
> +    ERROR: Couldn't connect to the Docker daemon at
> +    http+docker://localunixsocket - is it running?
> +
> +ensure you have correctly installed Docker, added your user to the `docker`
> +group, and started the daemon, per the [Docker documentation][ref-docker].
> +
>  ## Vagrant-Based Installation
>  
>  Patchwork provides a Vagrant-based environment as an alternative to Docker.
> diff --git a/tools/docker/entrypoint.sh b/tools/docker/entrypoint.sh
> index bad507d..cd8ccf3 100755
> --- a/tools/docker/entrypoint.sh
> +++ b/tools/docker/entrypoint.sh
> @@ -31,6 +31,8 @@ if [ ! -f ~patchwork/patchwork/tools/docker/entrypoint.sh ]; then
>      echo "The patchwork directory doesn't seem to be mounted!"
>      echo "Are you using docker-compose?"
>      echo "If not, you need -v PATH_TO_PATCHWORK:/home/patchwork/patchwork"
> +    echo "If yes, you may need to create an SELinux rule. Refer to the"
> +    echo "development installation documentation for more information."
>      exit 1
>  fi
>  
> -- 
> 2.7.4
>
> _______________________________________________
> Patchwork mailing list
> Patchwork at lists.ozlabs.org
> https://lists.ozlabs.org/listinfo/patchwork
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 859 bytes
Desc: not available
URL: <http://lists.ozlabs.org/pipermail/patchwork/attachments/20160828/e639889f/attachment.sig>