Bug 999826 - [origin_broker_77] generate-rest-docs does not support specify options.
Summary: [origin_broker_77] generate-rest-docs does not support specify options.
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Online
Classification: Red Hat
Component: Master
Version: 2.x
Hardware: Unspecified
OS: Unspecified
medium
low
Target Milestone: ---
: ---
Assignee: Lili Nader
QA Contact: libra bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-08-22 08:38 UTC by Liang Xia
Modified: 2015-05-15 00:55 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-01-30 00:48:26 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Liang Xia 2013-08-22 08:38:45 UTC
Description of problem:
Try to generate rest api doc via generate-rest-docs with option --version or --user, but show:
[{"exit_code"=>nil, "field"=>nil, "severity"=>"error", "text"=>"Requested API version 0.0 is not supported. Supported versions are 1.0,1.1,1.2,1.3,1.4,1.5,1.6"}]
Error: User 'true' not found

Version-Release number of selected component (if applicable):
devenv_3685

How reproducible:
always

Steps to Reproduce:
1../generate-rest-docs --help
2../generate-rest-docs --version 1.6
3../generate-rest-docs --version 1.5
4../generate-rest-docs --user lxia

Actual results:
step 2 and 3 show:
[{"exit_code"=>nil, "field"=>nil, "severity"=>"error", "text"=>"Requested API version 0.0 is not supported. Supported versions are 1.0,1.1,1.2,1.3,1.4,1.5,1.6"}]

step 4 show:
Error: User 'true' not found
Adding............KEY..........
REQUIRED: name=mykey
REQUIRED: type=ssh-rsa
...content skipped...

Expected results:
doc generated successfully.

Additional info:
# ./generate-rest-docs --help
Usage: generate-rest-docs [options]
    -v, --version                    API Version
    -u, --username                   Username to use for generating docs
    -p, --password                   Password for username
    -s, --server                     Server to use for generating docs
    -h, --help                       Print usage

Comment 1 Lili Nader 2013-08-27 01:03:38 UTC
Removed support for options other than version.  These option were not required by the user story and could not be fully supported.

https://github.com/openshift/origin-server/pull/3503

Comment 3 Liang Xia 2013-08-28 03:09:33 UTC
Re-test this on devenv_3716, still can be reproduced.

Steps and results below:
# ./generate-rest-docs -h
Usage: generate-rest-docs [options]
Example: generate-rest-docs -v 1.6
    -v, --version                    API Version. Not required. Defaults to latest.
    -h, --help                       Print usage

# ./generate-rest-docs -v 1.6
User already has max_tracked_addtl_storage_per_gear set to 20
User already has allow private_ssl_certificates set to true
User first.last:
                  consumed gears: 0
                       max gears: 3
    max tracked storage per gear: 20
  max untracked storage per gear: 0
            plan upgrade enabled: true
                      gear sizes: small
            sub accounts allowed: false
private SSL certificates allowed: true

Encountered an error trying to get https://localhost/broker/rest/api
[{"exit_code"=>nil, "field"=>nil, "severity"=>"error", "text"=>"Requested API version 0.0 is not supported. Supported versions are 1.0,1.1,1.2,1.3,1.4,1.5,1.6"}]
Cannot parse response for resource API
Message: can't convert nil into String
Response:

Comment 5 Liang Xia 2013-12-11 06:21:22 UTC
Verified on devenv_4120. Options are usable.

# ./generate-rest-docs --help
Usage: generate-rest-docs [options]
Example: generate-rest-docs -v 1.6
    -v, --version VERSION            API Version. Not required. Defaults to 1.6.
    -d, --debug                      Debug flag
    -h, --help                       Print usage

# ./generate-rest-docs --version 1.4 -d
Setting max_tracked_addtl_storage_per_gear to 20... Done.
Setting private_ssl_certificates capability to true for user first.last... Done.
...


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