Documentação do Oracle Cloud Infrastructure

Obtendo Detalhes de uma Imagem

Descubra como obter detalhes de uma imagem em um repositório no Container Registry.

Para ter certeza de que você puxou a imagem correta ou identificar as imagens que não são mais necessárias, você pode obter informações detalhadas sobre as imagens no Container Registry.

Ao usar a CLI e a API, você pode usar o OCID da imagem ou o URI da imagem para identificar a imagem sobre a qual deseja obter informações.

Suas permissões controlam quais imagens você pode obter informações (consulte Políticas para Controlar o Acesso ao Repositório). Você pode obter informações sobre imagens em repositórios que você criou e em repositórios aos quais os grupos aos quais você pertence receberam acesso pelas políticas do serviço IAM. Se você pertencer ao grupo Administradores, poderá obter informações sobre imagens em qualquer repositório da tenancy.

    1. Na página de lista Container Registry, selecione o repositório com o qual você deseja trabalhar na lista Repositórios e imagens. Se precisar de ajuda para localizar a página de lista ou o repositório, consulte Listando Repositórios.
      A seção de detalhes do repositório é aberta.
    2. Selecione o repositório na lista Repositórios e imagens uma segunda vez.
      As imagens no repositório, incluindo seus identificadores de versão, são listadas no repositório na lista Repositórios e imagens.
    3. Selecione a imagem que deseja.
      A seção de detalhes da imagem é aberta.
    4. Execute as seguintes tarefas para ver os detalhes da imagem:
      • Selecione a guia Informações da imagem para ver o tamanho da imagem, quando ela foi enviada e por qual usuário e o número de vezes que a imagem foi extraída.
      • Selecione a guia Camadas para ver a compilação de mensagens SHA de cada camada na imagem selecionada.
      • Selecione a guia Versões para ver o caminho completo da imagem com o identificador de versão selecionado. Observe que, se você selecionar outro identificador de versão, os detalhes do resumo serão alterados adequadamente.
      • Selecione a guia Tags para ver as tags de formato livre e as tags definidas aplicadas à imagem. Para obter mais informações, consulte Aplicando Tags de Formato Livre e Tags Definidas a Repositórios, Imagens e Assinaturas de Imagem.
      • Selecione a guia Assinaturas para ver detalhes das assinaturas criadas se a imagem tiver sido assinada. Para obter mais informações, consulte Assinando Imagens para Segurança.
      • Selecione a guia Resultados da Verificação para ver um resumo de cada verificação da imagem nos últimos 13 meses. Para obter mais informações, consulte Verificando se Há Vulnerabilidades em Imagens.
    5. (Opcional) Para extrair uma imagem, selecione Copiar comando de extração. O comando copiado inclui o caminho totalmente qualificado para o local da imagem no Container Registry, no formato <registry-domain>/<tenancy-namespace>/<repo-name>:<version>.

      Por exemplo, docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test. Consulte Extraindo Imagens Usando a CLI do Docker.

  • Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

    Usando o OCID da imagem para obter detalhes da imagem:

    Use o comando oci artefatos container image get e os parâmetros necessários para obter detalhes de uma imagem:

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

    Usando o URI da imagem para obter detalhes da imagem:

    Use o comando oci arts Container Image Lookup e os parâmetros obrigatórios para obter detalhes de uma imagem:

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

    em que image-uri identifica uma imagem específica em um registro e inclui um identificador de versão, uma compilação de imagem ou ambos. Observe que o image-uri não inclui um domínio de registro.

    Por exemplo: 

    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 usar o OCID da imagem para obter detalhes da imagem, execute a operação GetContainerImage.

    Para usar o URI da imagem para obter detalhes da imagem, execute a operação LookupContainerImageByUri.