Documentation 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 dans Container Registry.

Pour être sûr d'extraire l'image appropriée ou d'identifier les images dont vous n'avez plus besoin, vous pouvez obtenir des informations détaillées sur les images dans Container Registry.

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 à laquelle vous souhaitez obtenir des informations.

Vos droits d'accès contrôlent les images sur lesquelles vous pouvez obtenir des informations (reportez-vous à Stratégies de contrôle de l'accès au référentiel). Vous pouvez obtenir des informations sur les images dans les référentiels que vous avez créés ainsi que dans ceux auxquels les groupes dont vous êtes membre ont pu accéder grâce à des stratégies IAM. Si vous êtes membre du groupe d'administrateurs, vous pouvez afficher les informations sur les images de n'importe quel référentiel de la location.

    1. Dans la page de liste Container Registry, sélectionnez le référentiel à utiliser dans la liste Référentiels et images. Si vous avez besoin d'aide pour trouver la page de liste ou le référentiel, reportez-vous à 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 Référentiels et images une deuxième fois.
      Les images du référentiel, y compris leurs identificateurs de version, sont répertoriées sous le référentiel dans la liste Référentiels et images.
    3. Sélectionnez l'image souhaitée.
      La section Détails de l'image s'ouvre.
    4. Effectuez les tâches suivantes pour afficher les détails de l'image :
      • Sélectionnez l'onglet Informations sur l'image pour voir la taille de l'image, la date de propagation et l'utilisateur qui en est à l'origine, ainsi que le nombre d'extractions effectuées.
      • 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 afficher le chemin complet de l'image avec l'identificateur de version que vous sélectionnez. Si vous sélectionnez un autre identificateur de version, les détails du récapitulatif sont modifiés en conséquence.
      • Sélectionnez l'onglet Balises pour afficher les balises à format libre et les balises définies appliquées à l'image. Pour plus d'informations, reportez-vous à Application de balises à format libre et de balises définies aux référentiels, aux images et aux signatures d'image.
      • Sélectionnez l'onglet Signatures pour afficher les détails des signatures créées si l'image a été signée. Pour plus d'informations, reportez-vous à Signature d'images à des fins de sécurité.
      • Sélectionnez l'onglet Résultats de l'analyse pour afficher un récapitulatif de chaque analyse de l'image au cours des 13 derniers mois. Pour plus d'informations, reportez-vous à Analyse d'images à des fins de dépistage des vulnérabilités.
    5. (Facultatif) Pour extraire une image, sélectionnez Copier la commande d'extraction. La commande que vous copiez inclut le chemin qualifié complet vers l'emplacement de l'image dans Container Registry, 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. Reportez-vous à Extraction d'images à l'aide de l'interface de ligne de commande Docker.

  • Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de 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, 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 afin d'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.