706 Commits

Author SHA1 Message Date
Abhishek Kekane
6dba83ba3a Rethinking filesystem access
In Rocky multiple backend support is added as experimental feature. In
order to take advantage of this feature it is decided to deprecate
work_dir and node_staging_uri configuration options
and reserve two filesystem stores 'os_glance_tasks_store' and
'os_glance_staging_store', which can be used to get rid of initializing
store via internal functions.

These internal stores are considered "reserved stores" by Glance.
For the time being, these are hard-coded as filesystem stores.  The
store prefix 'os_glance_' is reserved for internal Glance use and
the glance-api service will refuse to start if a store with this
prefix is included in the enabled_backends config option in
glance-api.conf.

NOTE: Because there are no sensible default values for the location
of the datadir for each of these stores, the operator must define
'os_glance_tasks_store' and 'os_glance_staging_store' in
glance-api.conf configuration file as shown below.

[os_glance_tasks_store]
filesystem_store_datadir = /var/lib/glance/tasks_work_dir/

[os_glance_staging_store]
filesystem_store_datadir = /var/lib/glance/staging/

Each filesystem store must have a unique datadir.

Depends-On: https://review.openstack.org/#/c/639765/
Implements: blueprint rethinking-filesystem-access
Change-Id: I86ec513c5fc653dbb97b79d953d8430f014e684f
2019-10-01 09:53:48 +00:00
Erno Kuvaja
82697983c0 Use glance as example in docs instead of osc
This patch also removes casual suggestion to turn on show multiple
locations. This feature has been idetified as vulnerability and
we should not advise turning it on without explaining the specific
use cases where it might be necessary.

Co-authored-by: Erno Kuvaja <jokke@usr.fi>
Co-authored-by: Brian Rosmaita <rosmaita.fossdev@gmail.com>

Change-Id: I65952f70f0216d227ca14d1098d264208913e4e5
2019-09-27 19:21:09 +02:00
Adam Spiers
3a281b9bc6 Add SEV-related extra spec and image properties
The AMD SEV support recently introduced to nova[0] depends on certain
metadata properties for flavors and images which were either missing
or only partially covered by existing glance metadata, so fill the
missing gaps:

- Add the hw:mem_encryption flavor extra spec and corresponding
  hw_mem_encryption image property.

- hw_firmware_type has been supported by nova for quite a while,
  so register it as an official metadata property.

- Add hw_cdrom_bus which was missing as per
  https://bugs.launchpad.net/glance/+bug/1808868.  This shares
  values with hw_disk_bus, so document that too.

[0] https://docs.openstack.org/nova/latest/admin/configuration/hypervisor-kvm.html#amd-sev-secure-encrypted-virtualization

Closes-Bug: 1808868
Change-Id: I8116565ad0326d0125b320d840d787edcb086aa9
2019-09-12 19:58:27 +01:00
Abhishek Kekane
73fefddd96 Add periodic job to prefetch images into cache
Added new periodic job which will run as per interval set using
'cache_prefetcher_interval' configuration option and fetch images
which are queued for caching in cache directory.

DocImpact
Change-Id: If2875f7a215aca10a6ed2febc89b02219f90a10d
2019-09-10 15:01:58 +00:00
Zuul
ca00b48e59 Merge "add metadef vlaues for new video models" 2019-09-06 12:03:03 +00:00
Zuul
1b6ae384af Merge "add hw_pmu metadef" 2019-09-06 03:13:48 +00:00
Zuul
d105390c62 Merge "Update hw_rng_model image property doc" 2019-09-04 14:34:45 +00:00
Zuul
3d2c1c104f Merge "Remove glance-registry stuff" 2019-09-04 14:34:43 +00:00
Brian Rosmaita
c3e0b8436a Add disk format content from Image Guide
The container_format and disk_format identifiers and their
descriptions are being maintained in the Glance docs.  Move some
useful content on this topic over from the Image Guide before
deleting it over there so it's only being maintained in one
location.

Change-Id: Ifa8de9d3a3a2aa78ee305aaebb23cd982b02dd91
Partial-bug: #1842343
2019-09-02 21:16:40 -04:00
Zuul
e9353d7861 Merge "Add 'compressed' option to container_format" 2019-08-28 23:00:10 +00:00
ZhengMa
43aa047922 Add 'compressed' option to container_format
This patch is purposed to support a new container_format
so that we can do image compression when uploading a volume
to glance and decompression when downloading a image from
glance.

This patch includes:

1. A new container_format option: 'compressed'.

2. Unit test for new option.

DocImpact
Implements: blueprint leverage-compression-accelerator

Depends-On: https://review.opendev.org/#/c/670454/
Change-Id: I62159315346e99522740383dd4bb5d2cc0ee368d
2019-08-28 03:01:48 +00:00
Sean Mooney
5bdefff5cd add metadef vlaues for new video models
- This change adds the newly supported libvirt
  video models, virtio, gop and none.
- This change updates the train metadefs changes
  release note.

