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

È possibile consultare i costi di IBM Cloud Container Registry nella sezione dedicata ai piani tariffari della pagina dei dettagli dell'offerta. Per ulteriori informazioni, vedere 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 esecuzione e creati man mano che l'immagine del container viene costruita tramite aggiornamenti successivi. L'immagine del container non mantiene il proprio stato durante l'esecuzione del container.

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

Digest

I digest sono usati come riferimenti immutabili a vari oggetti del registro, come i manifesti delle immagini, i livelli e gli elementi di configurazione.

Nel contesto del registro, un image digest è un riferimento immutabile a un'immagine che la identifica utilizzando l'hash sha256 del manifest dell'immagine. È possibile utilizzare un digest delle immagini per garantire che si faccia sempre riferimento alla stessa versione di un'immagine. Utilizzare il formato lungo del digest di immagini per lavorare con le immagini, ad esempio per estrarre, spingere ed eliminare le 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 l'image digest per identificare un'immagine, utilizzare sempre il formato lungo.

In Container Registry, ogni riferimento a "digest" significa "image digest".

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 contenute in un Dockerfile potrebbero anche fare riferimento ad artefatti di compilazione archiviati separatamente, come un'applicazione, la configurazione dell'applicazione e le sue dipendenze. Per ulteriori informazioni su Dockerfile, consulta la guida di riferimento su Dockerfile.

Immagini contenitore Docker V2

Un'immagine del contenitore conforme alla specifica Image Manifest Version 2, 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 di dominio è costituito da una sequenza di sotto-nomi separati da un carattere delimitatore, ad esempio www.ibm.com.

I nomi di dominio che Container Registry utilizza sono nel formato us.icr.io. I nomi di dominio precedenti utilizzati da Container Registry sono nel formato registry.ng.bluemix.net. Entrambi i formati di nome di dominio si riferiscono allo stesso registro e allo stesso contenuto. Il servizio Container Registry risponde in egual misura ai nomi di dominio precedenti e a quelli canonici. È possibile spingere o tirare le immagini utilizzando uno dei due nomi di dominio in modo intercambiabile.

Il nome di dominio è significativo solo nelle seguenti situazioni:

• Quando Kubernetes seleziona un segreto di estrazione, ne sceglie uno che corrisponde al nome del 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 include il nome di dominio utilizzato al momento della firma.

Per ulteriori informazioni sui nomi di dominio utilizzati da Container Registry, vedere Regioni.

Manifest immagine

Un manifest di immagine è un documento .json che fa riferimento all'oggetto di configurazione e ai livelli di immagine necessari per estrarre ed eseguire l'immagine. L'hash sha256 del manifesto dell'immagine è il digest, 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.

È disponibile uno spazio di archiviazione per le immagini dei container OCIUn'immagine del contenitore conforme alla specifica OCI Image Format (note anche come immagini dei container " Docker "). I client OCI possono accedere o "passare" le immagini contenitore OCI che utilizzano il nome dominio del registro appropriato. Le immagini dei contenitori possono essere accessibili a chiunque (immagini pubbliche) o l'accesso può essere limitato a un gruppo (immagini private). Container Registry fornisce un registro di immagini private multi-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 cartella che contiene cartelle o repository che memorizzano le 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.

Quando si imposta il proprio spazio dei nomi in Container Registry, lo spazio dei nomi viene aggiunto al registro URL <region>.icr.io/<my_namespace>, dove <region> è la regione e <my_namespace> è lo spazio dei nomi. Lo spazio dei nomi deve essere univoco tra tutti gli account IBM Cloud nella stessa regione. Ogni utente dell'account IBM Cloud che dispone delle autorizzazioni IAM corrette può visualizzare e lavorare con le immagini memorizzate nello spazio dei nomi del registro.

Puoi avere 100 spazi dei nomi in ogni regione.

Gli spazi dei nomi vengono creati in un gruppo di risorse specificato dall'utente, in modo da poter configurare l'accesso alle risorse all'interno dello spazio dei nomi a livello di gruppo di risorse. Se non si specifica un gruppo di risorse e non viene indicato alcun gruppo di risorse come destinazione, viene utilizzato il gruppo di risorse predefinito. Se disponi di uno spazio dei nomi meno recente che non fa parte di un gruppo di risorse, puoi assegnarlo a un gruppo di risorse e quindi impostare le autorizzazioni per quello 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

Memorizza un insieme di immagini di contenitori correlati. Un repository è memorizzato in uno spazio dei nomi. Le immagini del contenitore si distinguono solo per tag o digest. Il termine “repository” viene spesso utilizzato in modo intercambiabile con “immagine del container”, ma un repository può contenere più varianti contrassegnate da tag di una stessa immagine del container.

Tag

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

È possibile utilizzare i tagUn identificativo definito dall'utente collegato a un gruppo di risorse contenute in un account. Le tag sono visibili al livello dell'account. per distinguere le 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 priva di tag è un'immagine non taggata. È possibile fare riferimento alle immagini prive di tag utilizzando il formato di riferimento digest <repository>@<digest> anziché il formato di riferimento dei tag <repository>:<tag>. Le immagini prive di tag sono tipicamente il risultato di un'immagine che viene spinta con una combinazione preesistente di <repository>:<tag>. In questo caso, l'etichetta viene sovrascritta e l'immagine originale diventa non etichettata.

È possibile visualizzare tutte le immagini etichettate e non etichettate eseguendo il comando ibmcloud cr image-digests il comando. Se si desidera visualizzare solo le immagini non contrassegnate, è possibile eseguire il comando ibmcloud cr image-digests con la formattazione in linguaggio Go, vedere Esempio di comando Go format per ibmcloud cr image-digests. Se si desidera rimuovere le immagini non contrassegnate, è possibile eseguire il comando ibmcloud cr image-prune-untagged il comando.

Registro globale

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

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

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

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

Regioni locali

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

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

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

Supporto per Docker

IBM Cloud Container Registry supporta le versioni di Docker Engine che Docker supporta.

Docker è necessario solo se si desidera spingere o tirare le immagini.

Le immagini Docker V2 Schema 2 sono supportate. Anche gli elenchi di manifest sono supportati. Per ulteriori informazioni, vedere Compatibilità del registro.

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 alle specifiche di OCI Distribution versione 1 o successive, come Buildah, Podman e Skopeo.