Transizione da Container Registry

Container Registry è deprecato. A partire dal 18 marzo 2025, Container Registry è stato chiuso e la scrittura di immagini in Container Registry non è disponibile.

Gli URL gcr.io ospitati su Artifact Registry, incluse le immagini di proprietà di Google con URL gcr.io, non sono interessati dalla chiusura di Container Registry.

Per ulteriori dettagli sul ritiro di Container Registry e su come eseguire la migrazione ad Artifact Registry, consulta Ritiro di Container Registry.

Artifact Registry è il servizio consigliato per l'archiviazione e la gestione delle immagini container su Google Cloud. Artifact Registry offre le stesse funzionalità di gestione dei container di Container Registry e include funzionalità e vantaggi aggiuntivi. In quanto servizio completamente gestito con supporto sia per le immagini container sia per gli artefatti non container, Artifact Registry estende le funzionalità di Container Registry.

Puoi eseguire la migrazione degli endpoint Container Registry ai repository Artifact Registry gcr.io senza richiedere tempi di inattività o interruzioni del servizio utilizzando lo strumento di migrazione automatica.

Riepilogo delle nuove funzionalità

Artifact Registry estende le funzionalità di Container Registry con le seguenti funzionalità:

Per ulteriori dettagli su queste funzionalità, consulta il confronto delle funzionalità.

Immagini Container Registry esistenti gestite da Google

La maggior parte delle immagini di proprietà di Google precedentemente ospitate su Container Registry ora sono ospitate su Artifact Registry nei repository gcr.io. Non devi modificare gli URL per recuperare queste immagini. Ad esempio, puoi comunque utilizzare le immagini builder ufficiali di Cloud Build.

Immagini Docker Hub memorizzate nella cache su mirror.gcr.io

Artifact Registry memorizza nella cache le immagini Docker Hub pubbliche a cui viene eseguito l'accesso con frequenza su mirror.gcr.io. Per ulteriori informazioni sull'utilizzo di mirror.gcr.io, consulta Pull delle immagini Docker Hub memorizzate nella cache.

Scegliere un'opzione di transizione

Esistono due tipi di repository che puoi utilizzare per la transizione ad Artifact Registry:

Repository gcr.io in Artifact Registry

Repository mappati ai nomi host gcr.io di Container Registry. Artifact Registry reindirizza le richieste gcr.io per i tuoi host Container Registry ai repository Artifact Registry corrispondenti nello stesso progetto Google Cloud .

Utilizza i repository gcr.io se:

  • Vuoi ridurre al minimo la quantità di configurazione richiesta per trasferire le immagini e l'automazione esistenti ad Artifact Registry.
  • Non è necessario configurare i repository Artifact Registry in un altro progetto o regioneGoogle Cloud .
Repository pkg.dev in Artifact Registry

pkg.dev Repository Artifact Registry che supportano tutte le funzionalità e sono completamente indipendenti da qualsiasi host Container Registry esistente.

Utilizza i repository pkg.dev se:

  • Devi rispettare i requisiti di conformità per archiviare i dati in una regione specifica. I repository con supporto del dominio gcr.io sono disponibili solo nelle stesse multiregioni degli host Container Registry: asia, eu e us.
  • Vuoi configurare i repository Artifact Registry in un progetto diverso da quello in cui utilizzi Container Registry.
  • Vuoi riprogettare il modo e il luogo in cui memorizzi le immagini. Ad esempio:

    • Crea repository nelle stesse regioni delle altre risorse regionali, inclusi runtime come Cloud Run e Google Kubernetes Engine. Google Cloud
    • Configura i repository nelle regioni più vicine ai tuoi team. Ad esempio, puoi creare repository nelle regioni australiane anziché nella multi-regione asia o nelle regioni sudamericane anziché nella multi-regione us.
    • Crea più repository Docker nello stesso progetto e nella stessa località con diverse policy Identity and Access Management. Ad esempio, puoi configurare un repository di sviluppo e un repository di produzione nella regione us-east1 con livelli di accesso diversi per gli sviluppatori.
  • Vuoi creare repository virtuali che fungano da unico endpoint per i download da più repository in modalità standard pkg.dev upstream.

  • Vuoi utilizzare repository remoti come proxy per origini esterne.

I repository standard, remoti, virtuali pkg.dev e gcr.io possono coesistere. Ad esempio, puoi creare gcr.io repository in Artifact Registry per eseguire la transizione della configurazione di Container Registry esistente e creare pkg.dev repository per il nuovo lavoro.

Utilizzare i nostri strumenti di transizione

