Skip to content

Commit cecb87f

Browse files
soltyshbergerhoffer
authored andcommitted
Remove oc run from docs
oc run starting from 4.5 is creating only Pods and there is no option to create any other resource. Users should be using oc create <resource> commands instead. This update the documentation in all those places where oc create should be used instead.
1 parent 78873ed commit cecb87f

File tree

3 files changed

+10
-15
lines changed

3 files changed

+10
-15
lines changed

modules/cli-developer-troubleshooting.adoc

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,12 +90,11 @@ $ oc rsync ~/mydirectory/ python-1-mz2rf:/opt/app-root/src/
9090

9191
== run
9292

93-
Create and run a particular image. By default, this creates a DeploymentConfig
94-
to manage the created containers.
93+
Create a Pod running a particular image.
9594

96-
.Example: Start an instance of the `perl` image with three replicas
95+
.Example: Start a Pod running the `perl` image
9796
----
98-
$ oc run my-test --image=perl --replicas=3
97+
$ oc run my-test --image=perl
9998
----
10099

101100
== wait

modules/nodes-nodes-jobs-creating-cron.adoc

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ all subsequent executions will be suspended.
5656
<6> The number of failed finished jobs to retain (defaults to 1).
5757
<7> Job template. This is similar to the job example.
5858
<8> Sets a label for jobs spawned by this CronJob.
59-
<9> The restart policy of the pod. This does not apply to the job controller.
59+
<9> The restart policy of the pod. This does not apply to the job controller.
6060
+
6161
[NOTE]
6262
====
@@ -74,15 +74,12 @@ $ oc create -f <file-name>.yaml
7474

7575
[NOTE]
7676
====
77-
You can also create and launch a CronJob from a single command using `oc run`. The following command creates and launches the same CronJob as specified in the previous example:
77+
You can also create and launch a CronJob from a single command using `oc create cronjob`. The following command creates and launches a CronJob similar to the one specified in the previous example:
7878
7979
----
80-
$ oc run pi --image=perl --schedule='*/1 * * * *' \
81-
--restart=OnFailure --labels parent="cronjobpi" \
82-
--command -- perl -Mbignum=bpi -wle 'print bpi(2000)'
80+
$ oc create cronjob pi --image=perl --schedule='*/1 * * * *' -- perl -Mbignum=bpi -wle 'print bpi(2000)'
8381
----
8482
85-
With `oc run`, the `--schedule` option accepts schedules in link:https://en.wikipedia.org/wiki/Cron[cron format].
83+
With `oc create cronjob`, the `--schedule` option accepts schedules in link:https://en.wikipedia.org/wiki/Cron[cron format].
8684
87-
When creating a CronJob, `oc run` only supports the `Never` or `OnFailure` restart policies (`--restart`).
8885
====

modules/nodes-nodes-jobs-creating.adoc

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ spec:
3939
2. Optionally, specify how many successful pod completions are needed to mark a job completed.
4040
* For non-parallel jobs, leave unset. When unset, defaults to `1`.
4141
* For parallel jobs with a fixed completion count, specify the number of completions.
42-
* For parallel jobs with a work queue, leave unset. When unset defaults to the `parallelism` value.
42+
* For parallel jobs with a work queue, leave unset. When unset defaults to the `parallelism` value.
4343
3. Optionally, specify the maximum duration the job can run.
4444
4. Optionally, specify the number of retries for a job. This field defaults to six.
4545
5. Specify the template for the pod the controller creates.
@@ -59,10 +59,9 @@ $ oc create -f <file-name>.yaml
5959

6060
[NOTE]
6161
====
62-
You can also create and launch a job from a single command using `oc run`. The following command creates and launches the same job as specified in the previous example:
62+
You can also create and launch a job from a single command using `oc create job`. The following command creates and launches a job similar to the one specified in the previous example:
6363
6464
----
65-
$ oc run pi --image=perl --replicas=1 --restart=OnFailure \
66-
--command -- perl -Mbignum=bpi -wle 'print bpi(2000)'
65+
$ oc create job pi --image=perl -- perl -Mbignum=bpi -wle 'print bpi(2000)'
6766
----
6867
====

0 commit comments

Comments
 (0)