Commit Graph

78 Commits

Author SHA1 Message Date
Zuul 0b8c28986d Merge "Documentation: Add options for "glance image-import"" 2022-05-05 16:01:00 +00:00
whoami-rajat cf7504e795 Add doc and test for verbose parameter
We currently have support to show verbose output for image-list
with the command ``glance --verbose image-list`` but there is
no documentation about it.
This patch adds the documentation and a test to run it via CLI.

Closes-Bug: #1969565
Change-Id: Ic6db4f5ab2fecded373b044aa002f9a9bc262513
2022-04-21 14:34:42 +05:30
vihithad23 73aaef4286 Documentation: Add options for "glance image-import"
Closes-bug:#1886537
Change-Id: I66d99be1ec06806494c5504c467dff759dd38f2d
2022-01-13 01:45:22 +01:00
Andreas Jaeger de178ac438 Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Remove docs requirements from lower-constraints, they are not needed
during install or test but only for docs building.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: Ie4aec288c74b9bd8d8d117f4bc2e0282cea4db90
2020-05-22 17:23:12 +00:00
Andreas Jaeger baa89534a3 Cleanup py27 support
Make a few cleanups:
- Remove python 2.7 stanza from setup.py
- Update classifiers
- Update requirements, no need for python_version anymore

Change-Id: I6b6dfb0959973abf0c2e8325006025db2a5d85d0
2020-04-04 16:47:34 +02:00
Zuul 68cb66b5d0 Merge "Bump openstackdocstheme to 1.20.0" 2019-07-17 14:52:26 +00:00
翟小君 b79429aec6 Bump openstackdocstheme to 1.20.0
Some options are now automatically configured by the version 1.20:
- project
- html_last_updated_fmt
- latex_engine
- latex_elements
- version
- release.

Change-Id: I2577ca452a014402f1377474457095176d422b42
2019-07-02 09:45:33 +08:00
pengyuesheng 039fa4c045 Blacklist sphinx 2.1.0 (autodoc bug)
See https://github.com/sphinx-doc/sphinx/issues/6440 for upstream details
Depend-On: https://review.opendev.org/#/c/663060/

Change-Id: I8a96eea9d3d8f6d8beae9d86f307f0edd075392c
2019-06-10 11:12:44 +08:00
pengyuesheng 43e6338748 Update sphinx dependency
Sphinx 2.0 no longer works on python 2.7, so we need to start capping
it there as well
depend on https://review.opendev.org/#/c/657890/

Change-Id: Ic77e0db24ab7d7f068faf3e237beefa8856a710a
2019-05-28 15:17:25 +08:00
Chen Hanxiao c159b5ccbc image-list: add checksum algorithm description
We use MD5 for checksum, add this description
in cli helps.

Change-Id: I3469b0dface63f4684ad39421eee4c2a2de4d80b
Signed-off-by: Chen Hanxiao <chenhx@certusnet.com.cn>
2018-07-24 08:45:01 +08:00
Zuul 71abbfca2a Merge "Fix docs cli authorize environment variables" 2018-07-17 23:04:00 +00:00
Zuul c3afa0b70d Merge "Update 'doc/source/reference/apiv2.rst'" 2018-07-17 23:03:59 +00:00
Brian Rosmaita 9ecda262c0 Update property keys document
The list of useful image properties really belongs in the Glance
Administration Guide.  The only connection they have with the
glanceclient is that you can use it to set them.  Rewrite the
property keys document to reflect this.  The dependency moves the
relevant text to the Glance Admin Guide.

Depends-on: https://review.openstack.org/565780
Change-Id: I39add6728aad42988a07d2ad97cd81dbdaf4c54a
2018-05-02 10:41:19 -04:00
Nguyen Hai a8003eced7 Follow the new PTI for document build
- Follow new PTI for docs build
- Add sphinxcontrib.apidoc to replace pbr autodoc

REF:
https://governance.openstack.org/tc/reference/project-testing-interface.html
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html
http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html

Co-Authored-By: Nguyen Hai <nguyentrihai93@gmail.com>
Change-Id: Id16a5eaa57bc0d96332849abfb62898e6766ef86
2018-04-12 03:34:35 +00:00
caishan 38a0bff71a Fix docs cli authorize environment variables
OpenStack is deprecating 'tenant'. So use 'project' instead of 'tenant'

