Facturation du stockage et du trafic d'extraction

En fonction du plan de service que vous choisissez, vous êtes facturé pour le stockage et le trafic d'extraction que vous utilisez par mois dans chaque région.

Limites de quota pour le stockage et le trafic d'extraction

En fonction du plan de service que vous choisissez, vous pouvez envoyer des images par commande push et en extraire par commande pull vers et depuis votre espace de nom jusqu'à ce que vous atteigniez vos limites de quota personnalisées ou spécifiques à votre plan pour chaque région.

Coût de Container Registry

Vous pouvez consulter les tarifs d' IBM Cloud Container Registry dans la section Plans tarifaires de la page détaillée de l'offre. Pour plus d'informations, consultez Container Registry.

Image de conteneur

Il s'agit d'un système de fichiers et des paramètres d'exécution correspondants qui sont utilisés dans un module d'exécution de conteneur pour créer un conteneur. Le système de fichiers se compose d'une série de couches, combinées lors de l'exécution, qui sont créées à mesure que l'image de conteneur est générée par des mises à jour successives. L'image du conteneur ne conserve pas son état pendant l'exécution du conteneur.

Les images de conteneur sont stockées dans un référentiel stocké dans un espace de nom.

Condensé

Les historiques sont utilisés comme références immuables à divers objets du registre, tels que les manifestes d'image, les couches et les éléments de configuration.

Dans le contexte du registre, un historique d'image est une référence immuable à une image qui identifie une image à l'aide du hachage sha256 de Manifeste d'image. Vous pouvez utiliser un historique de l'image pour vous assurer que vous référencez toujours la même version d'une image. Utilisez le format long de l'historique d'image pour travailler avec des images, comme par exemple pour les extraire, les insérer et les supprimer.

Pour rechercher le résumé de l'image, exécutez la commande ibmcloud cr image-digests. La commande ibmcloud cr image-list renvoie également l'historique de l'image, mais, par défaut, elle est au format tronqué. Vous pouvez ajouter une option à la commande ibmcloud cr image-list pour renvoyer l'historique de l'image dans le format long.

Lorsque vous utilisez le digest d'image pour identifier une image, utilisez toujours le format long.

Dans Container Registry, toute référence à "condensé" signifie "condensé d'image".

Fichier Docker

Un fichier Dockerfile est un fichier texte contenant des instructions pour la construction d'une image Docker.

Généralement, une image de conteneur est générée à partir d'une image de base contenant un système d'exploitation de base, tel Ubuntu. Vous pouvez modifier par incréments l'image de base avec des instructions Dockerfile définissant l'environnement où doit s'exécuter l'application. Chaque modification de l'image de base décrit une nouvelle couche de l'image et vous pouvez apporter plusieurs modifications au même fichier Dockerfile. Les instructions contenues dans un fichier Dockerfile peuvent également faire référence à des artefacts de compilation stockés séparément, tels qu'une application, la configuration de celle-ci et ses dépendances. Pour plus d'informations sur Dockerfile, consultez la référence Dockerfile.

Images de conteneur Docker V2

Une image de conteneur conforme à la spécification Image Manifest Version 2, schéma 2.

Le type de support pour Docker Image Manifest V2, Schema 2 est application/vnd.docker.distribution.manifest.v2+json et le type de support de la liste du manifeste est application/vnd.docker.distribution.manifest.list.v2+json. Une image de conteneur Docker V2 est un type d'image de conteneur OCI. Pour plus d'informations sur la prise en charge de Docker, voir Docker.

Nom de domaine

Nom d'un système hôte. Un nom de domaine se compose d'une séquence de sous-noms séparés par un caractère de délimitation, par exemple, www.ibm.com.

Les noms de domaine utilisés par Container Registry sont au format us.icr.io. Les noms de domaine précédents utilisés par Container Registry sont au format registry.ng.bluemix.net. Les deux formats de nom de domaine font référence au même registre et au même contenu. Le service Container Registry répond de manière égale aux noms de domaine antérieurs et canoniques. Vous pouvez insérer ou extraire des images en utilisant l'un ou l'autre nom de domaine de manière interchangeable.

Le nom de domaine n'est significatif que dans les cas suivants :

• Lorsque Kubernetes sélectionne un secret d'extraction, il en choisit un qui correspond au nom de domaine.
• Lorsque ibmcloud cr login vous aide à vous connecter, il utilise des noms de domaine au format us.icr.io uniquement.
• Lorsque des images sont signées, la signature inclut le nom de domaine utilisé lors de la signature.

Pour plus d'informations sur les noms de domaine utilisés par Container Registry, voir Régions.

Manifeste d'image

Un manifeste d'image est un document .json qui référence l'objet de configuration et les couches d'image nécessaires à l'extraction et à l'exécution de l'image. Le hachage sha256 du manifeste d'image est l'historique, qui est utilisé pour identifier l'image. Vous pouvez afficher le manifeste d'image en exécutant la commande ibmcloud cr manifest-inspect.

Images de conteneur OCI

Une image de conteneur conforme à la spécification du format d'image OCI.

Le type de support pour des images de conteneur OCI est application/vnd.oci.image.manifest.v1+json.

Registry

Service de distribution et de stockage d'image de conteneur public ou privé.

Un espace de stockage est fourni pour les images de conteneurs OCIImage de conteneur conforme à la spécification de format d'image OCI (également appelées images de conteneurs Docker ). Les images de conteneur OCI peuvent être accédées ou "extraites" (commande pull) par des clients OCI qui utilisent le nom de domaine de registre approprié. Les images de conteneur peuvent être consultées par tous (images publiques) ou l'accès peut être limité à un groupe (images privées). IBM Cloud Container Registry fournit un registre d'images privées multititulaire à haute disponibilité qui est hébergé et géré par IBM. Vous pouvez utiliser le registre en ajoutant un espace de nom privé pour votre compte, puis envoyer (par commande push) des images à votre espace de nom.

