|
| 1 | +--- |
| 2 | +title:Upgrade Docker images |
| 3 | +description: |
| 4 | +group:kb |
| 5 | +sub-group:articles |
| 6 | +toc:true |
| 7 | +kb:true |
| 8 | +ht:false |
| 9 | +common:false |
| 10 | +categories:[Pipelines] |
| 11 | +support-reviewed:2025-04-07 ZT |
| 12 | +--- |
| 13 | + |
| 14 | +This article describes how to upgrade deprecated Docker image formats and manifests to the latest supported versions. |
| 15 | + |
| 16 | +Docker issued a deprecation notice for older versions of images: |
| 17 | +{{site.data.callout.callout_tip}} |
| 18 | +**[DEPRECATION NOTICE]** Docker Image Format v1 and Docker Image manifest version 2, schema 1 support is disabled by default and will be removed in an upcoming release. Suggest the author of <image-name> to upgrade the image to the OCI Format or Docker Image manifest v2, schema 2. More information athttps://docs.docker.com/go/deprecated-image-specs/ |
| 19 | +{{site.data.callout.end}} |
| 20 | + |
| 21 | +If you see this deprecation notice in the logs of your pipeline builds, you must upgrade older versions of image formats and manifests to the new versions as required. |
| 22 | + |
| 23 | +For more information, see Docker's offical article on[Pushing and pulling with image manifest v2 schema 1](https://docs.docker.com/engine/deprecated/#pushing-and-pulling-with-image-manifest-v2-schema-1){:target="\_blank"}. |
| 24 | + |
| 25 | + |
| 26 | + |
| 27 | + |
| 28 | +##How to |
| 29 | + |
| 30 | +Upgrading the image manifest or formats is as simple as pulling the image via modern Docker and pushing it back to the registry. |
| 31 | + |
| 32 | +* Use the following step in your Codefresh pipelines: |
| 33 | + |
| 34 | +```yaml |
| 35 | +version:"1.0" |
| 36 | + |
| 37 | +steps: |
| 38 | +push: |
| 39 | +title:"Re-pushing deprecated image" |
| 40 | +type:push |
| 41 | +candidate:<source-image-name> |
| 42 | +registry:<desired-registry> |
| 43 | +tag:<target-image-tag> |
| 44 | +image_name:<target-image-name> |
| 45 | + |
| 46 | +# Example: |
| 47 | +# push: |
| 48 | +# title: "Re-pushing deprecated image" |
| 49 | +# type: push |
| 50 | +# candidate: docker/whalesay:latest |
| 51 | +# registry: docker |
| 52 | +# tag: new-manifest |
| 53 | +# image_name: codefresh/whalesay |
| 54 | +``` |
| 55 | + |