Container image virtual registry: manage APIs (registries and upstreams)
🗒️ Problem statement
In virtual registries, we usually have two set of APIs:
- APIs to manage the virtual registry objects. This issue deals with this part.
- APIs for the clients,
$ docker
, so that they can pull files through the virtual registry.
NOTE:
- Cache entries API endpoints are in #569403 (closed)
- Registry upstreams API endpoints are in #573284
1️⃣ Registries
Route | Notes |
---|---|
GET /groups/:id/-/virtual_registries/containers/registries | List virtual registries for the given top level group |
POST /groups/:id/-/virtual_registries/containers/registries | Create a new virtual registry |
GET /virtual_registries/containers/registries/:id | Get the details of the virtual registry |
PATCH /virtual_registries/containers/registries/:id | Update a virtual registry |
DELETE /virtual_registries/containers/registries/:id | Delete a virtual registry |
2️⃣ Upstreams
Route | Notes |
---|---|
GET /virtual_registries/containers/registries/:id/upstreams | Get the upstreams of a given registry |
POST /virtual_registries/containers/registries/:id/upstreams | Create an upstream for a given registry |
GET /virtual_registries/containers/upstreams/:id | Get the upstream details |
PATCH /virtual_registries/containers/upstreams/:id | Update the upstream details |
DELETE /virtual_registries/containers/upstreams/:id | Delete an upstream |
🔮 Other considerations
Use a feature flag
🛠️ Implementation plan
- Container image virtual registry: database models (#548783 - closed) • Adie (she/her), Radamanthus Batnag • 18.5 • Needs attention
- Container image virtual registry: cache entry s... (#549103 - closed) • Radamanthus Batnag • 18.5 • On track
- Container image virtual registry: upstream serv... (#549104 - closed) • Adie (she/her) • 18.4
- Container image virtual registry: handle file r... (#549134) • Adie (she/her) • 18.6
-
Container image virtual registry: manage APIs (... (#548794 - closed) • Adie (she/her) • 18.5 • On track
👈 - Container image virtual registry: endpoints API (#549131) • Radamanthus Batnag • Backlog
- Container image virtual registry: performance r... (#549136) • Unassigned • Backlog
- Container image virtual registry: documentation (#549138) • Unassigned • Backlog
- Container image virtual registry: additional fe... (#549470) • Unassigned • Backlog
Edited by Adie (she/her)