diff options
author | Scott Dodson <sdodson@redhat.com> | 2015-06-19 10:00:41 -0400 |
---|---|---|
committer | Scott Dodson <sdodson@redhat.com> | 2015-06-22 15:37:50 -0400 |
commit | 15bcfb3e59e6e31c00e23725547f896c03c93290 (patch) | |
tree | fbb1a0138703a7183e49cf07c6bd1ea0e863e241 /roles/openshift_examples/README.md | |
parent | a7ac3f7b513fe57ddccad15bdb6c7e9091f16bcd (diff) | |
download | openshift-15bcfb3e59e6e31c00e23725547f896c03c93290.tar.gz openshift-15bcfb3e59e6e31c00e23725547f896c03c93290.tar.bz2 openshift-15bcfb3e59e6e31c00e23725547f896c03c93290.tar.xz openshift-15bcfb3e59e6e31c00e23725547f896c03c93290.zip |
Add openshift_examples role
This role installs db-templates, image-streams, and quickstart-templates into
/usr/share/openshift/examples on the master and then uses `oc create` to import
them.
Diffstat (limited to 'roles/openshift_examples/README.md')
-rw-r--r-- | roles/openshift_examples/README.md | 45 |
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) |