Utilizza i seguenti strumenti per identificare i progetti che utilizzano Container Registry, copia le immagini da Container Registry ad Artifact Registry ed esegui automaticamente la migrazione di più progetti da Container Registry ad Artifact Registry.

  • Controlla l'utilizzo di Container Registry.
  • Utilizza il nostro strumento di migrazione automatico per eseguire la migrazione dei progetti da Container Registry ad Artifact Registry, copiare le immagini e selezionare il tipo di repository di transizione che preferisci.
  • Copia le immagini da Container Registry ad Artifact Registry utilizzando lo strumento di migrazione automatica, gcrane, Docker o gcloud CLI.

Confronto delle funzioni

La seguente tabella riepiloga le differenze tra Container Registry e Artifact Registry.

Funzionalità Container Registry Artifact Registry
Formati supportati Solo immagini container Più formati di artefatti, tra cui immagini container, pacchetti di linguaggio e pacchetti di sistemi operativi.
Nome di dominio gcr.io pkg.dev

Artifact Registry può anche archiviare immagini per il dominio gcr.io se configuri i repository gcr.io.

Modalità del repository Non applicabile
  • Standard: archivia gli artefatti.
  • Remoto: memorizza nella cache gli artefatti richiesti da un'origine upstream come Docker Hub.
  • Virtuale: un singolo endpoint per più repository upstream.
Creazione del registro Per creare un host del registro, devi eseguire il push della prima immagine.

Container Registry archivia le immagini nei bucket Cloud Storage del tuo progetto Google Cloud e le azioni come la concessione di autorizzazioni specifiche del registro devono essere applicate direttamente a un bucket.

La creazione di un repository è un'operazione separata dal push e dal pull per separare chiaramente l'amministrazione del repository dal suo utilizzo.
  • Per la compatibilità con le versioni precedenti, puoi configurare repository gcr.io. La configurazione iniziale include la creazione automatica di repository Artifact Registry per ogni host Container Registry nel tuo progetto e il reindirizzamento di gcr.io ai repository Artifact Registry corrispondenti.
  • Per tutte le richieste push e pull al dominio pkg.dev, il repository deve già esistere.

In Artifact Registry non ci sono bucket Cloud Storage da gestire nei tuoi progetti Google Cloud . Esegui azioni di gestione delle immagini direttamente su un repository.

Sede del registro In un progetto Google Cloud sono disponibili solo quattro host di registri multiregionali. Crea più repository controllati separatamente nella regione o in più regioni.
Controllo dell'accesso
  • Concedi l'accesso utilizzando i ruoli Cloud Storage.
  • Puoi limitare l'accesso a tutte le immagini archiviate in una multiregione, ma non ai singoli repository. Ad esempio, puoi limitare l'accesso a us.gcr.io nel progetto my-project, ma non puoi concedere autorizzazioni specifiche per le immagini in us.gcr.io/my-project/team1 e us.gcr.io/my-project/team2
  • Concedi l'accesso utilizzando i ruoli di Artifact Registry.
  • Puoi limitare l'accesso a singoli repository. Ad esempio, puoi controllare separatamente l'accesso alle immagini in us-docker.pkg.dev/my-project/team1 e us-docker.pkg.dev/my-project/team2.
  • Concedi l'accesso condizionale con IAM e i tag del repository
Autenticazione Fornisce diversi metodi di autenticazione per il push e il pull delle immagini con un client di terze parti. Artifact Registry supporta gli stessi metodi di autenticazione di Container Registry. Per ulteriori dettagli, consulta Configurazione dell'autenticazione per Docker.
Chiavi di crittografia gestite dal cliente (CMEK) Utilizza CMEK per criptare i bucket di archiviazione che contengono le tue immagini. Utilizza CMEK per criptare singoli repository.
Utilizzo della console Google Cloud Visualizza e gestisci le immagini di Container Registry dalla sezione Container Registry della console Google Cloud . Visualizza un elenco dei repository Artifact Registry e Container Registry nella sezione Artifact Registry della console Google Cloud . Gestisci i repository e le immagini di Artifact Registry da questa pagina.

Se fai clic su un repository Container Registry, viene visualizzato l'elenco delle immagini nella sezione Container Registry della console Google Cloud .

Utilizzo dei comandi gcloud CLI e API Utilizza i comandi gcloud container images. I comandi supportano i riepiloghi abbreviati. Se non specifichi la stringa di digest completa, Container Registry tenta di individuare l'immagine corretta in base alla stringa parziale.

Non esiste un'API REST o RPC per Container Registry.

Utilizza i comandi gcloud artifacts docker. I comandi non supportano i riepiloghi abbreviati.

Per un confronto tra i comandi gcloud CLI di Container Registry e Artifact Registry, consulta il confronto tra i comandi gcloud CLI.

Artifact Registry fornisce un'API REST e RPC per la gestione di repository e artefatti.

Notifiche Pub/Sub Pubblica le modifiche all'argomento gcr. Pubblica le modifiche all'argomento gcr. Se crei repository nello stesso progetto del servizio Container Registry esistente, la configurazione Pub/Sub esistente funziona automaticamente.

