Documentation sur Oracle Cloud Infrastructure

Obtention des détails d'une image

Découvrez comment obtenir les détails d'une image dans un référentiel du registre de conteneurs.

Pour vous assurer d'extraire la bonne image ou d'identifier les images dont vous n'avez plus besoin, vous pouvez obtenir des informations détaillées sur les images dans le registre de conteneurs.

Lorsque vous utilisez l'interface de ligne de commande et l'API, vous pouvez utiliser l'OCID ou l'URI de l'image pour identifier l'image sur laquelle vous voulez obtenir des informations.

Vos autorisations contrôlent les images sur lesquelles vous pouvez obtenir des informations (voir Politiques pour contrôler l'accès aux référentiels). Vous pouvez obtenir des informations sur les images dans les référentiels que vous avez créés et dans les référentiels auxquels les groupes dont vous êtes membre sont autorisés à accéder par des politiques IAM. Si vous êtes membre du groupe Administrateurs, vous pouvez obtenir des informations sur les images de tout référentiel de la location.

    1. Dans la page de liste Registre de conteneurs, sélectionnez le référentiel avec lequel vous voulez travailler dans la liste Repositaires et images. Si vous avez besoin d'aide pour trouver la page de liste ou le référentiel, voir Liste des référentiels.
      La section des détails du référentiel s'ouvre.
    2. Sélectionnez le référentiel dans la liste Repositaires et images une deuxième fois.
      Les images du référentiel, y compris leurs identificateurs de version, sont listées sous le référentiel dans la liste Répôts et images.
    3. Sélectionnez l'image souhaitée.
      La section des détails de l'image s'ouvre.
    4. Effectuez les tâches suivantes pour voir les détails de l'image :
      • Sélectionnez l'onglet Informations sur l'image pour voir la taille de l'image, quand elle a été poussée et par quel utilisateur, ainsi que le nombre de fois où l'image a été extraite.
      • Sélectionnez l'onglet Couches pour voir le condensé de message SHA de chaque couche dans l'image sélectionnée.
      • Sélectionnez l'onglet Versions pour voir le chemin complet de l'image avec l'identificateur de version que vous sélectionnez. Notez que si vous sélectionnez un autre identificateur de version, les détails du sommaire changent en conséquence.
      • Sélectionnez l'onglet Marqueurs pour voir les marqueurs à structure libre et les marqueurs définis appliqués à l'image. Pour plus d'informations, voir Application de marqueurs à structure libre et de marqueurs définis aux référentiels, images et signatures d'image.
      • Sélectionnez l'onglet Signatures pour voir les détails des signatures créées si l'image a été signée. Pour plus d'informations, voir Signature d'images à des fins de sécurité.
      • Sélectionnez l'onglet Résultats du balayage pour voir un sommaire de chaque balayage de l'image au cours des 13 derniers mois. Pour plus d'informations, voir Analyse des images à la recherche de vulnérabilités.
    5. (Facultatif) Pour extraire une image, sélectionnez Copier la commande d'extraction. La commande que vous copiez inclut le chemin d'accès complet à l'emplacement de l'image dans le registre de conteneurs, au format <registry-domain>/<tenancy-namespace>/<repo-name>:<version>.

      Par exemple, docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test. Voir Extraction d'images à l'aide de l'interface de ligne de commande Docker.

  • Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

    Utilisation de l'OCID de l'image pour obtenir les détails de l'image :

    Utilisez la commande oci artefacts container image get et les paramètres requis pour obtenir les détails d'une image :

    oci artifacts container image get --image-id <image-ocid> [OPTIONS]
    Par exemple :
    oci artifacts container image get --image-id ocid1.containerimage.oc1.phx.0.ansh81vru1zp.aaaaaaaalqzjyks...

    Utilisation de l'URI de l'image pour obtenir les détails de l'image :

    Utilisez la commande oci artefacts container image lookup et les paramètres requis pour obtenir les détails d'une image :

    oci artifacts container image lookup --image-uri <image-uri> [OPTIONS]

    où image-uri identifie une image particulière dans un registre, et inclut un identificateur de version, ou un condensé d'image, ou les deux. Notez que image-uri n'inclut pas de domaine de registre.

    Par exemple : 

    oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app:v2.0.test
    oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app@sha256:abcd1234efgh5678...
    oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app:v2.0.test@sha256:abcd1234efgh5678...

  • Pour utiliser l'OCID de l'image pour obtenir les détails de l'image, exécutez l'opération GetContainerImage.

    Pour utiliser l'URI de l'image pour obtenir les détails de l'image, exécutez l'opération LookupContainerImageByUri.