From a3c027e626f4e4f4c76f06153a49dc2f1d5070cc Mon Sep 17 00:00:00 2001 From: Adrian Plata Date: Tue, 3 Sep 2019 11:44:28 -0700 Subject: [PATCH] Adding deprecated schema instructions Signed-off-by: Adrian Plata (cherry picked from commit 07a50201c959912907af2162a8f7cc284856c009) Signed-off-by: Derek McGowan --- docs/spec/deprecated-schema-v1.md | 41 +++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/spec/deprecated-schema-v1.md diff --git a/docs/spec/deprecated-schema-v1.md b/docs/spec/deprecated-schema-v1.md new file mode 100644 index 0000000000..66ff5c215e --- /dev/null +++ b/docs/spec/deprecated-schema-v1.md @@ -0,0 +1,41 @@ +--- +title: Update deprecated schema image manifest version 2, v1 images +description: Update deprecated schema v1 iamges +keywords: registry, on-prem, images, tags, repository, distribution, api, advanced, manifest +--- + +## Image manifest version 2, schema 1 +With the release of image manifest version 2, schema 2, image manifest version +2, schema 1 has been deprecated. This could lead to compatibility and +vulnerability issues in images that haven't been updated to image manifest +version 2, schema 2. + +This page contains information on how to update from image manifest version 2, +schema 1. However, these instructions will not ensure your new image will run +successfully. There may be several other issues to troubleshoot that are +associated with the deprecated image manifest that will block your image from +running succesfully. A list of possible methods to help update your image is +also included below. + +### Update to image manifest version 2, schema 2 + +One way to upgrade an image from image manifest version 2, schema 1 to +schema 2 is to `docker pull` the image and then `docker push` the image with a +current version of Docker. Doing so will automatically convert the image to use +the latest image manifest specification. + +Converting an image to image manifest version 2, schema 2 converts the +manifest format, but does not update the contents within the image. Images +using manifest version 2, schema 1 may contain unpatched vulnerabilities. We +recommend looking for an alternative image or rebuilding it. + + +### Update FROM statement + +You can rebuild the image by updating the `FROM` statement in your +`Dockerfile`. If your image manifest is out-of-date, there is a chance the +image pulled from your `FROM` statement in your `Dockerfile` is also +out-of-date. See the [Dockerfile reference](https://docs.docker.com/engine/reference/builder/#from) +and the [Dockerfile best practices guide](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/) +for more information on how to update the `FROM` statement in your +`Dockerfile`.