Informazioni su Container Registry

Fatturazione per l'archiviazione e il traffico di pull

A seconda del piano del servizio scelto, gli addebiti a tuo carico sono basati sull'archiviazione e sul traffico di pull che utilizzi al mese in ogni regione.

Limiti di quota per la archiviazione e il traffico di pull

A seconda del piano del servizio scelto, puoi eseguire il push e il pull di immagini da e verso il tuo spazio dei nomi finché non raggiungi i tuoi limiti di quota specifici del piano o personalizzati per ogni regione.

Costo di Container Registry

Puoi vedere i costi di IBM Cloud Container Registry nella sezione dei piani dei prezzi della pagina dei dettagli dell'offerta, vedi Container Registry.

Immagine contenitore

Un file system e i relativi parametri di esecuzione che vengono utilizzati all'interno di un runtime del contenitore per creare un contenitore. Il file system è costituito da una serie di livelli, che vengono combinati in fase di runtime, che vengono creati quando l'immagine del contenitore viene creata da aggiornamenti successivi. L'immagine del contenitore non conserva il suo stato mentre viene eseguito il contenitore.

Le immagini contenitore vengono memorizzate in un repository archiviato in uno spazio dei nomi.

Digest

I digest vengono utilizzati come riferimenti immutabili a vari oggetti nel registro, come i manifest di immagine, i livelli e gli elementi di configurazione.

Nel contesto del registro, un digest dell'immagine è un riferimento immutabile a un'immagine che identifica un'immagine utilizzando l'hash sha256 del manifest dell'immagine. Puoi utilizzare un digest di immagine per assicurarti di fare sempre riferimento alla stessa versione di un'immagine. Utilizza il formato lungo del digest dell'immagine per lavorare con le immagini, come ad esempio il pull, il push e l'eliminazione di immagini.

Per trovare il digest dell'immagine, esegui il comando ibmcloud cr image-digests. Il comando ibmcloud cr image-list restituisce anche il digest dell'immagine, ma, per impostazione predefinita, è in un formato troncato. È possibile aggiungere un'opzione al comando ibmcloud cr image-list per restituire il digest dell'immagine nel formato lungo.

Quando si utilizza il digest dell'immagine per identificare un'immagine, utilizzare sempre il formato lungo.

In Container Registry, qualsiasi riferimento a "digest" significa "digest immagine".

Dockerfile

Un Dockerfile è un file di testo che contiene le istruzioni per creare un'immagine Docker.

Normalmente, un'immagine contenitore viene creata basandosi su un'immagine che contiene un sistema operativo di base, come ad esempio Ubuntu. Puoi modificare in modo incrementale l'immagine di base con le tue istruzioni del Dockerfile per definire l'ambiente in cui deve essere eseguita l'applicazione. Ogni modifica all'immagine di base descrive un nuovo livello dell'immagine e puoi effettuare più modifiche in una sola riga del Dockerfile. Le istruzioni in un Dockerfile potrebbero anche fare riferimento alle risorse di build memorizzate separatamente, come un'applicazione, la configurazione dell'applicazione e le relative dipendenze. Per ulteriori informazioni su Dockerfile, vedi Dockerfile reference.

Immagini contenitore Docker V2

Un'immagine del contenitore conforme alla specifica Docker: Image Manifest V2, schema 2.

Il tipo di elemento multimediale per Docker Image Manifest V2, Schema 2 è application/vnd.docker.distribution.manifest.v2+json mentre per l'elenco di manifest è application/vnd.docker.distribution.manifest.list.v2+json. Un'immagine contenitore Docker V2 è un tipo di immagine contenitore OCI. Per ulteriori informazioni sul supporto per Docker, vedi Docker.

Nome dominio

Il nome di un sistema host. Un nome dominio è costituito da una sequenza di nomi secondari separati da un carattere delimitatore, ad esempio www.ibm.com.

I nomi dominio utilizzati da Container Registry sono nel formato us.icr.io. I nomi dominio precedenti utilizzati da Container Registry sono nel formato registry.ng.bluemix.net. Entrambi i formati del nome dominio fanno riferimento allo stesso registro e contenuto. Il servizio Container Registry risponde allo stesso modo ai nomi di dominio precedenti e canonici. Puoi eseguire il push o il pull delle immagini utilizzando uno dei nomi di dominio in modo intercambiabile.

Il nome dominio è significativo solo nelle seguenti situazioni:

• Quando Kubernetes seleziona un segreto di pull, ne sceglie uno che corrisponda al nome dominio.
• Quando ibmcloud cr login aiuta l'utente ad accedere, utilizza solo i nomi dominio nel formato us.icr.io.
• Quando le immagini vengono firmate, la firma comprende il nome del dominio utilizzato al momento della firma.

Per ulteriori informazioni sui nomi dominio che Container Registry utilizza, vedi Regioni.

Manifest immagine

Un manifest di immagine è un documento .json che fa riferimento all'oggetto di configurazione e ai livelli di immagine richiesti per eseguire il pull e l'immagine. L'hash sha256 del manifest dell'immagine è il digest, che viene utilizzato per identificare l'immagine. Puoi visualizzare il manifest dell'immagine eseguendo il comando ibmcloud cr manifest-inspect.

Immagini contenitore OCI

Un'immagine contenitore conforme alla specifica Formato immagine OCI.

Il tipo di elemento multimediale per le immagini del contenitore OCI è application/vnd.oci.image.manifest.v1+json.

Registro

Un archivio di immagini contenitore pubbliche o private e il servizio di distribuzione.

