diff --git a/specs/stein/approved/glance/spec-lite-readding-glance-cache-manage-for-v2.rst b/specs/stein/approved/glance/spec-lite-readding-glance-cache-manage-for-v2.rst new file mode 100644 index 00000000..2e5ae5aa --- /dev/null +++ b/specs/stein/approved/glance/spec-lite-readding-glance-cache-manage-for-v2.rst @@ -0,0 +1,65 @@ +.. + This work is licensed under a Creative Commons Attribution 3.0 Unported + License. + + http://creativecommons.org/licenses/by/3.0/legalcode + +======================================================= +Spec Lite: Add glance-cache-manage utility using v2 API +======================================================= + +:project: glance + +:problem: In Rocky, the v1 dependant glance-cache-manage command was removed + while removing Images API v1 entry points. As a part of Edge + computing glance cache needs to be enabled on far-edge nodes + via Split Control plane where glance-cache-manage utility will be + essential to queue image for prefetching, to list & delete images + from Image Cache. + +:solution: In Stein, as per Edge computing architecture, glance cache will be + enabled on far-edge nodes. Hence it will be good to add + glance-cache-manage utility using v2 API in glance. This utility + will have the following commands and the same interface as Queens + glance-cache-manage utility [0] insofar as possible, + [0] https://docs.openstack.org/glance/queens/cli/glancecachemanage.html :: + + 1. Queue the image with identifier for caching, + + $ glance-cache-manage --host= queue-image + + 2. List all images currently cached + + $ glance-cache-manage --host= list-cached + + 3. List all images currently queued for caching. + + $ glance-cache-manage --host= list-queued + + 4. Delete an image from the cache + + $ glance-cache-manage --host= delete-cached-image + + 5. Remove all images from the cache + + $ glance-cache-manage --host= delete-all-cached-images + + 6. Deletes an queued image from the cache + + $ glance-cache-manage --host= delete-queued-image + + 7. Remove all images from the cache queue + + $ glance-cache-manage --host= delete-all-queued-images + + + +:alternatives: None + +:impacts: DocImpact + +:timeline: Include in Stein release. + +:link: None + +:assignee: pdeore