summaryrefslogtreecommitdiffstats
path: root/playbooks/provisioning/openstack/README.md
diff options
context:
space:
mode:
authortzumainn <tzumainn@redhat.com>2017-08-23 09:58:07 -0400
committerTomas Sedovic <tomas@sedovic.cz>2017-08-23 15:58:07 +0200
commitce9b66f71b60857f644cc5a3559a5c21af5d9b24 (patch)
treeb86fd94d91cf7c20ac8625dd9686b679b1fe5ec5 /playbooks/provisioning/openstack/README.md
parent15fbad5e99c8540ae1b891cb3ef3362dc5c737cf (diff)
downloadopenshift-ce9b66f71b60857f644cc5a3559a5c21af5d9b24.tar.gz
openshift-ce9b66f71b60857f644cc5a3559a5c21af5d9b24.tar.bz2
openshift-ce9b66f71b60857f644cc5a3559a5c21af5d9b24.tar.xz
openshift-ce9b66f71b60857f644cc5a3559a5c21af5d9b24.zip
Add documentation regarding running custom post-provision tasks (#678)
* Add documentation regarding running custom post-provision tasks * moved post-provision doc to openstack README * added reference to OSEv3, clarified some text
Diffstat (limited to 'playbooks/provisioning/openstack/README.md')
-rw-r--r--playbooks/provisioning/openstack/README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/playbooks/provisioning/openstack/README.md b/playbooks/provisioning/openstack/README.md
index 358ed182b..002c2f6aa 100644
--- a/playbooks/provisioning/openstack/README.md
+++ b/playbooks/provisioning/openstack/README.md
@@ -271,6 +271,44 @@ The first infra node then becomes a bastion node as well and proxies access
for future ansible commands. The post-provision step also configures Satellite,
if requested, and DNS server, and ensures other OpenShift requirements to be met.
+### Running Custom Post-Provision Actions
+
+If you'd like to run post-provision actions, you can do so by creating a custom playbook. Here's one example that adds additional YUM repositories:
+
+```
+---
+- hosts: app
+ tasks:
+
+ # enable EPL
+ - name: Add repository
+ yum_repository:
+ name: epel
+ description: EPEL YUM repo
+ baseurl: https://download.fedoraproject.org/pub/epel/$releasever/$basearch/
+```
+
+This example runs against app nodes. The list of options include:
+
+ - cluster_hosts (all hosts: app, infra, masters, dns, lb)
+ - OSEv3 (app, infra, masters)
+ - app
+ - dns
+ - masters
+ - infra_hosts
+
+After writing your custom playbook, run it like this:
+
+```
+ansible-playbook --private-key ~/.ssh/openshift -i myinventory/ custom-playbook.yaml
+```
+
+If you'd like to limit the run to one particular host, you can do so as follows:
+
+```
+ansible-playbook --private-key ~/.ssh/openshift -i myinventory/ custom-playbook.yaml -l app-node-0.openshift.example.com
+```
+
### Install OpenShift
Once it succeeds, you can install openshift by running: