mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
58 lines
2.0 KiB
Plaintext
58 lines
2.0 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * applications/application_life_cycle_management/creating-applications-using-the-cli.adoc
|
|
|
|
[id="applications-create-using-cli-template_{context}"]
|
|
= Creating an application from a template
|
|
|
|
You can create an application from a previously stored template or from a
|
|
template file, by specifying the name of the template as an argument. For
|
|
example, you can store a sample application template and use it to create an
|
|
application.
|
|
|
|
Upload an application template to your current project's template library. The following example uploads an application template from a file called `examples/sample-app/application-template-stibuild.json`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc create -f examples/sample-app/application-template-stibuild.json
|
|
----
|
|
|
|
Then create a new application by referencing the application template. In this example, the template name is `ruby-helloworld-sample`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc new-app ruby-helloworld-sample
|
|
----
|
|
|
|
To create a new application by referencing a template file in your local file system, without first storing it in {product-title}, use the `-f|--file` argument. For example:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc new-app -f examples/sample-app/application-template-stibuild.json
|
|
----
|
|
|
|
== Template parameters
|
|
|
|
When creating an application based on a template, use the `-p|--param` argument to set parameter values that are defined by the template:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc new-app ruby-helloworld-sample \
|
|
-p ADMIN_USERNAME=admin -p ADMIN_PASSWORD=mypassword
|
|
----
|
|
|
|
You can store your parameters in a file, then use that file with `--param-file` when instantiating a template. If you want to read the parameters from standard input, use `--param-file=-`. The following is an example file called `helloworld.params`:
|
|
|
|
[source,terminal]
|
|
----
|
|
ADMIN_USERNAME=admin
|
|
ADMIN_PASSWORD=mypassword
|
|
----
|
|
|
|
Reference the parameters in the file when instantiating a template:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc new-app ruby-helloworld-sample --param-file=helloworld.params
|
|
----
|