Documentación de Oracle Cloud Infrastructure

Obtención de detalles de una imagen

Descubra cómo obtener detalles de una imagen en un repositorio de Container Registry.

Para asegurarse de extraer la imagen correcta o identificar las imágenes que ya no necesita, puede obtener información detallada sobre las imágenes en Container Registry.

Al utilizar la CLI y la API, puede utilizar el OCID de imagen o el URI de imagen para identificar la imagen sobre la que desea obtener información.

Los permisos controlan las imágenes sobre las que puede obtener información (consulte Políticas para controlar el acceso al repositorio). Puede obtener información acerca de las imágenes en los repositorios que ha creado y en los repositorios de los que las políticas de IAM le han otorgado acceso a las que pertenece mediante los grupos a las que pertenece. Si pertenece al grupo Administradores, puede obtener información sobre imágenes de cualquier repositorio en el arrendamiento.

    1. En la página de lista Registro de contenedor, seleccione el repositorio con el que desea trabajar en la lista Repositorios e imágenes. Si necesita ayuda para buscar la página de lista o el repositorio, consulte List Repositories.
      Se abre la sección de detalles del repositorio.
    2. Seleccione el repositorio en la lista Repositorios e imágenes por segunda vez.
      Las imágenes del repositorio, incluidos sus identificadores de versión, se muestran en el repositorio en la lista Repositorios e imágenes.
    3. Seleccione la imagen que desea.
      Se abre la sección de detalles de la imagen.
    4. Realice las siguientes tareas para ver los detalles de la imagen:
      • Seleccione el separador Información de imagen para ver el tamaño de la imagen, cuándo se ha transferido y qué usuario la ha transferido, así como el número de veces que se ha extraído la imagen.
      • Seleccione el separador Capas para ver el resumen del mensaje SHA de cada capa de la imagen seleccionada.
      • Seleccione el separador Versiones para ver la ruta completa de la imagen con el identificador de versión que seleccione. Tenga en cuenta que si selecciona un identificador de versión diferente, los detalles de resumen cambian en consecuencia.
      • Seleccione el separador Etiquetas para ver las etiquetas de formato libre y las etiquetas definidas aplicadas a la imagen. Para obtener más información, consulte Aplicación de etiquetas de formato libre y etiquetas definidas a repositorios, imágenes y firmas de imágenes.
      • Seleccione el separador Firmas para ver los detalles de las firmas creadas si la imagen se ha firmado. Para obtener más información, consulte Firma de imágenes por seguridad.
      • Seleccione el separador Resultados de exploración para ver un resumen de cada exploración de la imagen durante los últimos 13 meses. Para obtener más información, consulte Escaneado de imágenes para vulnerabilidades.
    5. (Opcional) Para extraer una imagen, seleccione Comando Copiar extracción. El comando que copia incluye la ruta de acceso completa a la ubicación de la imagen en Container Registry, con el formato <registry-domain>/<tenancy-namespace>/<repo-name>:<version>.

      Por ejemplo, docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test. Consulte Extracción de imágenes con la CLI de Docker.

  • Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte la Referencia de la línea de comandos.

    Mediante el OCID de la imagen para obtener detalles de la imagen:

    Utilice el comando oci Artefactos Container Image get y los parámetros necesarios para obtener los detalles de una imagen:

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

    Usando el URI de la imagen para obtener detalles de la imagen:

    Utilice el comando de consulta de imágenes de contenedor de artefactosoci y los parámetros necesarios para obtener detalles de una imagen:

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

    donde image-uri identifica una imagen concreta en un registro e incluye un identificador de versión, un resumen de imagen o ambos. Tenga en cuenta que image-uri no incluye un dominio de registro.

    Por ejemplo: 

    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...

  • Para utilizar el OCID de la imagen para obtener los detalles de la imagen, ejecute la operación GetContainerImage.

    Para utilizar el URI de la imagen para obtener detalles de la imagen, ejecute la operación LookupContainerImageByUri.