91 Commits

Author SHA1 Message Date
Abhishek Kekane
52eaa56e40 [Doc] Policy support to copy unowned images
Change-Id: If0fd74d9f2eecb21153493457c58d767f12ffdeb
2020-07-27 16:54:01 +00:00
Rafael Weingärtner
e2e050c0b1 Add 'all' visibility filter for listing images in docs
Since this commit cfa9b6e8e8,
the visibility all is supported in the listing of images. However,
the documentation does not present it. This can make it hard for operators
to be aware of this option when listing images. Therefore, we propose to add
it in the documentation.

Change-Id: Iaa0ce6e1fde5c4c546b2f4a53969287b05d295de
2020-07-08 17:36:58 -03:00
Andreas Jaeger
03cb88a437 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.

Disable openstackdocs_auto_name to use 'project' variable as name.

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.

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.

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

Change-Id: Ib1796ac0c786c16bade68668f0d978ee71d29307
2020-05-30 16:56:09 +02:00
Brian Rosmaita
0a29d31c13 Correct reference to 2 import methods
We now have 3.

Change-Id: I276cead53ef4315881fda3659874f33084cae7ab
2020-02-26 17:35:27 -05:00
Abhishek Kekane
1754c9e2b0 Copy existing image in multiple stores
Added new import method 'copy-image' which will copy existing image into
specified list of stores. Introduced additional task which will serve
as internal plugin which will allow copying existing image into staging
area and then this data will be uploaded to specified stores via regula
import flow.

NOTE: This new import method 'copy-image' is only supported if multiple
stores are enabled in deployment.

APIImpact
Implements: blueprint copy-existing-image
Change-Id: I13eaab7ab013f44ce18465bdbdbe8052942570ff
2020-02-12 05:32:46 +00:00
Grégoire Unbekandt
92492cf504 Add ability to import image into multi-stores
The import image api now supports a list of stores to import data into.
This list can be specified through a new "stores" field that has been
added to the request body.
During import stage, Glance iterates overs this list and send the data
to each store one by one.
If an invalid backend is requested by the user, an exception is raised.
If an errors occurs during verify, already pushed data is removed and
image state is unchanged.

Change-Id: Id3ac19488c0a693d7042be4a3c83f3b9f12313d0
Implements: blueprint import-multi-stores
2020-02-10 09:39:01 +01:00
Zuul
26c5c8dff6 Merge "Remove OS::Compute::Trust metadef" 2020-01-28 05:42:34 +00:00
Erno Kuvaja
515412b59f Set API version 2.9 CURRENT
This change removes experimental status from Api versions
>2.7 setting 2.8 (multi-store support) to SUPPORTED and
2.9 (caching) to CURRENT.

NOTE: 2.8 will show up in list only if the glance-api service
is configured with multi-store. The API versions list can be
used to determine if the multi-store functionality is availabe
in the endpoint.

Change-Id: I37350fc46191074d42edc73c2451eae73261957d
2019-10-01 17:45:26 +00:00
Matt Riedemann
b78abdfa0e Remove OS::Compute::Trust metadef
The nova TrustedFilter scheduler filter was removed in the Queens
release [1] so the compute trust metadef is now just noise so we
should remove it.

[1] https://review.opendev.org/506864/

Change-Id: I71825cd5317d458fa30287b78cd1030cbc457dbd
2019-09-17 09:45:52 -04:00
Erno Kuvaja
d9546dce75 Images API version bump and config sync
This change contains minor version bump to Images API to
indicate latest changes to the API.

Also has config file sync for for M3 release.

These two are combined for saving some gating time due to
busy infra at Train milestone 3 deadline.

Change-Id: I13133c32734751d43cc3afed9b68d015cebd5b6b
2019-09-16 13:25:45 +01:00
Brian Rosmaita
6537ff2136 Update v2/info/stores api-ref
Slight rewrite of the stores discovery section of the api-ref to
indicate which elements of the response are optional and to remove
mention of the store type from the descriptions.

