Où se trouve la documentation de référence pour Container Registry?

La documentation de référence pour IBM Cloud Container Registry est disponible dans la documentation IBM Cloud. Pour plus d'informations, voir À propos de Container Registry et Container Registry CLI.

Comment configurer l'interface de ligne de commande (CLI) d' Container Registry?

Pour configurer l'interface de ligne de commande (CLI) de IBM Cloud Container Registry, procédez comme suit :

1. Assurez-vous que l'interface CLI d' IBM Cloud est installée. Pour vérifier qu'il est installé, exécutez la commande ibmcloud help.
2. Installez le plug-in CLI container-registry en exécutant la commande ibmcloud plugin install container-registry.
3. Connectez-vous à IBM Cloud à l'aide de la commande ibmcloud login.
4. Vérifiez l'installation en contrôlant la version actuelle du plug-in container-registry CLI à l'aide de la commande ibmcloud plugin list.

Vous pouvez maintenant utiliser le CLI IBM Cloud Container Registry pour gérer votre registre et ses ressources pour votre compte IBM Cloud.

Pour plus d'informations, voir Configuration du CLI et de l'espace de noms Container Registry et Premiers pas avec Container Registry.

Pourquoi la commande ibmcloud cr n'est-elle pas connue?

Si vous recevez un message indiquant que ibmcloud cr n'est pas une commande enregistrée, cela signifie que le plug-in CLI container-registry n'est pas installé ou qu'il n'est pas à jour. Voir Pourquoi les commandes Container Registry(ibmcloud cr)échouent-elles avec un message indiquant qu'elles ne sont pas enregistrées? pour obtenir de l'aide.

Si vous rencontrez des problèmes avec une commande non enregistrée, il est probable que vous ne disposiez pas de la version la plus récente du plug-in. Pour plus d'informations sur la mise à jour du CLI Container Registry, voir Mise à jour du plug-in CLI container-registry.

Comment puis-je configurer mon pare-feu pour qu'il autorise les connexions à Container Registry?

Vous pouvez utiliser un pare-feu de couche 7 avec les domaines répertoriés dans Accéder à Container Registry via un pare-feu ou utiliser un réseau privé virtuel(VPN).

Quel est le nom de mon espace de noms?

Pour connaître les noms de vos espaces de noms, exécutez la commande ibmcloud cr namespace-list la commande

Vous pouvez également utiliser l'API pour dresser la liste de vos espaces de noms à l'aide de la méthode GET /api/v1/namespaces.

Pour plus d'informations sur les espaces de noms, voir Espace de noms du registre. Pour planifier vos espaces de noms, voir Planification des espaces de noms.

Combien d'espaces de noms pouvez-vous avoir ?

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

Puis-je renommer un espace de noms?

Il n'est pas possible de renommer un espace de nomsUne collection de référentiels stockant des images dans un registre. Un espace de nom est associé à un compte IBM Cloud, qui peut inclure plusieurs espaces de nom.. Si vous souhaitez modifier le nom de l'espace de noms, vous devez créer un espace de noms avec le nouveau nom et transférer ses données. Pour transférer ses données, vous pouvez copier le contenu de l'espace de noms existant dans l'espace de noms que vous avez créé.

Si vous ne souhaitez pas transférer les données manuellement, vous pouvez créer un script pour cette action en utilisant la commande ibmcloud cr image-tag à l'aide de la commande Par exemple, vous pouvez utiliser le script suivant, où OLD_NAMESPACE est l'espace de noms existant et NEW_NAMESPACE est l'espace de noms que vous avez créé :

IMAGES=$(icr images --restrict OLD_NAMESPACE --format "{{ .Repository }}:{{ .Tag }}")
for i in $IMAGES ; do
   new=$(echo $i | sed "s|/OLD_NAMESPACE/|/NEW_NAMESPACE/|1")
   ibmcloud cr image-tag $i $new
done

Pourquoi n'ai-je pas l'autorisation de créer un espace de noms?

Le message d'erreur You are not authorized to access the specified resource. indique que vous ne disposez pas des autorisations nécessaires pour travailler avec les espaces de noms.

Voir Pourquoi ne suis-je pas autorisé à accéder à une ressource spécifiée dans Container Registry? pour obtenir de l'aide.

