Container Registry è deprecato. A partire dal 18 marzo 2025, Container Registry verrà chiuso e la scrittura di immagini in Container Registry non sarà più disponibile. Per ulteriori informazioni sul ritiro di Container Registry e su come eseguire la migrazione ad Artifact Registry, consulta Ritiro di Container Registry.
Il manifesto dell'immagine Docker V2 è una specifica per le immagini container che consente immagini multi-architettura e supporta le immagini indirizzabili in base ai contenuti.
Le immagini Docker V2 sostituiscono le immagini Docker V1, che sono
deprecate.
Elenchi manifest
Gli elenchi manifest fanno parte delle immagini Docker V2, schema 2 e OCI.
Gli elenchi manifest consentono a un singolo digest o tag di rappresentare più forme di un'immagine.
Formato OCI
Il formato OCI è una specifica per le immagini container basata sul formato Schema 2 della versione 2 del manifest dell'immagine Docker. Container Registry supporta il push e il pull delle immagini OCI.
Indici di immagini
Gli indici di immagini
sono l'equivalente degli elenchi manifest nelle immagini OCI.
Come gli elenchi manifest, un manifest dell'indice delle immagini fa riferimento a più manifest
delle immagini. Gli indici delle immagini sono utili per le immagini multipiattaforma.
Ritiro del formato dell'immagine Docker 1
A partire dal 28 febbraio 2017, la specifica del registry Docker V2 ha sostituito la specifica Docker V1. La specifica Docker 1 è deprecata e le immagini Docker 1 non possono essere utilizzate con Container Registry.
Docker V2 ha apportato una serie di modifiche al formato dell'immagine Docker per consentire le immagini indirizzabili in base ai contenuti e rimuovere la complessità del monitoraggio dei livelli dell'immagine.
I manifest delle immagini Docker V2 contengono tutti gli indirizzi dei contenuti ("digest") dei livelli dell'immagine, mentre le immagini Docker V1 no.
Eseguire l'upgrade delle immagini Docker V1 alle immagini Docker V2
Per eseguire l'upgrade delle immagini V1 alle immagini V2, assicurati che sia installata Docker 1.6 o versioni successive. Poi, esegui i seguenti comandi per eseguire il pull e il re-push delle immagini in Container Registry:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eContainer Registry supports Docker Image Manifest V2 (both Schema 1 and Schema 2) and Open Container Initiative (OCI) image formats for container images.\u003c/p\u003e\n"],["\u003cp\u003eDocker V2 images, which supersede the deprecated Docker V1 images, offer content-addressable images and multi-architecture support.\u003c/p\u003e\n"],["\u003cp\u003eManifest lists (for Docker V2) and image indexes (for OCI) allow a single tag or digest to represent multiple versions or platforms of an image.\u003c/p\u003e\n"],["\u003cp\u003eThe Docker V1 image format is deprecated and cannot be used with Container Registry, and all users must use Docker V2 or OCI compatible images.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from Docker V1 to Docker V2 images can be done by pulling existing V1 images with \u003ccode\u003edocker pull\u003c/code\u003e and then pushing them with \u003ccode\u003edocker push\u003c/code\u003e, if using a docker version higher than 1.6.\u003c/p\u003e\n"]]],[],null,["# Container image formats\n\nContainer Registry supports the following container image formats:\n\n- [Docker Image Manifest V2, Schema 1](https://docs.docker.com/registry/spec/manifest-v2-1/)\n- [Docker Image Manifest V2, Schema 2](https://docs.docker.com/registry/spec/manifest-v2-2/)\n- [Open Container Initiative (OCI) Specifications](https://github.com/opencontainers/image-spec)\n\nDocker V2\n---------\n\n[Docker V2 image manifest](https://docs.docker.com/registry/spec/manifest-v2-2/)\nis a specification for container images that allows\nmulti-architecture images and supports content-addressable images.\n\nDocker V2 images supersede Docker V1 images, which are\n[deprecated](/container-registry/docs/support/deprecation-notices#docker_registry_v1_api_and_docker_clients_below_version_16).\n\nManifest lists\n--------------\n\n[Manifest lists](https://docs.docker.com/registry/spec/manifest-v2-2/#manifest-list)\nare part of the Docker V2, Schema 2 and OCI images.\n\nManifest lists allow a single digest or tag to represent multiple forms of an\nimage.\n\nOCI format\n----------\n\nThe OCI format is a specification for container images based on the\nDocker Image Manifest Version 2, Schema 2 format. Container Registry\nsupports pushing and pulling OCI images.\n\nImage indexes\n-------------\n\n[Image indexes](https://github.com/opencontainers/image-spec/blob/28462ef6944123de00cf27e812309cbf5d82da71/image-index.md)\nare the equivalent of manifest lists in OCI images.\n\nLike manifest lists, an image index manifest refers to multiple image\nmanifests. Image indexes are useful for multi-platform images.\n\nDeprecation of Docker V1 image format\n-------------------------------------\n\nAs of February 28, 2017, the [Docker V2 registry\nspecification](https://docs.docker.com/registry/spec/api/)\nreplaced the Docker V1 specification. The Docker V1 specification is deprecated,\nand Docker V1 images cannot be used with Container Registry.\n\nDocker V2 made a set of changes to the Docker image format to allow for\ncontent-addressable images and to remove complexity in tracking image layers.\nDocker V2 image manifests contain all the content addresses (\"digests\") of the\nimage's layers, whereas Docker V1 images did not.\n\nFor more information, refer to\n[Deprecation Notices](/container-registry/docs/support/deprecation-notices).\n\n### Upgrading Docker V1 images to Docker V2 images\n\nTo upgrade your V1 images to V2 images, ensure that Docker v1.6 or higher is\ninstalled. Then, run the following commands to pull and then re-push the\nimages to Container Registry: \n\n docker pull gcr.io/[your-project-id]/[image]:[tag]\n docker push gcr.io/[your-project-id]/[image]:[tag]"]]