Change-Id: I8261de878fcaff1e498f7a3e152df7d980d0560c
2019-06-04 09:02:52 -04:00
Abhishek Kekane
f930288120 Mark http store read-only in discovery call
Made changes to discovery store to show 'http'
store as 'read-only' if it is configured under
'enabled_backends' cofiguration option.

Change-Id: If5d292bbb4cef1bd21a7e6cd4ef343a767eb91a4
2019-05-29 05:12:44 +00:00
ZhongShengping
8e16e3a857 Replace git.openstack.org URLs with opendev.org URLs
Thorough replacement of git.openstack.org URLs with their opendev.org
counterparts.

Change-Id: Ibe48a4ea537915bc6ce142812354b1d3b3ab1cf7
2019-04-28 09:26:48 +08:00
melissaml
a08a88b0a7 fix a typo in docstring
Change-Id: I47544dee1e386aac27dc23321de3ed927db58a30
2018-10-05 17:29:32 +08:00
Brian Rosmaita
d8221bf16f api-ref: "hidden" images update
Update the api-ref for the "Operator maintained images lifecycle"
spec implemented in Rocky.

Change-Id: I8fcfb84579b655fd44759164508ce4532e4dd205
2018-08-16 19:05:52 +00:00
Brian Rosmaita
b6d5100de7 api-ref: update version history
Update version history to include the Rocky changes.

Change-Id: Ie673a52c72a5975ac059002c351782a1c6d8df90
2018-08-08 16:15:41 -04:00
Zuul
671cfed406 Merge "Add API version 2.8" 2018-08-08 20:03:56 +00:00
Erno Kuvaja
208935af96 Add API version 2.8
This change bumps the API to EXPERIMENTAL 2.8 when multi back-end
is enabled.

Change-Id: Ie0e1ed84db1b227eea1774138b2a83172ff85bec
2018-08-07 16:39:06 +01:00
Brian Rosmaita
6187728bec api-ref: make the discovery section more general
Move all the v2/info calls to the same section of the api-ref.

Change-Id: I05cd7d89585a71cc8f5448cc3c08905da1638638
2018-08-07 11:31:37 -04:00
Zuul
cbdd1ab222 Merge "Doc:Multiple stores support" 2018-08-06 14:07:09 +00:00
Abhishek Kekane
d6ac7460ca Doc:Multiple stores support
Added documentation and modified api-ref documents to
reflect multiple stores support changes.

Related to blueprint multi-store
Change-Id: I932297df8149968d31a5367a9ca71a5629045445
2018-08-03 11:17:59 +00:00
Erno Kuvaja
8e16e41f4d Bump Imges API version to 2.7
This API version bump contains the extensions for hidden images
and multihash feature support.

Change-Id: I3d394b344492a1f06a4999a3f61cecf5ace30f23
2018-08-01 19:42:11 +01:00
Brian Rosmaita
0b24dbd620 Multihash implementation for Glance
Partially implements blueprint multihash.

Requires glance_store 0.26.1

Co-authored-by: Scott McClymont <scott.mcclymont@verizonwireless.com>
Co-authored-by: Brian Rosmaita <rosmaita.fossdev@gmail.com>

Change-Id: Ib28ea1f6c431db6434dbab2a234018e82d5a6d1a
2018-07-31 21:28:38 -04:00
inspurericzhang
612e5cf12b Replace Chinese punctuation with English punctuation
Curly quotes(Chinese punctuation) usually input from Chinese input method.
When read from english context, it makes some confusion.

Change-Id: I9b8830179fb98f3a6bef479bbaa12df70311269a
2018-06-07 17:00:12 +08:00
Zuul
ca062fb39d Merge "[api-ref] "Show images" should be changed to "List images"" 2018-05-04 16:44:49 +00:00
Ha Van Tu
71a3ac6235 [api-ref] "Show images" should be changed to "List images"
"List images" had been taken by the v1 API, but now that its
api reference has been removed, that's no longer a problem.
Can also remove the superfluous "an"s that were used in the
v2 titles to prevent sphinx conflicts.