Pourquoi ne puis-je pas créer un espace de noms?

Si vous rencontrez des problèmes lorsque vous essayez d'ajouter un espace de noms dans Container Registry, cela peut être dû à l'une des causes suivantes :

• Les caractères non valides sont inclus dans l'espace de noms.
• L'espace de noms est déjà utilisé.
• Vous réutilisez un espace de noms qui a été supprimé récemment.
• Vous ne disposez pas des autorisations nécessaires pour créer un espace de noms.

Voir Pourquoi ne puis-je pas ajouter un espace de noms dans Container Registry? pour obtenir de l'aide.

Comment supprimer un espace de noms?

Si vous n'avez plus besoin d'un espace de nom de registre, vous pouvez supprimer l'espace de nom de votre compte IBM Cloud. Pour plus d'informations, voir Suppression d'espaces de nom.

Lorsque vous supprimez un espace de nom, les images qui y étaient stockées sont également supprimées. Cette action ne peut pas être annulée.

Comment puis-je accéder à mes espaces de noms Container Registry?

Vous pouvez accéder à vos espaces de noms IBM Cloud Container Registry de plusieurs manières, en fonction de votre cas d'utilisation. Vous pouvez créer, afficher, modifier et supprimer des espaces de noms dans la console IBM Cloud ou dans le CLI IBM Cloud. Vous pouvez pousser et tirer des images en utilisant des outils tiers tels que Docker, Podman, SkopeoORAS, regctl et Crane. Vous pouvez également utiliser les SDK IBM Cloud pour manipuler le registre.

Authentification de l'automatisation à l'aide d'informations d'identification à long terme

Utilisez des clés API (clés API d'utilisateur ou clés API d'identifiant de service) avec des politiques d'accès IAM. Les clés API sont la méthode préférée pour l'automatisation et les clusters Kubernetes. Pour plus d'informations, voir Accéder à vos espaces de noms dans l'automatisation.

Authentification de l'accès interactif

La commande ibmcloud utilise les jetons de rafraîchissement IAM pour l'accès à la session lorsque vous travaillez de manière interactive avec le registre. Vous pouvez utiliser la commande ibmcloud cr login pour configurer l'accès au jeton de rafraîchissement avec Docker, Podman, et d'autres clients. Pour plus d'informations, voir Accès interactif à vos espaces de noms.

Toutes les méthodes d'accès nécessitent des politiques d'accès IAM appropriées. Pour plus d'informations sur la configuration des politiques d'accès, voir Définir les politiques d'accès IAM.

Comment puis-je obtenir des informations d'identification pour l'extraction d'images pour Container Registry?

Pour les informations d'identification à longue durée de vie, vous devez utiliser une clé API associée à un identifiant de service ou à un identifiant d'utilisateur disposant d'une autorisation de lecture IAM sur l'espace de noms qui contient l'image. Une clé API utilisateur est associée à un utilisateur et à ses politiques d'accès. Une clé API d'identification de service dispose de ses propres politiques d'accès. Vous pouvez créer des clés API d'ID de service et des clés API d'utilisateur manuellement dans la console IBM Cloud et dans le CLI. Pour plus d'informations sur les clés d'API, voir Présentation des clés d'API.

Pour des raisons de sécurité, la clé d'API ne peut être copiée ou téléchargée qu'au moment de sa création. Si la clé d'API est perdue, vous devez en créer une autre.

Vous pouvez créer des clés API d'utilisateur et des clés API d'ID de service dans la console IBM Cloud, l'interface de ligne de commande (CLI), l'API et Terraform. Pour plus d'informations sur la création de clés API, voir Gestion des clés API d'utilisateur et Gestion des clés API d'identifiant de service.

Pour plus d'informations sur la manière d'accéder à Container Registry, voir Accès à Container Registry.

Comment répertorier les noms des images?

Pour lister toutes les images de votre compte IBM Cloud, vous pouvez lancer la commande ibmcloud cr images, qui affiche toutes les images marquées de votre compte IBM Cloud avec un résumé tronqué. Si vous souhaitez répertorier toutes vos images avec le résumé complet, y compris celles qui ne sont pas balisées, exécutez la commande ibmcloud cr image-digests. Le nom de l'image est au format repository@digest ou repository:tag. Les valeurs de repository, digest et tag sont renvoyées lorsque vous exécutez les commandes.