Change-Id: I1dc4dbbbe1eb1d01b0750eaf7994956eb657c7a6
2018-03-20 23:34:03 -07:00
ya.wang ec2c2d7da0 Update 'doc/source/reference/apiv2.rst'
- Add a simple introduction for the original parameters
  - Add two necessary parameters for Identity API v3:
    - user_domain_{name|id}
    - project_domain_{name|id}

Change-Id: Iebd9bb57fcdbd6abb8fc369e69ba52805fb77170
2018-03-12 09:30:45 +08:00
Rui Yuan Dou 8e862b6018 Remove deprecated ssl options
Old deprecated ssl options block the new keystoneauth parser get the
correct value, should be removed.

Change-Id: Ie080f9a8fa7f4407b1fcbb7fb7c763152c5ec295
Closes-Bug: 1697163
2018-01-17 08:50:57 +08:00
Zuul 11ac1e2eb3 Merge "Update Image service property keys doc" 2018-01-02 21:52:01 +00:00
Brian Rosmaita 726c50db81 Update Image service property keys doc
Doc update for change Ie8227fececa40e502aaa39d77de2a1cd0cd72682

Change-Id: I4b35d0ae768b331945cd014c004cef16ed2155b3
Closes-bug: #1694441
2017-12-22 20:31:40 +00:00
Brian Rosmaita 8eea3c7ef0 Update Image service property keys docs
Doc update for change I7c77fb13f20b59ad764070d14dc98a46f8b7c823

Change-Id: I8a636019c88526f6d65a96e9184aad10010eded2
Closes-bug: #1651907
2017-12-22 20:31:24 +00:00
Jenkins ddf45e52d1 Merge "Add documentation for image import commands" 2017-07-27 19:57:34 +00:00
Jenkins c9e10aef03 Merge "Update glanceclient version ref" 2017-07-27 16:08:46 +00:00
Brian Rosmaita 9a4f91c39e Add documentation for image import commands
Add documentation for the image import commands, particularly
pointing out that the image-create-via-import command is an
EXPERIMENTAL command that my be renamed or removed in a future
release.

Change-Id: I20ebc0145db6acc794039ed25e7754ec8d479bc8
2017-07-27 12:07:48 -04:00
Jenkins ca9ae01841 Merge "Make --profile load from environment variables" 2017-07-26 04:33:49 +00:00
Brian Rosmaita 51fea1b00a Update glanceclient version ref
Update a docs reference to the client version in preparation
for the next release.

Change-Id: I5f9542a543507290bdd8579adf773fe1b6bba5f6
2017-07-25 13:44:13 +00:00
PranaliD 28c003dc11 Removed the --no-ssl-compression parameter which is deprecated
--no-ssl-compression is deprecated and no longer used. So, it is
removed from the help message.

Change-Id: I2b886671a568ed191ee380cf16335ccd9ae85062
Closes-Bug: #1583919
2017-07-25 18:51:38 +05:30
Tovin Seven c0f88d5fc0 Make --profile load from environment variables
--profile argument can be loaded from OS_PROFILE environment variables
to avoid repeating --profile in client commands.

Correct/update help text.

Co-Authored-By: Hieu LE <hieulq@vn.fujitsu.com>
Change-Id: I67c1e4b859b972e380eb658c98ceae4fbef5c254
2017-07-24 13:30:29 +07:00
Hangdong Zhang c753ad8796 Update and optimize documentation links
1. Update URLs according to document migration
2. Update the dead and outdated links
3. Optimize (e.g. http -> https)

Change-Id: Iad743ad223b8c40ae914beccd936f71a81622d76
2017-07-19 12:38:19 +08:00
Javier Pena 8435b47f80 Fix man page build
https://review.openstack.org/474775 moved glance.rst from the
doc/source/man directory into doc/source/cli, so we need to adjust
the path in conf.py to avoid issues when running:

python setup.py build_sphinx -b man

Change-Id: I2c37755553d1265fb9fb069067c4468853f395b7
2017-07-04 16:48:28 +02:00
Doug Hellmann c859380718 turn on warning-is-error in sphinx build
Fix a formatting error in one docstring and turn on the flag to ensure
that future warnings in the doc build trigger a build failure.

Change-Id: I7159b985d1690a8ae61ff885408da4623c105952
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 12:25:32 -04:00
Doug Hellmann 4565e2bf45 use openstackdocstheme html context
Set some of the new config values and enable openstackdocstheme as an
extension so it will inject values into the page context as it writes
each documentation page. This ensures the pages link to the right bug
tracker, etc.

