summaryrefslogtreecommitdiffstats
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorScott Dodson <sdodson@redhat.com>2017-11-15 14:22:44 -0500
committerScott Dodson <sdodson@redhat.com>2018-01-30 14:43:29 -0500
commit70262d00b69fd100604fb8b25ffa2a39a23b87b8 (patch)
tree7c4c4e1f5a311fd43d7c5f90c78083735958d1dc /CONTRIBUTING.md
parentf894bcf6e7f1121cc024b2ff6a66db54740e02db (diff)
downloadopenshift-70262d00b69fd100604fb8b25ffa2a39a23b87b8.tar.gz
openshift-70262d00b69fd100604fb8b25ffa2a39a23b87b8.tar.bz2
openshift-70262d00b69fd100604fb8b25ffa2a39a23b87b8.tar.xz
openshift-70262d00b69fd100604fb8b25ffa2a39a23b87b8.zip
Add a bare minimum localhost hosts file
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1c0fa73ad..ef0a302dc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -74,6 +74,27 @@ If you are new to Git, these links might help:
---
+## Simple all-in-one localhost installation
+```
+git clone https://github.com/openshift/openshift-ansible
+cd openshift-ansible
+sudo ansible-playbook -i inventory/hosts.localhost playbooks/prerequisites.yml
+sudo ansible-playbook -i inventory/hosts.localhost playbooks/deploy_cluster.yml
+```
+
+## Development process
+Most changes can be applied by re-running the config playbook. However, while
+the config playbook will run faster the second time through it's still going to
+take a very long time. As such, you may wish to run a smaller subsection of the
+installation playbooks. You can for instance run the node, master, or hosted
+playbooks in playbooks/openshift-node/config.yml,
+playbooks/openshift-master/config.yml, playbooks/openshift-hosted/config.yml
+respectively.
+
+We're actively working to refactor the playbooks into smaller discrete
+components and we'll be documenting that structure shortly, for now those are
+the most sensible logical units of work.
+
## Running tests and other verification tasks
We use [`tox`](http://readthedocs.org/docs/tox/) to manage virtualenvs where