Pour plus d'informations, voir ibmcloud cr image-list et ibmcloud cr image-digests.

Comment doit-on répertorier les images publiques ?

Pour répertorier les images publiques, exécutez les commandes ibmcloud suivantes de manière à cibler la base de registre globale et à répertorier les images publiques fournies par IBM :

1. Définissez la région comme étant globale (icr.io) en exécutant la commande ibmcloud cr region-set et en saisissant global comme région.

ibmcloud cr region-set global

2. Dressez la liste des images publiques en exécutant la commande ibmcloud cr images avec l'option --include-ibm.

ibmcloud cr images --include-ibm

Pourquoi les demandes adressées à Container Registry sont-elles interrompues alors que j'utilise l'interface CLI de IBM Cloud?

Le problème de dépassement de délai lorsque vous utilisez le CLI de IBM Cloud avec Container Registry peut être dû à la présence de nombreuses images dans le compte. Pour résoudre ce problème, vous pouvez utiliser la commande ibmcloud cr image-list avec l'option --restrict pour réduire la portée de la liste et améliorer les performances. Si les rapports de vulnérabilité ne sont pas nécessaires, il est également possible d'utiliser la commande ibmcloud cr image-list avec l'option --no-va. Pour gérer le nombre d'images, pensez à nettoyer vos espaces de noms. Pour plus d'informations, voir Nettoyer vos espaces de noms sur Container Registry.

Si vous suivez les instructions de démarrage, celles-ci supposent que vous êtes dans votre propre compte et que vous avez l'autorisation de tout faire. Si vous êtes membre d'un compte qui est détenu et administré par quelqu'un d'autre, il se peut que vous ne disposiez pas des autorisations nécessaires pour configurer et faire fonctionner le service de registre. Demandez à votre administrateur de vous ajouter à une politique d'accès existante ou créez une politique d'accès qui vous donne le rôle d'accès au service approprié pour travailler avec Container Registry. Pour plus d'informations, voir Pourquoi je ne peux pas démarrer avec Container Registry? pour obtenir de l'aide.

Si les commandes Container Registry échouent avec une erreur indiquant qu'elles ne sont pas enregistrées, installez le plug-in CLI container-registry. En outre, assurez-vous que le plug-in CLI ibmcloud et le plug-in CLI container-registry sont tous deux à jour. Si vous souhaitez utiliser toutes les commandes et options disponibles, vous devez tenir vos CLI à jour. Pour vérifier la version actuelle de vos plug-ins CLI, exécutez la commande ibmcloud plugin list. Voir Pourquoi ibmcloud cr n'est pas une commande connue? pour obtenir de l'aide.

Comment ajouter plusieurs balises à une image de conteneur?

Pour ajouter plusieurs balises à une image de conteneur, vous pouvez utiliser la commande ibmcloud cr image-tag, mais vous devez exécuter la commande pour chaque balise que vous souhaitez ajouter. Par exemple, si votre image est nommée us.icr.io/birds/bluebird:1 et que vous souhaitez ajouter les balises latest et peck, vous devez exécuter les commandes suivantes :

ibmcloud cr image-tag us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

ibmcloud cr image-tag us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:peck

Après avoir exécuté ces commandes, l'image comporte trois balises 1, latest, et peck.

Quels outils puis-je utiliser pour générer et insérer des images ?

Vous pouvez utiliser les outils Docker et non-Docker pour créer et insérer des images dans le registre. Vous pouvez utiliser des outils non Docker s prenant en charge le format et le protocole d'image de conteneur OCIImage de conteneur conforme à la spécification de format d'image OCI. Pour vous connecter à l'aide d'autres clients, voir Accès interactif à vos espaces de nom.

Comment puis-je me connecter à Container Registry avec Podman?

Pour vous connecter à IBM Cloud Container Registry en utilisant Podman, vous pouvez utiliser la commande suivante : podman login DOMAIN_NAME -u iamapikey -p PASSWORD. Remplacez DOMAIN_NAME par votre nom de domaine, par exemple icr.io, et remplacez PASSWORD par votre clé API IAM.