Co-authored-by: Ha Van Tu <tuhv@vn.fujitsu.com>
Co-authored-by: Brian Rosmaita <rosmaita.fossdev@gmail.com>

Change-Id: I2c1ce3f5c1279a93a08855c554e156c4fc115f61
Closes-Bug: #1615899
2018-05-01 14:52:53 +00:00
junboli
927aaf870d Follow the OpenStack Sphinx theme configuration
Follow docs[1] and update the sphinx theme configuration,
Also updated bug_tag values for api-ref and documentation.

[1] https://docs.openstack.org/openstackdocstheme/latest/

Co-authored-by: wanghui <wang_hui@inspur.com>

Closes-bug: #1768365
Change-Id: I76308497122f4522fe307b3c29b696780e073027
2018-05-01 15:03:56 +08:00
Brian Rosmaita
012cce529f Add info about building the v1 api-ref
Because the Image API is removed in Rocky, its API Reference has
been deleted.  Add information about why it's gone and how to build
it to the current API Reference.

Closes-bug: #1762387

Change-Id: Ic215e7367b49df1ac837a4a1fa56effa7d9f7a61
2018-04-12 18:09:45 -04:00
Brian Rosmaita
c48acba840 Update image schema with Image API 2.6 statuses
Updates the schemas/image(s) responses and the api-ref.  (The dev
docs are correct.)  Adds a test so this won't happen again.

Closes-bug: #1762031
Change-Id: Ifb0a07fcdb1c8d91f1ad700329a208200222a2a6
2018-04-07 14:25:26 -04:00
Zuul
a7f2b98fc0 Merge "api-ref: fix list-resource-type-assocs example" 2018-03-09 11:07:33 +00:00
Brian Rosmaita
c53d7f1943 api-ref: correct typo
The sixth OpenStack release was named 'Folsom'.

Change-Id: I0674d16b04df903ad9ea306a38e7dead7804338e
2018-03-07 03:14:33 -05:00
Brian Rosmaita
0b49605630 api-ref: fix list-resource-type-assocs example
In the metadefs section of the api-ref, the current example response
for the list-resource-type-associations call is incorrect.  Add a
correct example response.

Change-Id: I10e92ce96b40563b3c4d02ac5c542960564837ec
Closes-bug: #1751208
2018-03-06 12:45:58 -05:00
Erno Kuvaja
c241cc075c Remove v1 from API ref
as preparation of removing Images API v1, clean it out from the API
Ref documentaion.

Change-Id: I65ef76fec0029949f8de867d711e745b7aa7f81d
2018-03-06 12:44:40 +00:00
Zuul
0f76384785 Merge "Correct length limit for custom property value" 2018-02-21 13:18:29 +00:00
Brian Rosmaita
601f82ac24 Correct length limit for custom property value
The api-ref states that the both the key and value of a custom
property are limited to 255 chars.  This limit applies only to
the key.

Change-Id: I3bacca8b25f2a8339f6d8758e45c690da9968555
Closes-bug: #1748900
2018-02-19 22:11:44 -05:00
Brian Rosmaita
4cf65d5795 api-ref: update interoperable image import info
Generalizes the discussion to include the new web-download import
method and includes a new sample import request.

Change-Id: Icb6cd920f31c6e8e4eecf17880dd3244e5d1a61b
Closes-bug: #1748229
2018-02-17 16:29:51 -05:00
Zuul
f09651df2b Merge "Update api-ref for v.2.6" 2018-02-08 19:59:22 +00:00
Zuul
b9e95a8db3 Merge "Update the valid disk bus list for qemu and kvm hypervisors" 2018-02-08 19:47:08 +00:00
Brian Rosmaita
32f8724f6e Update api-ref for v.2.6
2.6 was experimental in Pike but is current in Queens.

Change-Id: I4f8c4ff72808aac1fc52c65673d28530aa9939f2
Closes-bug: #1748218
2018-02-08 12:32:48 -05:00
chenxing
f8a5a40224 Update the valid disk bus list for qemu and kvm hypervisors
The Nova project has added 'sata' as a valid disk bus for qemu and
kvm hypervisors, see https://review.openstack.org/#/c/459794/6

