Oc new-app: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
 
(21 intermediate revisions by the same user not shown)
Line 3: Line 3:
* [[Oc#new-app|oc]]
* [[Oc#new-app|oc]]
* [[oc new-project]]
* [[oc new-project]]
* [[oc run]]


=Overview=
=Overview=


A tool that generates an appropriate JSON configuration so OpenShift can build an image based on it. The configuration represents resources inside a [[OpenShift Concepts#Projects|project]]. The command is a shortcut to configure a project with common resources for a standard development workflow. Source code, images and templates are specified at this stage. The command looks for images on the new local Docker installation, if available, in the Docker registry and the OpenShift image stream.
new-app is a command that generates a JSON/YAML configuration. As the result of executing the command, the "app=<''app-name''>" label is set on all objects created as the result of the command.


If new-app finds a [[Docker Concepts#Dockerfile|Dockerfile]] in the repository, it uses the "docker" build strategy. Otherwise it uses the "source" strategy. The strategy can be explicitly set with --strategy option.
For more details see: {{Internal|OpenShift Application Operations#Overview|Application Operations}}


It can also be used to instantiate a stored template:
=Modes=
* [[OpenShift Create an Application from a Git Repository|Create an Application from a Git Repository]]
* [[OpenShift Create an Application from a Template|Create an Application from a Template]]
* [[OpenShift Create an Application from a Docker Image|Create an Application from a Docker Image]]


<pre>
=Dry Run=
oc new-app --template=example-template --param=USERNAME=somevalue
 
</pre>
Specify
 
-o yaml|json
 
and no objects will be created, but only YAML|JSON output generated.
 
=Options=
 
==-l, --labels==
 
To set a single label on all objects of the new application:
 
oc new-app -l 'key1=value1' ...
 
To set multiple labels:
 
oc new-app -l 'key1=value1,key2=value2,key3=value3' ...
 
{{Warn|Do not use spaces within the -l '...'}}
 
Note that using "app=..." label will overwrite the default app label value set by the new-app command. The command line value takes precedence.
 
==-p, --param==
 
Set values for template parameters:
 
oc new-app -p "VOLUME_CAPACITY=2Gi"
 
oc new-app --param "VOLUME_CAPACITY=2Gi"
 
==--name===
 
--name=something
 
The name of the generated application artifacts.

Latest revision as of 23:11, 5 February 2018

Internal

Overview

new-app is a command that generates a JSON/YAML configuration. As the result of executing the command, the "app=<app-name>" label is set on all objects created as the result of the command.

For more details see:

Application Operations

Modes

Dry Run

Specify

-o yaml|json

and no objects will be created, but only YAML|JSON output generated.

Options

-l, --labels

To set a single label on all objects of the new application:

oc new-app -l 'key1=value1' ...

To set multiple labels:

oc new-app -l 'key1=value1,key2=value2,key3=value3' ...

Do not use spaces within the -l '...'

Note that using "app=..." label will overwrite the default app label value set by the new-app command. The command line value takes precedence.

-p, --param

Set values for template parameters:

oc new-app -p "VOLUME_CAPACITY=2Gi"
oc new-app --param "VOLUME_CAPACITY=2Gi"

--name=

--name=something

The name of the generated application artifacts.