Si vous préférez ne pas utiliser de clé API, vous pouvez utiliser la commande suivante pour vous connecter avec un jeton de rafraîchissement ibmcloud cr login --client podman.

Pour plus d'informations, voir Utilisation Podman pour s'authentifier auprès du registre, Utilisation Podman pour s'authentifier auprès du registre à l'aide de profils approuvés et ibmcloud cr login.

Les images qui se trouvent dans la corbeille sont-elles comptabilisées pour mon quota ?

Les images qui se trouvent dans la corbeille ne sont pas comptabilisées pour votre quota.

Comment vider la corbeille dans « Container Registry »?

Il n'est pas possible de supprimer des images de la corbeille. Les images sont stockées dans la corbeille pendant 30 jours. Les images qui se trouvent dans la corbeille ne vous sont pas facturées.

Vous pouvez vérifier quelles images se trouvent dans la corbeille en exécutant la ibmcloud cr trash-list commande suivante.

Comment trouver l'historique de l'image ?

Vous pouvez trouver le format long de l' historiquede l'image en exécutant l'une des commandes suivantes. L'historique s'affiche dans la colonne historique de l'interface de ligne de commande.

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

Vous pouvez exécuter l'une des commandes suivantes pour obtenir la forme longue du résumé de l'image :

• Exécutez la commande ibmcloud cr image-digests :

  ibmcloud cr image-digests
  

• Exécutez la commande ibmcloud cr image-list avec l'option --no-trunc:

  ibmcloud cr image-list --no-trunc
  

  Si vous exécutez la commande ibmcloud cr image-list sans l'option --no-trunc, vous voyez le format tronqué de l'empreinte.

Comment utiliser les historiques pour travailler avec des images ?

L'historique identifie une image à l'aide du hachage sha256 du manifeste d'image.

Pour rechercher les historiques de vos images, exécutez la commande ibmcloud cr image-digests. Vous pouvez faire référence à une image en utilisant une combinaison du contenu de la colonne Référentiel (repository) et de la colonne Condensé (digest) séparées par un symbole arrobas (@) pour créer le nom de l'image au format repository@digest.

Pourquoi ne puis-je pas pousser l'image dans Container Registry?

Vous pouvez rencontrer des problèmes lors de l'extraction ou de la transmission d'images vers Container Registry pour diverses raisons, telles que le dépassement du quota de stockage d'images ou de trafic d'extraction, ou des informations d'identification non valides. Pour résoudre ce problème, connectez-vous à IBM Cloud et à l'interface CLI de IBM Cloud Container Registry, vérifiez les limites de quota et l'utilisation, et envisagez de passer à un plan standard si vous êtes sur un plan gratuit.

Voir Pourquoi ne puis-je pas pousser ou tirer une image Docker lorsque j'utilise Container Registry? pour obtenir de l'aide.

Comment répertorier les images datant de plus d'un an?

LinuxmacOS Sur Linux® et macOS,, si vous souhaitez obtenir la liste de toutes les images, marquées ou non, créées il y a plus d'un an, vous pouvez exécuter la commande suivante :

year=$(($(date +%s) - 31556952))
ibmcloud cr digests --format '{{ if (lt .Created '$year')}}{{.Repository}}:{{.Digest}}{{end}}'

Comment utiliser le contrôle d'accès ?

Vous pouvez créer des règles IBM Cloud Identity and Access Management (IAM) pour contrôler l'accès à vos espaces de nom dans IBM Cloud Container Registry. Pour plus d'informations, voir Octroi de l'accès au tutoriel sur les ressources IBM Cloud Container Registry et Gestion de l'accès utilisateur pour Container Registry.

Comment puis-je partager l'accès à une image?

Pour accéder à une image, un utilisateur doit être membre du compte IBM Cloud qui possède les images. Une fois l'utilisateur ajouté au compte, les politiques IAM appropriées doivent être créées pour attribuer l'accès.

Pour plus d'informations, voir Définition des règles d'accès IAM.

Puis-je partager un espace de noms Container Registry avec des comptes IBM Cloud?

