summaryrefslogtreecommitdiffstats
path: root/roles/openshift_examples/README.md
diff options
context:
space:
mode:
authorThomas Wiest <twiest@users.noreply.github.com>2015-06-22 15:48:00 -0400
committerThomas Wiest <twiest@users.noreply.github.com>2015-06-22 15:48:00 -0400
commitc7d674b0bf6c4804f26808f49b0ceff2500b852b (patch)
treefbb1a0138703a7183e49cf07c6bd1ea0e863e241 /roles/openshift_examples/README.md
parenta7ac3f7b513fe57ddccad15bdb6c7e9091f16bcd (diff)
parent15bcfb3e59e6e31c00e23725547f896c03c93290 (diff)
downloadopenshift-c7d674b0bf6c4804f26808f49b0ceff2500b852b.tar.gz
openshift-c7d674b0bf6c4804f26808f49b0ceff2500b852b.tar.bz2
openshift-c7d674b0bf6c4804f26808f49b0ceff2500b852b.tar.xz
openshift-c7d674b0bf6c4804f26808f49b0ceff2500b852b.zip
Merge pull request #289 from sdodson/openshift_examples
Openshift examples
Diffstat (limited to 'roles/openshift_examples/README.md')
-rw-r--r--roles/openshift_examples/README.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/roles/openshift_examples/README.md b/roles/openshift_examples/README.md
new file mode 100644
index 000000000..787624ab6
--- /dev/null
+++ b/roles/openshift_examples/README.md
@@ -0,0 +1,45 @@
+OpenShift Examples
+================
+
+Installs example image streams, db-templates, and quickstart-templates by copying
+examples from this module to your first master and importing them with oc create -n into the openshift namespace
+
+Requirements
+------------
+
+Role Variables
+--------------
+
+| Name | Default value | |
+|-------------------------------------|-----------------------------------------------------|------------------------------------------|
+| openshift_examples_load_centos | true when openshift_deployment_typenot 'enterprise' | Load centos image streams |
+| openshift_examples_load_rhel | true if openshift_deployment_type is 'enterprise' | Load rhel image streams |
+| openshift_examples_load_db_templates| true | Loads databcase templates |
+| openshift_examples_load_quickstarts | true | Loads quickstarts ie: nodejs, rails, etc |
+| openshift_examples_load_xpaas | false | Loads xpass streams and templates |
+
+
+Dependencies
+------------
+
+Example Playbook
+----------------
+
+TODO
+----
+Currently we use `oc create -f` against various files and we accept non zero return code as a success
+if (and only iff) stderr also contains the string 'already exists'. This means that if one object in the file exists already
+but others fail to create you won't be aware of the failure. This also means that we do not currently support
+updating existing objects.
+
+We should add the ability to compare existing image streams against those we're being asked to load and update if necessary.
+
+License
+-------
+
+Apache License, Version 2.0
+
+Author Information
+------------------
+
+Scott Dodson (sdodson@redhat.com)