diff options
author | Russell Teague <rteague@redhat.com> | 2017-04-25 10:20:39 -0400 |
---|---|---|
committer | Russell Teague <rteague@redhat.com> | 2017-04-25 15:41:36 -0400 |
commit | 51ffcb739c1ebf9872aa3f45a905b087ae9e0f48 (patch) | |
tree | fccf877403a58bbd52c8200cdd3541dddb37e747 /roles/openshift_examples/files/examples/v1.6/db-templates/README.md | |
parent | d4d143778596087175f1bd5339a1bed1288e8520 (diff) | |
download | openshift-51ffcb739c1ebf9872aa3f45a905b087ae9e0f48.tar.gz openshift-51ffcb739c1ebf9872aa3f45a905b087ae9e0f48.tar.bz2 openshift-51ffcb739c1ebf9872aa3f45a905b087ae9e0f48.tar.xz openshift-51ffcb739c1ebf9872aa3f45a905b087ae9e0f48.zip |
Standardize all Origin versioning on 3.6
Diffstat (limited to 'roles/openshift_examples/files/examples/v1.6/db-templates/README.md')
-rw-r--r-- | roles/openshift_examples/files/examples/v1.6/db-templates/README.md | 76 |
1 files changed, 0 insertions, 76 deletions
diff --git a/roles/openshift_examples/files/examples/v1.6/db-templates/README.md b/roles/openshift_examples/files/examples/v1.6/db-templates/README.md deleted file mode 100644 index a36d7ba7d..000000000 --- a/roles/openshift_examples/files/examples/v1.6/db-templates/README.md +++ /dev/null @@ -1,76 +0,0 @@ -OpenShift 3 Database Examples -============================= - -This directory contains example JSON templates to deploy databases in OpenShift. -They can be used to immediately instantiate a database and expose it as a -service in the current project, or to add a template that can be later used from -the Web Console or the CLI. - -The examples can also be tweaked to create new templates. - - -## Ephemeral vs. Persistent - -For each supported database, there are two template files. - -Files named `*-ephemeral-template.json` use -"[emptyDir](https://docs.openshift.org/latest/dev_guide/volumes.html)" volumes -for data storage, which means that data is lost after a pod restart. -This is tolerable for experimenting, but not suitable for production use. - -The other templates, named `*-persistent-template.json`, use [persistent volume -claims](https://docs.openshift.org/latest/architecture/additional_concepts/storage.html#persistent-volume-claims) -to request persistent storage provided by [persistent -volumes](https://docs.openshift.org/latest/architecture/additional_concepts/storage.html#persistent-volumes), -that must have been created upfront. - - -## Usage - -### Instantiating a new database service - -Use these instructions if you want to quickly deploy a new database service in -your current project. Instantiate a new database service with this command: - - $ oc new-app /path/to/template.json - -Replace `/path/to/template.json` with an appropriate path, that can be either a -local path or an URL. Example: - - $ oc new-app https://raw.githubusercontent.com/openshift/origin/master/examples/db-templates/mongodb-ephemeral-template.json - -The parameters listed in the output above can be tweaked by specifying values in -the command line with the `-p` option: - - $ oc new-app examples/db-templates/mongodb-ephemeral-template.json -p DATABASE_SERVICE_NAME=mydb -p MONGODB_USER=default - -Note that the persistent template requires an existing persistent volume, -otherwise the deployment won't ever succeed. - - -### Adding a database as a template - -Use these instructions if, instead of instantiating a service right away, you -want to load the template into an OpenShift project so that it can be used -later. Create the template with this command: - - $ oc create -f /path/to/template.json - -Replace `/path/to/template.json` with an appropriate path, that can be either a -local path or an URL. Example: - - $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/db-templates/mongodb-ephemeral-template.json - template "mongodb-ephemeral" created - -The new template is now available to use in the Web Console or with `oc -new-app`. - - -## More information - -The usage of each supported database image is further documented in the links -below: - -- [MySQL](https://docs.openshift.org/latest/using_images/db_images/mysql.html) -- [PostgreSQL](https://docs.openshift.org/latest/using_images/db_images/postgresql.html) -- [MongoDB](https://docs.openshift.org/latest/using_images/db_images/mongodb.html) |