diff --git a/content/registry.md b/content/registry.md index 96624db48de..f66b2bb4a40 100644 --- a/content/registry.md +++ b/content/registry.md @@ -1,7 +1,7 @@ --- title: Registry -description: Registry documentation has moved -keywords: registry, distribution +description: The Docker Hub registry implementation +keywords: registry, distribution, docker hub, spec, schema, api, manifest, auth aliases: - /registry/compatibility/ - /registry/deploying/ @@ -41,29 +41,46 @@ aliases: Registry, the open source implementation for storing and distributing container images and other content, has been donated to the CNCF. Registry now goes under the name of Distribution, and the documentation has moved to -[distribution.github.io/distribution][docs]. +[distribution/distribution]. -For reference documentation on the API protocol that Distribution implements, -see [Registry HTTP API][api]. +The Docker Hub registry implementation is based on Distribution. Docker Hub +implements version 1.0.1 OCI distribution [specification]. For reference +documentation on the API protocol that Docker Hub implements, refer to the OCI +distribution specification. -For documentation related to authentication, see: +## Supported media types + +Docker Hub supports the following image manifest formats for pulling images: + +- [OCI image manifest] +- [Docker image manifest version 2, schema 2] +- Docker image manifest version 2, schema 1 +- Docker image manifest version 1 + +You can push images with the following formats: + +- [OCI image manifest] +- [Docker image manifest version 2, schema 2] + +Docker Hub also supports OCI artifacts. See [OCI artifacts]. + +## Authentication + +For documentation related to authentication to the Docker Hub registry, see: - [Token authentication specification][token] - [OAuth 2.0 token authentication][oauth2] - [JWT authentication][jwt] - [Token scope and access][scope] -For information about image manifests, see: - -- [Image Manifest Version 2, Schema 2][schema2] -- [Image Manifest Version 2, Schema 1][schema1] (deprecated) + -[spec]: https://github.com/opencontainers/distribution-spec -[docs]: https://distribution.github.io/distribution/ -[api]: https://distribution.github.io/distribution/spec/api/ +[distribution/distribution]: https://distribution.github.io/distribution/ +[specification]: https://github.com/opencontainers/distribution-spec/blob/v1.0.1/spec.md +[OCI image manifest]: https://github.com/opencontainers/image-spec/blob/main/manifest.md +[Docker image manifest version 2, schema 2]: https://distribution.github.io/distribution/spec/manifest-v2-2/ +[OCI artifacts]: /docker-hub/oci-artifacts/ [oauth2]: https://distribution.github.io/distribution/spec/auth/oauth/ [jwt]: https://distribution.github.io/distribution/spec/auth/jwt/ [token]: https://distribution.github.io/distribution/spec/auth/token/ [scope]: https://distribution.github.io/distribution/spec/auth/scope/ -[schema2]: https://distribution.github.io/distribution/spec/manifest-v2-2/ -[schema1]: https://distribution.github.io/distribution/spec/deprecated-schema-v1/ diff --git a/data/toc.yaml b/data/toc.yaml index 6cb91a03dd0..7271321527c 100644 --- a/data/toc.yaml +++ b/data/toc.yaml @@ -1989,6 +1989,8 @@ Manuals: title: Vulnerability scanning - path: /docker-hub/image-management/ title: Advanced Image Management + - path: /registry/ + title: Registry - path: /docker-hub/oci-artifacts/ title: OCI artifacts - path: /docker-hub/release-notes/