Per saperne di più, consulta Configurazione delle notifiche Pub/Sub.

Audit logging Container Registry non fornisce audit log per l'attività del registro. Utilizza Cloud Logging per monitorare le modifiche ai repository.
Immagini Docker Hub memorizzate nella cache mirror.gcr.io è una cache pull-through che archivia le immagini Docker Hub richieste più di frequente da tutti gli utenti. mirror.gcr.io ora è ospitato su Artifact Registry. mirror.gcr.io ora è ospitato su Artifact Registry. Non è richiesta alcuna azione, a meno che tu non stia utilizzando mirror.gcr.io in un perimetro di Controlli di servizio VPC. Per ulteriori informazioni sull'utilizzo di mirror.gcr.io in un perimetro dei Controlli di servizio VPC, consulta Utilizzare Artifact Registry con i Controlli di servizio VPC.
Controlli di servizio VPC Puoi aggiungere Container Registry a un perimetro di servizio. Puoi aggiungere Artifact Registry a un perimetro di servizio.
Archiviazione e analisi dei metadati con Artifact Analysis Esegue la scansione delle vulnerabilità del sistema operativo e dei pacchetti di linguaggio con l'analisi on demand nelle immagini con un sistema operativo supportato. La scansione automatica restituisce solo informazioni sulle vulnerabilità del sistema operativo. Scopri di più sui tipi di scansione.
Scansione on demand
Scansione automatica
  • Il comando Google Cloud CLI gcloud container images include flag per visualizzare i risultati della scansione, incluse le vulnerabilità e altri metadati.
  • Le scansioni restituiscono solo informazioni sulle vulnerabilità del sistema operativo per le immagini in Container Registry con sistemi operativi supportati.
Esegue la scansione delle vulnerabilità del sistema operativo e dei pacchetti di linguaggio con scansione on demand e automatica. Scopri di più sui tipi di scansione.
Scansione on demand
Scansione automatica
  • Il comando Google Cloud CLI gcloud artifacts docker images include flag per visualizzare i risultati della scansione, incluse vulnerabilità e altri metadati.
  • Le scansioni restituiscono informazioni sulle vulnerabilità del sistema operativo per le immagini in Artifact Registry con sistemi operativi supportati e informazioni sulle vulnerabilità dei pacchetti di linguaggio per i sistemi operativi supportati e non supportati.
Streaming di immagini Non disponibile Trasmetti in streaming le immagini in Artifact Registry a GKE o Google Cloud Serverless per Apache Spark per una scalabilità automatica più rapida, un avvio più rapido dei pod e una latenza ridotta durante il pull di immagini di grandi dimensioni.
Deployment dell'origine Cloud Run Non disponibile Il deployment dell'origine ti consente di utilizzare un singolo comando gcloud CLI per creare un'immagine container dal codice sorgente, archiviarla in Artifact Registry ed eseguirne il deployment su Cloud Run.
Prezzi I prezzi di Container Registry si basano sull'utilizzo di Cloud Storage, inclusi il trasferimento di dati di archiviazione e di rete. Poiché gli host del registro sono disponibili solo in più regioni, i costi di trasferimento dei dati includono il deployment delle immagini in Google Cloud Artifact Registry ha i propri prezzi, basati sull'archiviazione e sul trasferimento di dati di rete.
Quota Container Registry ha limiti di richieste fissi. Si applicano anche le quote di Cloud Storage. Per maggiori dettagli, consulta la documentazione relativa a quote e limiti. Artifact Registry ha quote per progetto e per utente. Per impostazione predefinita, la quota per utente è illimitata, ma puoi configurare un limite per utente in modo che un singolo utente non consumi una parte troppo grande della quota a livello di progetto.

Confronto tra i comandi gcloud

La tabella seguente riepiloga i comandi di Container Registry e i comandi equivalenti di Artifact Registry in gcloud CLI. Fai clic su un link nella tabella per visualizzare la pagina di riferimento del comando.

La tabella non include tutti i comandi di Artifact Registry disponibili che non hanno un equivalente in Container Registry. Consulta la documentazione gcloud artifacts per il riferimento completo ai comandi di Artifact Registry.

Operazione Container Registry Artifact Registry
Crea un repository Non applicabile. gcloud artifacts repositories create
Eliminare un repository Non applicabile. gcloud artifacts repositories delete
Elenca immagini gcloud container images list gcloud artifacts docker images list
Elenco tag gcloud container images list-tags gcloud artifacts docker tags list
Aggiungi un tag gcloud container images add-tag gcloud artifacts docker tags add
Eliminare un tag gcloud container images untag gcloud artifacts docker tags delete
Descrivere le immagini gcloud container images describe gcloud artifacts docker images list --include-tags