search

opencontainers / distribution-spec

OCI Distribution Specification
https://opencontainers.org
Apache License 2.0
823 stars 202 forks source link

Tag pagination #470

Closed sudo-bmitch closed 4 months ago

sudo-bmitch commented 1 year ago

~Registries must still support the n=100 and last query parameters. Clients may use the Link header. When registries cannot return all requested tags, an error must be returned.~

This adds support for the Link header, and prefers it when available. Registries returning the Link header may return fewer than the requested number of tags per request.

Fixes #461.

sudo-bmitch commented 10 months ago

There is a proposal to replace this with #496.

haampie commented 6 months ago

Why is this not merged after so many months? It's pretty obvious the current spec is broken and should be fixed.

sudo-bmitch commented 6 months ago

Documenting the community decision made today:

We are making a breaking change to clients that followed the spec to document the majority of real world implementations. There are three different groups of clients to consider:

The community felt that the second group was larger than the first, and did not want to break those users even if it meant the first group would be silently broken.