Bug 1416936 - oc process usage section in oc process -h is not updated with the changes in 3.5
Summary: oc process usage section in oc process -h is not updated with the changes in 3.5
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: oc
Version: 3.5.0
Hardware: All
OS: All
unspecified
low
Target Milestone: ---
: ---
Assignee: Juan Vallejo
QA Contact: Xingxing Xia
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-01-26 20:22 UTC by Siva Reddy
Modified: 2017-03-02 22:23 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-03-02 22:23:22 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Siva Reddy 2017-01-26 20:22:20 UTC
Description of problem:
    The help documentation for oc process is not updated with the changes to the -v param being deprecated and being replaced by -p option in the usage section. 


Version-Release number of selected component (if applicable):
openshift v3.5.0.9+e84be2b
kubernetes v1.5.2+43a9be4
etcd 3.1.0

How reproducible:
Always

Steps to Reproduce:
1. say oc process -h 
2. Note the usage section to be as follows
Usage:
  oc process (TEMPLATE | -f FILENAME) [-v=KEY=VALUE] [options]

3. use oc process according to above and say 
oc process -v ROLE=sender sometemplate.json
4. note the output to be
Flag --value has been deprecated, Use -p, --param instead.
error: template "uperf-scc.json" could not be found

Actual results:
    the command doesn't work as help documentation suggests as [-v=KEY=VALUE], --value KEY=VALUE is deprecated

Expected results:
   the usage section in "oc process -h" should read 
oc process (TEMPLATE | -f FILENAME) [-p=KEY=VALUE] [options] instead of 
oc process (TEMPLATE | -f FILENAME) [-v=KEY=VALUE] [options]

Additional info:

Comment 1 Juan Vallejo 2017-01-31 18:32:27 UTC
Related PR: https://github.com/openshift/origin/pull/12724

Comment 2 XiaochuanWang 2017-02-17 09:48:01 UTC
Verified on oc v3.5.0.30-1+35fa4bf
-v is dropped and is not in the help info, -p is clear with usage.

# oc process -h
...
Usage:
  oc process (TEMPLATE | -f FILENAME) [-p=KEY=VALUE] [options]
...
  -p, --param=[]: Specify a key-value pair (eg. -p FOO=BAR) to set/override a parameter value in the template.
...

# oc process -p MYSQL_USER=myname -f https://raw.githubusercontent.com/openshift/origin/master/examples/sample-app/application-template-stibuild.json
Command output the processed json

# oc process -p MYSQL_USER=myname -f https://raw.githubusercontent.com/openshift/origin/master/examples/sample-app/application-template-stibuild.json |oc create -f -
secret "dbsecret" created
service "frontend" created
route "route-edge" created
imagestream "origin-ruby-sample" created
imagestream "ruby-22-centos7" created
buildconfig "ruby-sample-build" created
deploymentconfig "frontend" created
service "database" created
deploymentconfig "database" created

Comment 3 Troy Dawson 2017-03-02 22:23:22 UTC
Since this never reached customers, I am closing this bug.


Note You need to log in before you can comment on or make changes to this bug.