opencontainers / distribution-spec

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

Add "subject processed" response header #377

Closed imjasonh closed 1 year ago

imjasonh commented 1 year ago

One question we've circled around is how a client can know that a manifest it pushed containing a subject field was processed by the registry, to know whether the client should push an index to the subject's fallback tag.

One solution would be for the registry to respond to a POST of a manifest with subject with a response header indicating that it's 1.1-compliant and is going to update the referrers response for you.

Something like X-OCI-Subject-Processed -- better names welcome.

Related: https://github.com/opencontainers/distribution-spec/blob/main/spec.md#unavailable-referrers-api

edit: This was @jonjohnsonjr 's idea