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 (closed)
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 - closed) • Adie (she/her) • 18.6
-
Container image virtual registry: manage APIs (... (#548794 - closed) • Adie (she/her) • 18.5 • On track
👈 - Container image virtual registry: push/pull end... (#549131) • Radamanthus Batnag • 18.6
- Container image virtual registry: performance r... (#549136) • Unassigned • Backlog
- Container image virtual registry: documentation... (#549138 - closed) • Adie (she/her) • 18.6
- Container image virtual registry: additional fe... (#549470) • Unassigned • Backlog
Edited by Adie (she/her)