Container image virtual registry: manage APIs (registries and upstreams)

🗒️ Problem statement

In virtual registries, we usually have two set of APIs:

  1. APIs to manage the virtual registry objects. This issue deals with this part.
  2. 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 - closed) • Radamanthus Batnag • 18.8 • At risk
  • 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 Oct 01, 2025 by Adie (she/her)
Assignee Loading
Time tracking Loading