Ritiri di funzionalità

I seguenti avvisi di ritiro riguardano Container Registry. Vedi anche gli avvisi sul ritiro e il relativo log delle modifiche di Docker.

Nota: a partire dal 1° marzo 2017, Docker ha un ciclo di rilascio mensile che utilizza uno schema di controllo delle versioni annuale (YY.MM). In precedenza, Docker utilizzava uno schema di controllo delle versioni maggiore, secondario e patch (formattato come X.X.X); l'ultima release a utilizzare questo schema era la 1.13.1. Per ulteriori informazioni, consulta la nota di Docker relativa a questa modifica.

API Docker Registry v1 e client Docker precedenti alla versione 1.6

Il 14 dicembre 2016 abbiamo annunciato che, a partire dal 28 febbraio 2017, con il rilascio di Docker v1.13, Docker Engine non supporta più il protocollo v1.

Di conseguenza, Container Registry non supporta più i client Docker precedenti alla versione 1.6. Dopo il 28 febbraio 2017, i client Docker precedenti alla versione 1.6 non possono comunicare con l'API Container Registry e qualsiasi immagine container nel protocollo v1 archiviata in Container Registry non è più pubblicabile.

Per verificare se questa modifica interessa le tue immagini, procedi nel seguente modo:

1. Controlla quale versione del client Docker stai utilizzando eseguendo questo comando:

     gcloud docker -- --version
   

   Se la versione del tuo client è precedente alla 1.6, devi aggiornare il client Docker. Quindi, devi aggiornare le immagini al protocollo Docker Registry v2.

2. Esegui il pull di un'immagine v1 interessata:

     gcloud docker -- pull gcr.io/[PROJECT-ID]/[IMAGE]
   

3. Esegui di nuovo il push dell'immagine:

     gcloud docker -- push gcr.io/[PROJECT-ID]/[IMAGE]
   

Per ulteriori informazioni sui protocolli v1 e v2 di Docker Registry, consulta Formati delle immagini dei container.

Nota: se si verifica continuamente un errore come "L'API Registry v1 è disabilitata" quando esegui il pull o il push delle immagini, assicurati che nome host, ID progetto, nome immagine e tag o digest siano stati digitati correttamente. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi.

Bucket non standard di Container Registry

Il 28 febbraio 2017, l'uso dei registry "bring-your-own-bucket" come b.gcr.io e bucket.gcr.io è deprecato. Container Registry non pubblica più immagini container ospitate in questi bucket.

Per continuare a utilizzare le immagini, devi spostarle in una posizione standard di Container Registry come gcr.io, us.gcr.io, asia.gcr.io o eu.gcr.io.

Per eseguire la migrazione delle immagini container da un bucket non standard a uno standard, esegui questi passaggi:

1. Esegui il pull delle immagini dal bucket non standard:

   gcloud docker -- pull b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG]
   

2. Tagga di nuovo le immagini con un nome di percorso del Registro di sistema standard:

   gcloud docker -- tag b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG] [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
   

3. Esegui il push dell'immagine a Container Registry (utilizzando il client Docker versione 1.6 o successiva) utilizzando l'ID progetto di destinazione:

   gcloud docker -- push [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
   

Modifica dell'archiviazione dei metadati delle immagini container

Dal 28 febbraio 2017, Container Registry ha cambiato la posizione in cui archivia i file di metadati immagine del container. Per metadati immagine si intendono informazioni come nomi delle immagini, tag immagine e manifest delle immagini che identificano i file di livello (per digest) che compongono un'immagine.

Questa modifica potrebbe interessarti se accedi o gestisci direttamente i file di metadati nel bucket Cloud Storage, ad esempio la cronologia delle modifiche o la gestione del ciclo di vita degli oggetti per l'eliminazione.

In precedenza, quando eseguivi il push di un'immagine in Container Registry, l'API Container Registry archiviava i metadati e i file di livello per queste immagini in un bucket Cloud Storage nel tuo progetto. A partire dal 28 febbraio 2017, Container Registry archivia i metadati delle immagini in un database di backend ad alte prestazioni per migliorare le prestazioni e la funzionalità. I file del livello immagine sono ancora archiviati in Cloud Storage.

Al progetto è stato aggiunto automaticamente un account di servizio Container Registry con un nome simile a [PROJECT-NUMBER]@containerregistry.iam.gserviceaccount.com. Questo account di servizio ha attivato la nuova API Container Registry e gestito la migrazione. Non eliminare o eseguire il downgrade di questo account di servizio e non disattivare la nuova API Container Registry.

Nota: se elimini o esegui il downgrade dell'account di servizio di migrazione, puoi ricrearlo riattivando l'API Container Registry nel menu API e servizi della console Cloud.

il comando gcloud docker e client Docker precedenti alla versione 18.03

A partire dal 3 aprile 2018, gcloud docker non è supportato per le versioni client Docker successive alla 18.03.

Per autenticare le richieste a Container Registry per le versioni client successive alla 18.03, utilizza gcloud come helper per le credenziali Docker. Per farlo, esegui questo comando:

gcloud auth configure-docker

In alternativa, utilizza uno degli altri metodi di autenticazione avanzati.

Avviso: devi utilizzare un helper per le credenziali Docker (ovvero docker-credential-gcr o docker-credential-gcloud tramite gcloud auth configure-docker) solo per la versione 18.03 o successive. Un bug nelle versioni precedenti del client Docker rallenta docker build drasticamente quando vengono configurati helper delle credenziali.