Glance Install Guide & Config Ref Docs Need Updates/Enhancements

[Larry Simon]

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/referenced anywhere else in the Glance install document (really confusing since they appear out of nowhere). They look to be simply copy pasted from some of the oslo documentation found elsewhere I think.

[Cyril Roelandt (cyril-roelandt)]

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.

[Sean Haynes (sarhaynes)]

I had the same issue when attempting to install zed. I have an updated configuration that I can provide.