From 2acb22c16afce1d8f4c8db866acd3c34bd34b3dd Mon Sep 17 00:00:00 2001 From: Ramkumar Chinchani Date: Mon, 20 Sep 2021 17:13:43 +0000 Subject: [PATCH] doc: add documentation for comparison with well-known registries Add COMPARISON.md Signed-off-by: Ramkumar Chinchani --- COMPARISON.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 3 +++ 2 files changed, 53 insertions(+) create mode 100644 COMPARISON.md diff --git a/COMPARISON.md b/COMPARISON.md new file mode 100644 index 00000000..e9a2c02b --- /dev/null +++ b/COMPARISON.md @@ -0,0 +1,50 @@ +# Why zot? + +A comparison between various registries and their capabilities with respect to zot. + +Please see [documentation](./examples/README.md) for various configuration options. + +## [docker distribution](https://github.com/distribution/distribution) + +| | docker distribution | zot | +|---|---|---| +| **Last stable release** | v2.7.1 (Jan 17, 2019) | v1.3.0 (Sep 1, 2021) | +| **License** | Apache 2.0 | Apache 2.0 | +| **On-premise deployment** | yes | yes | +| **Minimal build*** | no | yes | +| **Storage Layout** | project-specific layout [1] | ociv1 image layout [2] | +| **Authentication** | auxiliary [3] | built-in | +| **Authorization** | auxiliary [3] | built-in | +| **Garbage collection** | requires server shutdown | inline | +| **Storage deduplication** | none | inline | +| **Cloud storage support** | yes | yes | +| **Delete by tag** | unsupported [4],[5] | yes | +| **Vulnerability scanning** | none | built-in | +| **cli** | yes | yes | +| **ui** | auxiliary [3],[4] | yes [8] | +| **External contributions** | yes | yes | +| **CNCF project** | yes [9] | no | + +* NOTE: "minimal build" criterion above means the ability to build a minimal +distribution-spec compliant registry in order to reduce library dependencies +and the possible attack surface. + +# References + +[1] https://github.com/distribution/distribution/tree/main/registry/storage + +[2] https://github.com/opencontainers/image-spec + +[3] https://github.com/cesanta/docker_auth + +[4] https://github.com/distribution/distribution/issues/3234 + +[5] https://github.com/distribution/distribution/issues/2747 + +[6] https://github.com/Joxit/docker-registry-ui + +[7] https://github.com/parabuzzle/craneoperator + +[8] https://github.com/anuvu/zot-ui + +[9] https://www.docker.com/blog/donating-docker-distribution-to-the-cncf/ diff --git a/README.md b/README.md index 7afa9dfa..d007c7e8 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,9 @@ https://anuvu.github.io/zot/ * ```go get -u github.com/anuvu/zot/cmd/zot``` +(**Why zot?**)[CONFORMANCE.md] + + # Presentations * [OCI Weekly Discussion - Oct 2, 2019](https://hackmd.io/El8Dd2xrTlCaCG59ns5cwg#October-2-2019)