Espace de nom de registre

Un dossier qui contient des dossiers ou des dépôts qui stockent vos images de conteneurs dans Container Registry. L'espace de nom de registre est associé à votre compte IBM Cloud. Vous pouvez avoir plusieurs espaces de nom de registre dans un compte.

Lorsque vous créez votre propre espace de noms dans Container Registry, l'espace de noms est ajouté au registre URL <region>.icr.io/<my_namespace>, où <region> est la région et <my_namespace> votre espace de noms. L'espace de nom doit être unique pour tous les comptes IBM Cloud de la même région. Chaque utilisateur de votre compte IBM Cloud disposant des autorisations IAM appropriées peut consulter et exploiter les images stockées dans l'espace de noms de votre registre.

Vous pouvez avoir 100 espaces de nom dans chaque région.

Les espaces de noms sont créés dans un groupe de ressources que vous spécifiez, ce qui vous permet de configurer l'accès aux ressources au sein de l'espace de noms au niveau du groupe de ressources. Si vous ne spécifiez pas de groupe de ressources et qu'aucun groupe de ressources n'est ciblé, le groupe de ressources par défaut est utilisé. Si vous disposez d'un espace de noms plus ancien qui n'appartient pas à un groupe de ressources, vous pouvez l'affecter à un groupe de ressources, puis définir des autorisations pour cet espace de noms au niveau du groupe de ressources. Pour plus d'informations sur les groupes de ressources, voir Affectation d'espaces de nom existants à des groupes de ressources.

Espaces de nom affectés à un groupe de ressources dans la page Liste de ressources de la console IBM Cloud.

Référentiel

Stocke une collection d'images de conteneurs connexes. Un référentiel est stocké dans un espace de noms. Les images des conteneurs se distinguent uniquement par la balise ou le condensé. Le terme référentiel est souvent utilisé de manière interchangeable avec image de conteneur, mais un référentiel peut contenir plusieurs variantes balisées d'une même image de conteneur.

Balise

Identificateur associé aux images de conteneur dans un référentiel. Les balises peuvent être réaffectées ou supprimées des images.

Vous pouvez utiliser des balisesIdentificateur défini par l'utilisateur associé à un regroupement de ressources qui sont contenues dans un compte. Les étiquettes sont visibles dans l'ensemble du compte. pour distinguer les différentes versions d'une même image de base au sein d'un référentiel. Lorsque vous exécutez une commande Docker sans spécifier l'étiquette d'une image du référentiel, celle associée à l'étiquette latest (dernière) est utilisée par défaut.

Images sans étiquette

Une image qui n'a pas d'étiquette est une image sans étiquette. Les images non balisées peuvent être référencées à l'aide du format de référence de synthèse <repository>@<digest>, par opposition au format de référence de balise <repository>:<tag>. Les images non balisées sont généralement le résultat d'une image qui est insérée avec une combinaison <repository>:<tag> préexistante. Dans ce cas, l'étiquette est écrasée et l'image d'origine se retrouve sans étiquette.

Vous pouvez visualiser toutes vos images marquées et non marquées en lançant la commande ibmcloud cr image-digests en exécutant la commande Si vous souhaitez visualiser uniquement les images non marquées, vous pouvez exécuter la commande ibmcloud cr image-digests avec un formatage en langage Go, voir Exemple de commande de formatage Go pour ibmcloud cr image-digests. Si vous souhaitez supprimer vos images non marquées, vous pouvez exécuter la commande ibmcloud cr image-prune-untagged commande.

Registre global

Une base de registre globale est disponible. Le registre global n'inclut pas de région dans son nom (icr.io). Outre l'hébergement d'espaces de nom d'utilisateur et d'images, ce registre héberge également des images publiques fournies par IBM.

L'instance globale de IBM Cloud Container Registry est disponible à l'aide de noms de domaine qui figurent dans le tableau suivant.

Pour plus d'informations sur la connexion à Container Registry à l'aide des noms de domaine privés, voir Utilisation de connexions réseau privées.

Les noms de domaine bluemix.net existants sont obsolètes, mais vous pouvez toujours les utiliser pour l'instant. La date de fin de prise en charge n'est pas disponible à ce jour.

Régions locales

Les instances régionales de Container Registry sont disponibles à l'aide des noms de domaine qui figurent dans le tableau suivant.

Pour plus d'informations sur la connexion à Container Registry à l'aide des noms de domaine privés, voir Utilisation de connexions réseau privées.

Les noms de domaine bluemix.net existants sont obsolètes, mais vous pouvez toujours les utiliser pour l'instant. La date de fin de prise en charge n'est pas disponible à ce jour.

Prise en charge de Docker

IBM Cloud Container Registry prend en charge les versions de Docker Engine que Docker prend en charge.

Docker est requis uniquement si vous souhaitez extraire ou envoyer des images.

Les images Docker V2 schéma 2 sont prises en charge. Les listes de manifestes sont également prises en charge. Pour plus d'informations, voir Compatibilité avec le registre.

Les images Docker V2 Schema 1 ne sont plus prises en charge et vous ne pouvez plus les envoyer vers Container Registry.

Soutien aux autres clients

IBM Cloud Container Registry prend en charge les versions supportées des clients conformes à la spécification de distribution OCI version 1 ou ultérieure, tels que Buildah, Podman, et Skopeo.