chore: Add warning about pull with digest (#182)

* Add warning about pull with digest * Update docs/articles/mirroring.md Co-authored-by: Andrei Aaron <[email protected]> --------- Co-authored-by: Andrei Aaron <[email protected]>
project-zot · Oct 18, 2024 · c24ef37 · c24ef37
1 parent e40a27f
commit c24ef37
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/docs/articles/mirroring.md b/docs/articles/mirroring.md
@@ -4,7 +4,7 @@
 
 A key use case for zot is to act as a mirror for upstream registries. If an upstream registry is OCI distribution-spec conformant for pulling images, you can use zot's `sync` feature to implement a downstream mirror, synchronizing OCI images and corresponding artifacts. Because synchronized images are stored in zot's local storage, registry mirroring allows for a fully distributed disconnected container image build pipeline. Container image operations terminate in local zot storage, which may reduce network latency and costs.
 
-> :warning: Because zot is a OCI-only registry, any upstream image stored in the Docker image format is converted to OCI format when downloading to zot. In the conversion, some non-OCI attributes may be lost. Signatures, for example, are removed due to the incompatibility between formats. 
+> :warning: Because zot is a OCI-only registry, any upstream image stored in the Docker image format is converted to OCI format when downloading to zot. In the conversion, some non-OCI attributes may be lost and the image digest will change. Pulling with <tag>@<digest> will not work as expected. Signatures, for example, are removed due to the mismatch between the old and the new digests. 
 
 ## Mirroring modes