From d9fbaa0e3df55403a9820caf029b066a4adf621b Mon Sep 17 00:00:00 2001 From: mbshields Date: Fri, 15 Nov 2024 14:43:56 -0800 Subject: [PATCH] docs: added config for docker2s2, plus What's New for v2.1.2 Signed-off-by: mbshields --- docs/admin-guide/admin-configuration.md | 18 ++++++++++++++++++ docs/general/whats-new.md | 6 ++++++ 2 files changed, 24 insertions(+) diff --git a/docs/admin-guide/admin-configuration.md b/docs/admin-guide/admin-configuration.md index e1002433..02836955 100644 --- a/docs/admin-guide/admin-configuration.md +++ b/docs/admin-guide/admin-configuration.md @@ -18,6 +18,7 @@ The configuration file is a JSON or YAML file that contains all configuration se - logging - metrics - synchronization with other registries +- - clustering The zot service is initiated with the `zot serve` command followed by the name of a configuration file, as in this example: @@ -379,6 +380,23 @@ The following table lists the configurable attributes of the `lint` extension. If the mandatory annotations option is configured when you push an image, linter will verify that the mandatory annotations list present in the configuration is also found in the manifest's annotations list. If any annotations are missing, the push is denied. + + +## Compatibility with other image schema types + +As an option, zot can be configured to store images using the schema [Docker Manifest v2 Schema v2](https://distribution.github.io/distribution/spec/manifest-v2-2/). In this case, a Docker image can be copied to zot without modifications to the image's manifest or digest. Such modifications would otherwise break the image's signature and attestations. + +To enable this compatibility, configure the `compat` attribute under `http` in the zot configuration file. Set the `compat` value to `docker2s2` as shown in the following example: + +```json +"http": { + "address": "127.0.0.1", + "port": "8080", + "compat": ["docker2s2"] +} +``` + + ## Verifying the signatures of uploaded images diff --git a/docs/general/whats-new.md b/docs/general/whats-new.md index bac7c605..27228dc1 100644 --- a/docs/general/whats-new.md +++ b/docs/general/whats-new.md @@ -1,5 +1,11 @@ # What's New +## [v2.1.2](https://github.com/project-zot/zot/releases/tag/v2.1.2) + +### Compatibility with other image schema types + +A new configuration setting allows you to store images using the schema [Docker Manifest v2 Schema v2](https://distribution.github.io/distribution/spec/manifest-v2-2/). With this setting enabled, zot makes no modifications to the image's manifest or digest. Such modifications would otherwise break the image's signature and attestations. + ## [v2.1.0](https://github.com/project-zot/zot/releases/tag/v2.1.0) ### Scale-out cluster