Vous ne pouvez pas partager un espace de noms Container Registry (icr.io) avec des comptes IBM Cloud. Un espace de noms est la propriété d'un seul compte IBM Cloud et ne peut être partagé avec plusieurs comptes.

Puis-je pousser des images sur un compte différent de celui qui exécute le pipeline de construction?

Vous pouvez envoyer des images à IBM Cloud Container Registry sur un compte IBM Cloud différent de celui qui exécute le pipeline de construction en suivant les étapes suivantes.

1. Créez une clé API dans le compte cible IBM Cloud avec les politiques d'accès nécessaires pour permettre l'envoi d'images dans l'espace de noms requis.
2. Enregistrez la clé API et l'espace de noms cible dans la configuration de votre pipeline de construction.
3. Modifiez le script de votre pipeline de construction pour utiliser la clé API et l'espace de noms cible lorsque vous envoyez des images à Container Registry. Cette action permet à votre pipeline de construction de s'authentifier et de pousser les images vers l'espace de noms spécifié dans le compte cible IBM Cloud.

Pour plus d'informations, voir Transfert d'images à l'aide d'une clé API et Accéder Container Registry.

Quels rôles dois-je jouer pour pouvoir pousser et tirer des images?

Pour tirer ou pousser une image, vous devez avoir le rôle de rédacteur ou de gestionnaire. Pour plus d'informations, voir Rôles d'accès pour l'utilisation de Container Registry.

Ai-je des images non balisées ?

Pour savoir si vous avez des images non balisées, listez vos images en exécutant la commande ibmcloud cr image-digests. Les images non balisées ont un trait d'union (-) dans la colonne Balises.

Ai-je besoin d'images non balisées ?

Si vous avez des conteneurs actifs qui exécutent des images non balisées, vous devez conserver les images non balisées. Si vous supprimez des images non balisées qui sont en cours d'utilisation, vous pouvez provoquer des problèmes avec la mise à l'échelle ou les redémarrages automatisés. La suppression d'images non balisées peut entraîner un problème dans les cas suivants :

• L'image a été déployée en utilisant le condensé comme référence. Par exemple, IBM Cloud Code Engine résout et utilise un résumé d'image lorsqu'il sert des applications, voir Déployer des charges de travail d'application à partir d'images dans un registre public.
• La référence d'image a été mutée par un service webhook, tel que Portieris.

Comment puis-je vérifier quelles images non marquées vont être supprimées par la commande ibmcloud cr image-prune-untagged ?

Il n'est pas possible d'effectuer une répétition de la commande ibmcloud cr image-prune-untagged commande. Cependant, vous pouvez visualiser toutes vos images marquées et non marquées en exécutant 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. Vous pouvez alors vérifier que vous souhaitez supprimer ces images non marquées avant d'exécuter la commande ibmcloud cr image-prune-untagged.

Comment restaurer une image que j'ai supprimée par accident?

Si vous souhaitez restaurer une image supprimée, recherchez-la en listant le contenu de la corbeille à l'aide de la commande ibmcloud cr trash-list en exécutant la commande Restaurer l'image sélectionnée en exécutant la commande ibmcloud cr image-restore en exécutant la commande Les images sont stockées dans la corbeille pendant 30 jours.

Quelles sont les images éligibles?

Si vous nettoyez des images en utilisant des politiques de conservation, seules les images éligibles sont nettoyées. Les images qui sont toujours conservées sont les images Cloud Native Buildpacks et Google sans distorsion dont la date de construction a été fixée à une constante spécifique plutôt qu'à la date de construction réelle ou qui n'ont pas d'horodatage de construction du tout, ainsi que les listes de manifestes. Les images qui sont toujours conservées ne sont pas éligibles.

Les images qui ne sont pas éligibles sont toujours affichées, mais elles ne sont pas prises en compte dans le nombre total d'images défini dans la politique de conservation et ne sont pas supprimées.

Les images créées avant 2013-01-19T00:13:39Z sont exclues de l'évaluation de la politique de conservation.

Pour plus d'informations, voir Planification de la rétention.

Que puis-je utiliser pour signer les images dans Container Registry?