DocImpact: add to metadefs release note

Related-Bug: #1686136
Change-Id: If8e23756616e46391827ac3d85d287940862613f
2017-12-06 03:16:27 +00:00
Brian Rosmaita
8026e7f588 Update api-ref about 403 for image location changes
Add deleting the only location or attempting to set the locations
to an empty list as another reason why a user might get a 403
response to a PATCH call.

Change-Id: I2edb072ded11d1b710af0309f0372d1b16042a54
Closes-bug: #1542724
2017-10-19 18:45:42 -04:00
Dinesh Bhor
2562da28c6 Fix 500 if user passes name with more than 80 characters
Following apis are returning 500 error if user passes name with more
than 80 characters:
* md-tag-create
* md-tag-update
* md-object-create
* md-object-update
* md-property-create
* md-property-update

This happens because there is a discrepancy in db column length and
glance-api length check in schema validation. In database the 'name'
field for these API's is defined as of maximum 80 characters and in
schema it is defined as of maximum 255 characters. So if user passes
name with more than 80 characters and less than 255 characters
database fails to store that value and shouts with following error
which leads to 500 error to API user:

(pymysql.err.DataError) (1406, u"Data too long for column 'name' at
row 1")

Fixed this issue by changing the maximum allowed length for 'name'
from 255 to 80 in schema validation.

APIImpact
DocImpact
Closes-Bug: #1719252
Change-Id: I4ae67457c3e4f5a6bfc3c1db2d305a9b7587395f
2017-10-05 10:24:22 +05:30
Sean McGinnis
6c7537163e Clean up api-ref index page
The v1 API is deprecated, so moving that to be the last item in
the ToC. Also adding a search link to the top to make it easier
to find things within the API documentation.

Change-Id: Id558679ef9e7012ad4fbe8ea25e9bc544851d4c2
2017-09-27 15:23:32 -05:00
Brian Rosmaita
7101d9ceea api-ref: add 'protected' query filter
Adds documentation for the 'protected' query filter introduced
in Pike.

Change-Id: I7c63ae1715e1bd35587f0f0954596ae1263d428b
Closes-bug: #1713177
2017-08-25 21:13:21 -04:00
Jenkins
64bbb06990 Merge "api-ref: add interoperable image import docs" 2017-08-21 18:49:30 +00:00
Brian Rosmaita
8005ee994c api-ref: add interoperable image import docs
Adds documentation of the interoperable image import process
introduced in Pike in the EXPERIMENTAL Image API v2.6.

Change-Id: Ifbedc2e5e566db084bc7028ed4239485f0d68b18
2017-08-21 10:42:36 -04:00
Jenkins
68a45793be Merge "api-ref: update container_format, disk_format" 2017-08-18 16:50:06 +00:00
Rui Yuan Dou
8886dcd114 Update invalid path and link for Image Properties
Change-Id: I67e84be3ceb4b6810f8b7c39d953b36c04641afb
2017-08-16 09:07:51 +08:00
Brian Rosmaita
af8c371a8c Bump Images API to v2.6
The MVP of image import functionality will be introduced as an
EXPERIMENTAL 2.6 version of the Images API.  The current version
will remain at 2.5.

This patch:
* Updates the version response
* Updates version negotiation code
* Updates unit and functional tests
* Updates the api-ref
* Adds a releasenote

Change-Id: Ied573897157e05f7b0438baeb1553326fb06613a
2017-08-06 09:19:13 -04:00
Brian Rosmaita
08cd24d28c api-ref: update container_format, disk_format
This patch updates the disk_format description to include "ploop"
(added in Ocata).  It also rewrites the container_format description
to indicate that the actual values depend on how the API being queried
is configured.

This patch does not update the api-ref for the deprecated v1 API.

Change-Id: I3385b3f628b74b109c05108e331085c54b0126a1
2017-08-03 18:47:13 -04:00