L'archivio viene fornito per le immagini contenitore OCIA container image that is compliant with the OCI Image Format Specification (note anche come immagini contenitore Docker ). I client OCI possono accedere o "passare" le immagini contenitore OCI che utilizzano il nome dominio del registro appropriato. Le immagini contenitore possono essere accessibili da chiunque (immagini pubbliche) o l'accesso può essere limitato a un gruppo (immagini private). Container Registry fornisce un registro delle immagini privato a più tenant, altamente disponibile, ospitato e gestito da IBM. Puoi utilizzare il registro per aggiungere uno spazio dei nomi al tuo account e poi passare le immagini al tuo spazio dei nomi.

Spazio dei nomi del registro

Una raccolta di repository che archiviano le tue immagini del contenitore in Container Registry. Lo spazio dei nomi del registro è associato al tuo account IBM Cloud. Disponi di più spazi dei nomi del registro in un account.

Uno spazio dei nomi del registro è formato da più di un repository.

Quando configuri il tuo proprio spazio dei nomi in Container Registry, lo spazio dei nomi viene aggiunto al registro URL, <region>.icr.io/my_namespace. Lo spazio dei nomi deve essere univoco tra tutti gli account IBM Cloud nella stessa regione. Ogni utente nel tuo account IBM Cloud può visualizzare e gestire le immagini memorizzate nel tuo spazio dei nomi del registro.

Puoi avere 100 spazi dei nomi in ogni regione.

Gli spazi dei nomi sono creati in un gruppo di risorse che specifichi in modo da poter configurare l'accesso alle risorse all'interno dello spazio dei nomi a livello del gruppo di risorse. Se non specifichi un gruppo di risorse e un gruppo di risorse non è di destinazione, viene utilizzato il gruppo di risorse predefinito. Se hai uno spazio dei nomi precedente che non si trova in un gruppo di risorse, puoi assegnarlo a un gruppo di risorse e quindi impostare le autorizzazioni per tale spazio dei nomi a livello di gruppo di risorse. Per ulteriori informazioni sui gruppi di risorse, vedi Assegnazione di spazi dei nomi esistenti ai gruppi di risorse.

Gli spazi dei nomi assegnati a un gruppo di risorse vengono mostrati nella pagina Elenco risorse della console IBM Cloud.

Repository

Una raccolta di immagini contenitore correlate nel registro del contenitore che vengono distinte solo per tag o digest.

Il repository viene spesso utilizzato in modo intercambiabile con l'immagine contenitore, ma un repository potenzialmente contiene più varianti contrassegnate con tag di un'immagine contenitore.

Un repository archivia le immagini contenitore e viene archiviato a sua volta in uno spazio dei nomi del registro.

Tag

Un identificativo collegato alle immagini del contenitore all'interno di un repository. I tag possono essere riassegnati o eliminati dalle immagini.

Puoi utilizzare le tagA user-defined identifier attached to a grouping of resources that are contained in an account. Tags are visible account-wide. per distinguere diverse versioni della stessa immagine di base all'interno di un repository. Quando esegui un comando Docker e non specifichi una tag di una immagine del repository, viene utilizzata per impostazione predefinita l'immagine contrassegnata con latest.

Immagini non contrassegnate con tag

Un'immagine che non ha tag è un'immagine senza tag. Le immagini senza tag possono essere indicate utilizzando il formato di riferimento digest <repository>@<digest> rispetto al formato di riferimento tag <repository>:<tag>. Le immagini senza tag sono di solito il risultato di un'immagine di cui viene eseguito il push con una combinazione <repository>:<tag> preesistente. In questo caso, il tag viene sovrascritto e l'immagine originale diventa senza tag.

Puoi visualizzare le immagini non contrassegnate con tag utilizzando il comando ibmcloud cr image-digests ed eliminando le immagini non contrassegnate con tag tramite il comando ibmcloud cr image-prune-untagged.

Registro globale

È disponibile un registro globale. Il registro globale non include una regione nel nome (icr.io). Oltre a ospitare gli spazi dei nomi e le immagini dell'utente, questo registro ospita anche le immagini pubbliche fornite da IBM.

L'istanza globale di Container Registry è disponibile utilizzando nomi dominio mostrati nella seguente tabella.

Per informazioni sulla connessione a Container Registry utilizzando i nomi di dominio privati, consulta Utilizzo delle connessioni di rete private.

I nomi di dominio bluemix.net esistenti sono obsoleti, ma è possibile continuare a utilizzarli per il momento. Una data di fine del supporto non è ancora disponibile.

Regioni locali

Le istanze regionali di Container Registry sono disponibili utilizzando i nomi dominio mostrati nella seguente tabella.

Per informazioni sulla connessione a Container Registry utilizzando i nomi di dominio privati, consulta Utilizzo delle connessioni di rete private.

I nomi di dominio bluemix.net esistenti sono obsoleti, ma è possibile continuare a utilizzarli per il momento. Una data di fine del supporto non è ancora disponibile.

Supporto per Docker

IBM Cloud Container Registry supporta le versioni di Docker Engine supportate da Docker.

Docker è richiesto solo se vuoi eseguire il push o il pull delle immagini.

Le immagini Docker V2 Schema 2 sono supportate. Anche gli elenchi di manifest sono supportati. Per ulteriori informazioni, vedi Docker: Image Manifest Version 2, schema 2.

Docker V2 le immagini dello schema 1 sono discontinue e non puoi più eseguirne il push a Container Registry.

Supporto per altri clienti

IBM Cloud Container Registry supporta le versioni supportate dei client conformi alla specifica di distribuzione OCI versione 1 o successive, come ad esempio Buildah, Podman e Skopeo.