Change-Id: I440a038b53825b5f92fc977566edcf3cabfba673
2019-08-21 01:18:07 +01:00
Sean Mooney
2998c795ed add hw_pmu metadef
This change adds a new hw_pmu metadef property to the
OS::Compute::LibvirtImage namespace and extends the train
metadef changes releasenote.

Depends-on: https://review.opendev.org/#/c/671338/
Change-Id: I2f4e7ef4f816afbd0524a6265d5605afa1da5f86
2019-08-21 01:06:04 +01:00
Alexandra Settle
f5283d8b54 Updating Ceph 404 URLs
Updating to latest URL. Although this is probably
best double checked as this was quite hard to
find and inconsistent since the website has moved
and changed a lot.

Change-Id: Ia6a1c4ae557853dce7ac4cfa1adc3df774121121
backport: stein rocky
2019-08-09 13:47:25 +10:00
Andreas Jaeger
15609a11bd Update api-ref location
The api documentation is now published on docs.openstack.org instead
of developer.openstack.org. Update all links that are changed to the
new location.

Note that redirects will be set up as well but let's point now to the
new location.

For details, see:
http://lists.openstack.org/pipermail/openstack-discuss/2019-July/007828.html

Change-Id: I17c97cb7655bdedc3927f4883b45ba4dcfc55516
2019-07-22 19:15:05 +02:00
Zuul
a7b6d1eaa8 Merge "Bump openstackdocstheme to 1.20.0" 2019-07-17 17:11:28 +00:00
zengjia
d319acbd64 Update the glance installation page
Modifying Version Description Errors in Web Page

Change-Id: I72fe9b60f9380810e952e90f48ee226c682fff2f
2019-07-04 09:46:04 +08:00
翟小君
d4d045f31a 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: Ica74f2982a75e3faf7a5244390f2299381eb5b89
2019-07-02 09:52:19 +08:00
chenxing
3264e779dc Remove glance-registry stuff
The Glance Registry Service and its APIs have been DEPRECATED in the
Queens release and are subject to removal at the beginning of the ‘S’
development cycle, For more information, see the Glance specification
document:
http://specs.openstack.org/openstack/glance-specs/specs/queens/approved/glance/deprecate-registry.html

Change-Id: I37cbe544f6a1575ebf09fa3c0a87120a6b7dbc7a
backport: rocky
2019-06-23 07:59:08 +08:00
pengyuesheng
fd6f2fa027 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: I8c91468dce50f2404e3689d939cfd482a613b015
2019-06-12 14:17:22 +08:00
Brian Rosmaita
90bffdc361 Update hw_rng_model image property doc
This property requires configuration on the Nova side for it
to have an effect; make that clear in the documentation.

Change-Id: I9a1902eefcb3a2ed1334f24a5d3335e17ab0aad2
Closes-bug: #1805679
2019-06-06 09:39:46 -04:00
Zuul
d99cea0cc7 Merge "Mark http store read-only in discovery call" 2019-05-29 14:32:19 +00: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
pengyuesheng
7dea25d8c4 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: Ibb821fabd479af05bd4daf3d68cac16fc5e1b9c4
2019-05-28 15:39:33 +08: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
Zuul
f9a568f235 Merge "Document os_shutdown_timeout image property" 2019-04-09 17:25:06 +00:00
Zuul
218aa1cd39 Merge "Update CLI doc header for Stein" 2019-04-05 13:59:00 +00:00
Brian Rosmaita
e4fd4d8440 Update CLI doc header for Stein
Change-Id: Iccdd9d086cfe2e85da6dafa9d269f02bce311786
2019-04-04 11:11:23 -04:00
Abhishek Kekane
8e957bff59 Update cache-manage documentation
During Stein cycle glance has added support to use cache-manage
utility using V2 API. Now it has support for keystone v3
authentication as well.

Change-Id: I698bdb84f6dcb964d7cf5e907f61c35e9beb36f0
Closes-Bug: #1823124
2019-04-04 07:46:52 +00:00
zhangbailin
345b9e77fe Add description to common image properties
Add the 'description' attribute to common image properties to allow
users to record the purpose of the image in a human-readable format
in an interoperable way.

Co-authored-by: zhangbailin <zhangbailin@inspur.com>
Co-authored-by: Brian Rosmaita <rosmaita.fossdev@gmail.com>

Change-Id: Id0b148190cfa5fb9851ad2085a6b1ac1e0e7e352
Blueprint: add-description-field-to-image
2019-03-20 11:51:47 -04:00
Zuul
33ec69c865 Merge "Update requirement platform checks" 2019-03-14 09:05:00 +00:00
Lucian Petrut
d7321ada06 Update requirement platform checks
pysendfile and xattr cannot be used on Windows, so we had to add
platform checks for those requirements. This has already merged
in the global requirements project.

We now have to pull those changes in glance. Without it, the
requirements test job is failing.

blueprint windows-support