Change-Id: I316bd585f91064af4d1d1e7b834986619fc3a2d3
Depends-On: Icf3a40ed104cfd828f532f6f2b112ed02f996ff5
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 12:25:32 -04:00
Doug Hellmann b7a0cd0e66 switch to openstackdocstheme
Change-Id: Id687e3405d8afe0db201eb648941cc51bb9f741e
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 12:25:30 -04:00
Doug Hellmann ca7faf6bb5 import content from cli-reference in openstack-manuals
Change-Id: Ibea5fe3e4711af997841992dead7171c99c69bfa
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 12:24:48 -04:00
Doug Hellmann e8acf5e736 move existing content into the new standard structure
This patch rearranges and reformats existing content.

It replaces the home-grown autodoc feature with the one built into pbr,
for consistency with other OpenStack projects.

It depends on the doc-migration spec and a pbr feature to allow us to
specify where the autodoc content should go in the source tree during
the build.

Change-Id: I8d2bb11b5ef3e46fcd22c8bed8f84060d8ab6f03
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Depends-On: I2bd5652bb59cbd9c939931ba2e7db1b37d2b30bb
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-28 12:24:48 -04:00
Doug Hellmann c9100ed742 move old release notes into the releasenotes doc tree
Change-Id: I00797d38d6ad9b1a7b198767a0cbbb2f619c3b43
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-06-20 13:08:40 -04:00
Stephen Finucane 50eaad2249 doc: Remove cruft from conf.py
Change-Id: I1bbb2d490f0415e4062da520e6fb09e6db477aa0
2017-04-20 09:40:19 +01:00
Stephen Finucane 0e2e3f4372 Use Sphinx 1.5 warning-is-error
With pbr 2.0 and Sphinx 1.5, the setting for treat sphinx warnings as
errors is setting warning-is-error in build_sphinx section. Enable this.

Change-Id: I39ffb22c37a05f00cade2fbd14449eaf77dc3d39
2017-04-20 09:40:15 +01:00
Tom Cocozzello c6904d0332 Docs are generated incorrectly
When docs are generated with pbr command 'warnerrors = True'
there are many doc problems that are shown. This patch fixes
these problems.

Change-Id: Idb804ab924782b6d7d379494987bdba2acbce568
Closes-Bug: #1557235
2016-03-22 13:28:14 +00:00
Jenkins 56311d6e24 Merge "Change man page examples to correlate default v2" 2015-12-01 15:59:26 +00:00
Erno Kuvaja e2384d0012 Change man page examples to correlate default v2
Changing examples to correlate default behavior (v2 API) rather than
old v1 options.

Change-Id: I13a0d6040bfcd246189e0c1aeadf104ff5eff131
2015-11-17 16:33:33 +00:00
Erno Kuvaja d91210c806 Release Notes for version 1.2.0
1f1934e Add versions list function
bff356e Added reactivate/deactivate image using CLI
dfcb468 Fix the missing help descripiton of "image-create"
8a4cd79 Add documentation for running the functional tests
c7c0754 Updated from global requirements
d6a10f2 Remove unused sphinx Makefile
5a24705 Update docs to recommend KSA instead of KSC
84538d8 Use clouds.yaml from devstack for functional tests
4fb3092 Add translation to v2 shell
6b9133c Import i18n functions directly
8cf2bfc Updated from global requirements
b51634a improve readme contents
ca050ed Add support for setting Accept-Language header
3bd28bf Updated from global requirements
36937bb Use the subcomand parsed args instead of the base
afd1810 Stop trying to send image_size to the server
bf02b04 Support image deletion in batches in v2
a8a7c68 print usage when no argument is specified for python3
77012ee Updated from global requirements
603697a Updated from global requirements
df0f664 Do not use openstack.common.i18n in glance client
abf0381 Added unit tests for 'Unicode support shell client'
1f2fefb Use common identity parameters fro keystone client
c31c136 No auth when token and endpoint are passed
557acb1 Use dictionary literal for dictionary creation
c6addc7 Replace exception_to_str with oslo.utils function
586d401 Change ignore-errors to ignore_errors
05cd0c7 Add period in help message
b8a881f Don't get the image before deleting it
3d3d829 Fix human readable when size is None
19480df Add parsing the endpoint URL
22ce845 Fix Typos in comments
b9eee5e Add check Identity validate when get schemas

