[release/2.7] Adding deprecated schema v1 page#2987
[release/2.7] Adding deprecated schema v1 page#2987dmcgowan merged 1 commit intodistribution:release/2.7from
Conversation
|
Please sign your commits following these rules: $ git clone -b "release/2.7" git@github.com:adrian-plata/distribution.git somewhere
$ cd somewhere
$ git rebase -i HEAD~842359065760
editor opens
change each 'pick' to 'edit'
save the file and quit
$ git commit --amend -s --no-edit
$ git rebase --continue # and repeat the amend for each commit
$ git push -fAmending updates the existing PR. You DO NOT need to open a new one. |
c1f24af to
a14a0fd
Compare
|
@thaJeztah, @andrewhsu, and @tonistiigi PTAL. Are there any additional things to add to this list? |
a14a0fd to
d6f6a34
Compare
| --- | ||
|
|
||
| Updating an image manifest from schema 1 to schema 2 is done by downloading an | ||
| image, applying schema v2, and then uploading the new image. However, this will |
There was a problem hiding this comment.
I would mention that it can be done by downloading the manifest, converting to schema 2, then uploading. Or simply by doing a docker pull then docker push.
There was a problem hiding this comment.
something like "Updating an image manifest from schema 1 to schema 2 is done by downloading the manifest, convert it from schema 1 to schema 2, and then uploading it.
You can also run docker pull and then docker push. This will update the
image to schema 2. "?
There was a problem hiding this comment.
Having a practical example of how to do this would be good yes. Something like;
The easiest way to upgrade an image from image manifest version 2, schema 1 to image manifest version 2, schema 2 is to
docker pullthe image, anddocker pushthe image with a current version of Docker. Doing so will automatically convert the image to use the latest specification.
We may want to add a note/warning that that doesn't upgrade outdated images (which may container vulnerabilities). Something along the lines of;
Note: converting an image to image manifest version 2, schema 2 converts the manifest
format, but does not update the contents of the image itself. Images using manifest version 2, schema 1
are likely created a long time ago and may contain unpatched vulnerabilities.
We recommend looking for an alternative image or, if this is an image you maintain, rebuilding the image.
To update an image, and patch vulnerabilities, the image has to be re-built using an up-to-date base
image. Refer to the update FROM statement section below for more details.
thaJeztah
left a comment
There was a problem hiding this comment.
Left some thoughts/suggestions
| @@ -0,0 +1,19 @@ | |||
| --- | |||
| title: Update deprecated schema v1 images | |||
There was a problem hiding this comment.
Should we make this Update deprecated image manifest version 2, schema 1 images to schema 2 ?
| keywords: registry, on-prem, images, tags, repository, distribution, api, advanced, manifest | ||
| --- | ||
|
|
||
| Updating an image manifest from schema 1 to schema 2 is done by downloading an |
There was a problem hiding this comment.
I feel there's something missing on this page (some introduction sentence explaining that image manifest v2, schema 1 is deprecated.
@dmcgowan should there be a deprecation note on https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-1.md ?
| --- | ||
|
|
||
| Updating an image manifest from schema 1 to schema 2 is done by downloading an | ||
| image, applying schema v2, and then uploading the new image. However, this will |
There was a problem hiding this comment.
Having a practical example of how to do this would be good yes. Something like;
The easiest way to upgrade an image from image manifest version 2, schema 1 to image manifest version 2, schema 2 is to
docker pullthe image, anddocker pushthe image with a current version of Docker. Doing so will automatically convert the image to use the latest specification.
We may want to add a note/warning that that doesn't upgrade outdated images (which may container vulnerabilities). Something along the lines of;
Note: converting an image to image manifest version 2, schema 2 converts the manifest
format, but does not update the contents of the image itself. Images using manifest version 2, schema 1
are likely created a long time ago and may contain unpatched vulnerabilities.
We recommend looking for an alternative image or, if this is an image you maintain, rebuilding the image.
To update an image, and patch vulnerabilities, the image has to be re-built using an up-to-date base
image. Refer to the update FROM statement section below for more details.
7378474 to
8bef549
Compare
8bef549 to
e338c06
Compare
e338c06 to
a8fe6b7
Compare
Signed-off-by: Adrian Plata <adrian.plata@docker.com> (cherry picked from commit 07a5020) Signed-off-by: Derek McGowan <derek@mcgstyle.net>
a8fe6b7 to
a3c027e
Compare
|
vndr and static checking need to be fixed, can be done separately |
|
For use in moby/moby#39736 |
No description provided.