From 4b5a054253c262bd4c4f99680276055a3aeb0d1e Mon Sep 17 00:00:00 2001
From: Ina Panova <ipanova@redhat.com>
Date: Fri, 15 Sep 2017 15:56:16 +0200
Subject: [PATCH] Add ansible galaxy installation guide.

closes #2840
https://pulp.plan.io/issues/2840
---
 docs/installation/instructions.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/installation/instructions.rst b/docs/installation/instructions.rst
index 33c6afffde..e3bbe0564e 100644
--- a/docs/installation/instructions.rst
+++ b/docs/installation/instructions.rst
@@ -1,8 +1,28 @@
 Installation Instructions
 =========================
 
-Ansible
--------
+Pulp 3 Ansible Galaxy Installation
+----------------------------------
+
+1. In order to be able to run playbook, ensure python3 and ansible( >2.2) are installed::
+
+   $ sudo dnf install python3 ansible
+
+2. Target machine should have SELinux set to permissive mode.
+
+3. Target machine should have virtualenv installed::
+
+   $ sudo pip3 install virtualenv
+
+4. Download ``requirements.yml`` and install Galaxy roles specified in the file::
+
+   $ wget https://raw.githubusercontent.com/pulp/devel/3.0-dev/ansible/requirements.yml
+   $ ansible-galaxy install -r requirements.yml -p ./roles
+
+5. Download ``deploy-pulp3.yml`` playbook and run it by specifying which broker is desired rabbitmq|qpidd to be installed::
+
+   $ wget https://raw.githubusercontent.com/pulp/devel/3.0-dev/ansible/deploy-pulp3.yml
+   $ ansible-playbook deploy-pulp3.yml --extra-vars "pulp3_broker=rabbitmq"
 
 PyPI
 ----