Change-Id: If2964135d73b45a11faf03b7dfa6b6f756a1abe0
2015-11-16 15:57:13 +00:00
Monty Taylor d6a10f27af Remove unused sphinx Makefile
The appropriate way to build sphinx docs in OpenStack is:

  tox -evenv -- python setup.py build_sphinx

Change-Id: I95dbab8b72cf40fb399703c01bf1a116fcffd4be
2015-10-21 17:38:54 +09:00
Monty Taylor 5a247055ae Update docs to recommend KSA instead of KSC
For the session workflow (which is really the only workflow a dev should
use), session objects should now come from keystoneauth1 instead of
python-keystoneclient.

Change-Id: Icb5f20ce3dc09ff7790b27d07f7f0cb3b83e1e7e
2015-10-21 17:38:54 +09:00
Erno Kuvaja 86635868c1 Change next version in docs
As stated by Doug we need to release 1.1.0 instead of 1.0.1
https://review.openstack.org/#/c/222716/

Change-Id: Ifb24361a1d5a5270c6b3173ba28409addfec19b0
2015-09-14 15:09:55 +00:00
Erno Kuvaja 04a54fed14 1.0.1 Release notes
f6712f5 Print the reverting back to v1 to stderr
2c7da7c Invalid output running the command 'glance image-show <image_id>'
5026774 Don't make `help` require auth parameters
75ec903 check for None value in utils.safe_header
f0b30f4 Updated from global requirements
1322fbc Consider `--os-token` when using v2
47423eb Check if v2 is available and fallback
90b7dc4 Update path to subunit2html in post_test_hook
1e2274a Password should be prompted once

Change-Id: I70329b9596421a4d8c0c953c19759a96f29c8b0d
2015-09-11 14:58:18 +00:00
Erno Kuvaja 54ae632f1b 1.0.0 release notes
Change-Id: I2cc3ba8d0064d6f424f16be94deaecdf1c5c8332
2015-08-27 20:02:30 +00:00
Nikhil Komawar db6420b447 Add release notes for 0.19.0
Changes included in this release:

    $ git log 0.18.0..HEAD --no-merges --oneline
    dfa98ab Updated from global requirements
    6cb26fc Include owner and status option in v2 image list
    5d933b0 Fix Metadef Object update issue with python-glanceclient
    9f5c581 Fix functional tests in gate
    1686d6a Do not crash on homedir mkdir
    1f89beb Improve import related error handling
    583adc3 Check image-download for redirection
    9c172fb Add some basic CLI functional tests
    bf413a6 Use assertIn instead of assertTrue in tests
    6431fae Unorder compare in tests
    5fa71aa Add release notes for 0.18.0
    6d31116 Update README to work with release tools
    71d9783 Create functional test base
    f2a8a52 Move unit tests to standard directory
    f931a20 Fixed doc example

Co-Authored-By: Louis Taylor <louis@kragniz.eu>

Change-Id: Ied7f5b4f298e2bbf4a5486eb6b7dbcea2d0e74d3
2015-06-10 10:04:23 +01:00
Jenkins 7ab3490978 Merge "Fixed doc example" 2015-05-26 17:16:57 +00:00
Louis Taylor 5fa71aa560 Add release notes for 0.18.0
Changes included in this release:

    $ git log 0.17.0..0.18.0 --no-merges --oneline
    8b4456a Uncap library requirements for liberty
    76c9f68 Add unit tests for log_curl_request
    bd0aa06 Fix https stack trace on python 3.4 client
    c698b4e Fix client when using no ssl compression
    64a1a0f Add SSL cert verification regression tests
    c730266 Omit 'locations' as image-create parameter
    a6234d1 Creating task with invalid property crashes in py3
    fd2f989 Don't accept *args for client
    e386e44 Stub authentication requests rather than plugins
    27f70bb Remove keystoneclient mocks
    02b1a05 Replace mox in tests with requests-mock
    90407d9 Expose 'is_base' schema property attribute
    2c08b40 Validate tag name when filtering for images
    13b5a5a Remove redundant FakeSchemaAPI __init__ method
    c149a94 glance image-show now have --human-readable option
    42d7548 Test unit for checking update active images
    6d864ef Correct help messages for image-update command
    f272ab3 Generate API documentation
    a1bb3eb Use any instead of False in generator

Change-Id: I687bef82afd7bb9a379297d7128a009cc051ca75
2015-04-23 13:31:11 +01:00
Jenkins 15c2e40449 Merge "Generate API documentation" 2015-03-25 05:17:08 +00:00