Glance Install Guide & Config Ref Docs Need Updates/Enhancements
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Glance |
New
|
Undecided
|
Unassigned |
Bug Description
The Install Guide for Glance (Zed) is:
1) outdated; still using configuration fields "stores" and "default_store" in the [glance_store] config group
(which are deprecated - removed in Rocky) and does not show good examples of how to properly use the newer "enabled_backends" field under the [DEFAULT] config group. Unfortunately the Glance Configuration Reference also doesn't supply enough information on how to use the "enabled_backends" field. For example, what syntax is expected for the dictionary?, is the dictionary a string:string key value pair? What kinds of "type" "values" are acceptable and how are they used elsewhere (it says the key is used later in the "default_backend" field, but the value is never explained, or illustrated with a good example in the documents.
2) should be improved to explain what "MY_SERVICE", "MY_PASSWORD" and "ENTRYPOINT_ID" should be changed to in the [oslo_limit] config group values being assigned to the various config fields. I eventually figured these should be the "glance" user and user password set earlier but I'm still guessing really. And as far as the ENTRYPOINT_ID I figured it was the hash ID of the glance service. Again, another guess. And if so, why not use the glance service name? Those terms, MY_SERVICE etc etc are not explained/
Your second point is a duplicate of https:/ /bugs.launchpad .net/glance/ +bug/1990854 which I tried fixing by submitting https:/ /review. opendev. org/c/openstack /glance/ +/859359 . I could use a review :)
Regarding your first point, I'll need to dig deeper into this, but this sounds reasonable.