Change-Id: I488537b9490591fa43a0610f7503bc05e1c72134
2019-03-13 14:09:54 +02:00
Zuul
3ba6b40c27 Merge "Clarify the Glance/metadefs relationship" 2019-03-11 15:00:58 +00:00
Zuul
2cf78f339d Merge "Document fileystem drv chunk size option" 2019-03-06 06:23:54 +00:00
Brian Rosmaita
eceb4f54c6 Clarify the Glance/metadefs relationship
I've answered a few questions recently for people who assumed that
since the metadefs service lives on the Glance endpoint, metadefs
have some kind of special relationship to images.  I think the
metadefs section of the api-ref makes it clear that this is not the
case (though it's not mentioned at all on the Images part of the
api-ref).  So here's an attempt to clarify issue (without being too
intrusive) right at the top of the Glance docs landing page.

Change-Id: I3dfbb09862acedb265a5a4557749bf52f6add5f4
2019-03-05 15:50:14 +00:00
Lucian Petrut
b2b3e53248 Document fileystem drv chunk size option
A new config option has been added to the filesystem driver
which allows specifying the chunk size to be used.

This change mentions it in the config documentation.

Depends-On: I1559c03308d36ecf9305c7a72ad658ecd1f2dc76

Change-Id: I4ddce9c3ed8f393f76a4c81879c68a3cfcf68bbf
2019-03-04 12:32:25 +02:00
Zuul
437ba3ee9b Merge "Update Ubuntu install guide" 2019-01-15 11:43:44 +00:00
Brian Rosmaita
cf2b3f25aa Update "Disallowed minor code changes" doc
Update contributor docs to reflect the discussion of oslo library
usage at the 10 January 2019 Glance weekly meeting.

Change-Id: Ibb75ce0cbc2b906838a5149dc75bfb27383178a7
2019-01-10 11:46:46 -05:00
Zuul
dbff6adcb7 Merge "Add definition for hw_time_hpet image property" 2019-01-09 04:19:05 +00:00
Zuul
4af32d0994 Merge "Update mailinglist from dev to discuss" 2018-12-18 05:40:56 +00:00
Lance Bragstad
c82ecc7463 Implement scaffolding for upgrade checks
One of the community goals for Stein is to implement a command-line
tool for operators that runs programmable checks that might impact
upgradability.

This commit lays down the basic structure for the upgrade checks and
ties it up to `glance-status` command.

Change-Id: I7fcf5235a76d15dbcb2c49255bc26c2b586cd71c
Story: 2003657
Task: 26135
2018-12-05 16:43:00 -05:00
ZhongShengping
1058ad0a2d Update mailinglist from dev to discuss
openstack-dev was decomissioned this night in https://review.openstack.org/621258
Update openstack-dev to openstack-discuss

Change-Id: I6b5a3489c3e09bc1413dbac174310339151df05b
2018-12-05 09:44:29 +08:00
Jack Ding
59a5994a18 Add definition for hw_time_hpet image property
Depends-On: https://review.openstack.org/605902
Change-Id: Ia7358ce658878d1341026af3dc1459f450557cac
Signed-off-by: Jack Ding <jack.ding@windriver.com>
2018-11-20 22:45:51 +00:00
imacdonn
2f498770e8 [doc] Fix options group for default_backend
Fix the option group in the example config snippet for the
default_backend option.

Change-Id: I484ebf0685fe0e9a5b06daf96728f71089673668
Closes-Bug: #1804075
2018-11-19 23:13:23 +00:00
Matt Riedemann
3f18940d80 Document os_shutdown_timeout image property
This adds an entry to the "Useful image properties" docs for
the os_shutdown_timeout property. The description is copied
from the metadata definition.

Change-Id: I96be4b908f929361c201a8369d2e140bf711c923
Closes-Bug: #1784953
2018-10-24 10:16:27 -04:00
Adam Spiers
2f402ff9ea fix "it's" typos
"it's" should only be used to mean "it is", not as a possessive.

https://en.oxforddictionaries.com/punctuation/apostrophe#it_s_or_its

Change-Id: Ie77348223477060d522a063ceae17e92f4dc26af
2018-10-04 17:26:24 +01:00
Zuul
070179948b Merge "Rename async package to async_" 2018-09-20 15:18:32 +00:00
Brian Rosmaita
7191c7ac05 Update Ubuntu install guide
The DB creation step for Ubuntu is slightly different from the
other distros.

Change-Id: Ib664da7ac647898f54ffb82bcadcbb6299bb5cc6
Closes-bug: #1784994
2018-08-22 10:01:34 -04:00
Brian Rosmaita
de6c36abaf Update "Release Notes" in contributor docs
Moves the Release Notes section to its own page to give it a higher
level heading to make it easier to find.  Also updates info about
the Glance team's policy about the "prelude" section.

Change-Id: I31351068124e0981519ccc2e33a7bdc16f8197fd
2018-08-09 17:38:56 -04:00
Zuul
e4ecf7c0ea Merge "Document hw_cpu_policy and hw_cpu_thread_policy image properties" 2018-08-08 20:01:05 +00:00