Container Registry prend en charge les images signées avec Red Hat signatures ou cosignature. Vous pouvez utiliser divers outils, tels que Skopeo, Podman, et le CLI Red Hat OpenShift, pour créer des signatures Red Hat pour vos images. Vous pouvez stocker vos images signées pour le contenu sécurisé à l'aide de l'API d'extension des signatures Red Hat, qui est prise en charge par IBM Cloud Container Registry. Pour plus d'informations sur la signature des images, consultez la section Signer des images pour du contenu fiable dans Container Registry.

Dans quelle région suis-je?

Pour déterminer la région que vous utilisez actuellement, vous pouvez utiliser la commande ibmcloud cr region dans l'interface de programmation. Cette commande affiche la région ciblée et le registre. Vous pouvez également consulter la console dans laquelle votre instance est déployée pour connaître la région. Pour plus d'informations, voir Régions.

Quelles régions sont disponibles ?

Pour en savoir plus sur les régions disponibles pour IBM Cloud Container Registry, voir Régions.

Comment modifier la région ou le registre?

Pour modifier la région et le registre, vous devez vous connecter à IBM Cloud et utiliser la commande ibmcloud cr region-set REGION où REGION est le nom de la région que vous souhaitez utiliser, par exemple global, au-syd, et jp-tok. Cette commande configure le plug-in CLI container-registry pour qu'il cible le registre régional spécifié.

Par exemple, pour modifier le registre en uk.icr.io, qui se trouve dans la région eu-gb, procédez comme suit.

1. Connectez-vous à IBM Cloud à l'aide de la commande suivante.

ibmcloud login

2. Exécutez la commande ibmcloud cr region-set pour définir la région et le registre en saisissant eu-gb comme région :

ibmcloud cr region-set eu-gb

Vous pouvez également utiliser le nom du registre (par exemple, uk.icr.io) ou l'ancien nom de la région (par exemple, uk-south au lieu de eu-gb).

Vous obtenez la réponse suivante :

The region is set to 'uk-south', the registry is 'uk.icr.io'.

Pour en savoir plus sur les régions disponibles pour IBM Cloud Container Registry, voir Régions.

Comment faire en sorte que la commande docker pull renvoie la version la plus récente?

Pour trouver l'image la plus récente, exécutez la commande ibmcloud cr image-list plutôt que la commande docker pull. Pour faciliter la recherche de l'image la plus récente, définissez à chaque fois une balise séquentielle différente pour vos images et ne vous fiez pas à la balise latest.

Voir Pourquoi ne puis-je pas obtenir l'image la plus récente en utilisant la balise latest dans Container Registry? pour obtenir de l'aide.

Pourquoi mes pods échouent-ils avec une erreur ImagePullBackOff ?

L'erreur est probablement due à l'une des situations suivantes :

• Votre cluster utilise une clé API stockée dans un secret de récupération d'images afin d'autoriser le cluster à récupérer des images depuis IBM Cloud Container Registry.
• L'image avec le tag spécifique n'existe pas dans le référentiel.

Pour corriger l'erreur, vérifiez les causes potentielles suivantes.

• Vérifiez que vous utilisez le nom et la balise corrects pour l'image.
• Vérifiez que vos quotas de trafic et de stockage sont suffisants.
• Vérifiez si vous disposez d'un secret d'extraction d'image dans votre espace de noms.

Pour plus d'informations, voir Pourquoi les images ne parviennent-elles pas à être extraites du registre avec ImagePullBackOff ou des erreurs d'autorisation? pour obtenir de l'aide.

Pourquoi est-ce que je reçois une erreur de dépassement de quota?

Vous avez dépassé le quota de stockage d'images ou de trafic d'extraction de votre compte pour le mois en cours. Pour résoudre ce problème, vous pouvez soit revoir vos limites de quota et les augmenter si nécessaire, soit, si vous êtes sur le plan Lite, passer au plan standard.

Pour plus d'informations, voir Pourquoi obtenir des erreurs concernant mon quota dans Container Registry? et Toujours à l'intérieur des limites de quota.

Comment supprimer IBM Cloud Container Registry ?

Si vous ne souhaitez plus utiliser Container Registry, vous pouvez le supprimer en désinstallant le plug-in CLI container-registry. Pour plus d'informations, voir Désinstallation du plug-in container-registry CLI.