{{site.data.keyword.attribute-definition-list}}

Formatação e filtragem da saída da CLI do {{site.data.keyword.registryshort_notm}}

Você pode formatar e filtrar a saída da interface de linha de comando (CLI) do site {{site.data.keyword.registrylong}} para os comandos compatíveis do site {{site.data.keyword.registrylong_notm}}.

Por padrão, a saída da CLI é exibida em um formato legível. No entanto, essa visualização poderá limitar a sua capacidade de usar a saída, especialmente se o comando for executado programaticamente. Por exemplo, na saída da CLI do ibmcloud cr image-list, você pode querer classificar o campo Size em ordem numérica, mas o comando retorna uma descrição de cadeia de caracteres. O plug-in container-registry CLI fornece a opção de formato que você pode usar para aplicar um modelo Go à saída da CLI.

É possível alterar a saída da CLI aplicando a opção de formato de duas maneiras diferentes:

  • Formate os dados em sua saída da CLI. Por exemplo, mude a saída do campo Created do horário UNIX® para o horário padrão.
  • Filtre os dados na saída da CLI. Por exemplo, filtre por detalhes da imagem para exibir um subconjunto específico de imagens usando a condição Go template if gt.

É possível usar a opção de formato com os comandos do {{site.data.keyword.registrylong_notm}} a seguir. Clique em um comando para visualizar uma lista de campos disponíveis e seus tipos de dados.

Opções de modelo Go para o ibmcloud cr image-digests

Examine a tabela a seguir para encontrar as opções de modelo Go disponíveis e os tipos de dados para o comando ibmcloud cr image-digests comando.

Campos e tipos de dados disponíveis no comando {{site.data.keyword.registryshort_notm
Campo Tipo Descrição
Created Número inteiro (64 bit) Essa opção exibe quando a imagem foi criada, expressa pelo número de segundos no horário UNIX.
Digest Sequência Essa opção exibe o identificador exclusivo de uma imagem.
ManifestType Sequência Essa opção exibe o tipo de manifesto da imagem.
Repository Sequência Essa opção exibe o repositório da imagem.
SecurityStatus Object Essa opção exibe o status de vulnerabilidade da imagem. É possível filtrar e formatar os seguintes valores:

  • Status string
  • IssueCount int
  • ExemptionCount int

Os possíveis status são descritos em Como revisar um relatório de vulnerabilidade usando a CLI.
Size Número inteiro (64 bit) Essa opção exibe o tamanho da imagem em bytes.
Tags Matriz de sequências Essa opção exibe as tags da imagem.

Exemplo de comando Go format para ibmcloud cr image-digests

Para exibir todas as imagens não marcadas referenciadas por seus resumos, execute o seguinte comando ibmcloud cr image-digests.

ibmcloud cr image-digests --format '{{if not .Tags}}{{.Repository}}@{{.Digest}}{{end}}'

A mensagem a seguir é um exemplo da saída do comando

example-<region>.icr.io/user1/my_first_repo@<digest1>
example-<region>.icr.io/user1/my_first_repo@<digest2>
example-<region>.icr.io/user1/my_first_repo@<digest3>

Opções de modelo Go para o ibmcloud cr image-list

Examine a tabela a seguir para encontrar as opções de modelo Go disponíveis e os tipos de dados para o comando ibmcloud cr image-list comando.

Campos e tipos de dados disponíveis no comando {{site.data.keyword.registryshort_notm
Campo Tipo Descrição
Created Número inteiro (64 bit) Essa opção exibe quando a imagem foi criada, expressa pelo número de segundos no horário UNIX.
Digest Sequência Essa opção exibe o identificador exclusivo de uma imagem.
ManifestType Sequência Essa opção exibe o tipo de manifesto da imagem.
Namespace Sequência Essa opção exibe o namespace em que a imagem está armazenada.
Repository Sequência Essa opção exibe o repositório da imagem.
SecurityStatus Object Essa opção exibe o status de vulnerabilidade da imagem. É possível filtrar e formatar os seguintes valores:

  • Status string
  • IssueCount int
  • ExemptionCount int

Os possíveis status são descritos em Como revisar um relatório de vulnerabilidade usando a CLI.
Size Número inteiro (64 bit) Essa opção exibe o tamanho da imagem em bytes.
Tag Sequência Essa opção exibe a tag da imagem.

Exemplo de comando Go format para ibmcloud cr image-list

Para exibir o repositório, a tag e o status de segurança de todas as imagens marcadas com mais de 1 MB, execute o seguinte comando ibmcloud cr image-list.

ibmcloud cr image-list --format "{{ if gt .Size 1000000 }}{{ .Repository }}:{{ .Tag }} {{ .SecurityStatus.Status }}{{end}}"

A mensagem a seguir é um exemplo da saída do comando:

example-<region>.icr.io/user1/my_first_repo:latest No Issues
example-<region>.icr.io/user1/my_second_repo:1 2 Issues
example-<region>.icr.io/user1/my_second_repo:test1 1 Issue
example-<region>.icr.io/user1/my_second_repo_2:test2 7 Issues

Se o comando listing images (listar imagens) apresentar um tempo limite, consulte Por que está apresentando um tempo limite quando listo imagens?

Opções de modelo Go para o ibmcloud cr image-inspect

Examine a tabela a seguir para encontrar as opções de modelo Go disponíveis e os tipos de dados para o comando ibmcloud cr image-inspect comando.

Campos e tipos de dados disponíveis no comando {{site.data.keyword.registryshort_notm
Campo Tipo Descrição
Architecture Sequência Essa opção exibe a arquitetura do processador que foi usada para criar essa imagem e que é necessária para executá-la.
Author Sequência Essa opção exibe o autor da imagem.
Comment Sequência Essa opção exibe a descrição da imagem.
Config Object Essa opção exibe os metadados de configuração da imagem. Para obter mais informações, consulte Detalhes do campo Config.
Container Sequência Essa opção exibe o ID do contêiner que criou a imagem.
ContainerConfig Object Essa opção exibe a configuração padrão para os contêineres que são iniciados a partir dessa imagem. Para obter mais informações, consulte Detalhes do campo Config.
Created Sequência Essa opção exibe o registro de data e hora do UNIX quando a imagem foi criada.
DockerVersion Sequência Essa opção exibe a versão do Docker que foi usada para criar essa imagem.
ID Sequência Essa opção exibe o identificador exclusivo de uma imagem.
Os Sequência Essa opção exibe a família do sistema operacional que foi usada para criar essa imagem e que é necessária para executá-la.
OsVersion Sequência Essa opção exibe a versão do sistema operacional que foi usada para criar essa imagem.
Parent Sequência Essa opção exibe o ID da imagem principal que foi usada para criar essa imagem.
RootFS Object Essa opção exibe os metadados que descrevem o sistema de arquivos raiz da imagem. Para obter mais informações, consulte Detalhes do campo RootFS.
Size Número inteiro (64 bit) Essa opção exibe o tamanho da imagem em bytes.
VirtualSize Número inteiro (64 bit) Essa opção exibe a soma dos tamanhos de cada camada da imagem em bytes.

Detalhes do campo Config

Campos e tipos de dados disponíveis no Config
Campo Tipo Descrição
ArgsEscaped Booleano Windows Essa opção será exibida como verdadeira se o comando tiver escape (específico do Windows®).
AttachStderr Booleano Essa opção será exibida como verdadeira se o fluxo de erro padrão estiver anexado ao contêiner e como falsa se não estiver.
AttachStdin Booleano Essa opção será exibida como verdadeira se o fluxo de entrada padrão estiver anexado ao contêiner e como falsa se não estiver.
AttachStdout Booleano Essa opção será exibida como verdadeira se o fluxo de saída padrão estiver anexado ao contêiner e como falsa se não estiver.
Cmd Matriz de sequências Essa opção descreve os comandos e argumentos que são passados a um contêiner para serem executados quando o contêiner é iniciado.
Domainname Sequência Essa opção exibe o nome de domínio totalmente qualificado do contêiner.
Entrypoint Matriz de sequências Essa opção descreve o comando que é executado quando o contêiner é iniciado.
Env Matriz de sequências Essa opção exibe a lista de variáveis de ambiente na forma de pares de valores-chave.
ExposedPorts Mapa do valor da chave Essa opção exibe a lista de portas expostas no formato [123:,456:].
Healthcheck Object Esta opção descreve como verificar se o contêiner está funcionando corretamente. Para obter mais informações, consulte Detalhes do campo Healthcheck.
Hostname Sequência Essa opção exibe o nome do host do contêiner.
Image Sequência Essa opção exibe o nome da imagem que foi passada pelo operador.
Labels Mapa do valor da chave Essa opção exibe a lista de rótulos que foram adicionados à imagem como pares de valores-chave.
MacAddress Sequência Essa opção exibe o endereço MAC atribuído ao contêiner.
NetworkDisabled Booleano Essa opção exibirá true se a rede estiver desativada para o contêiner e false se a rede estiver ativada para o contêiner.
OnBuild Matriz de sequências Essa opção exibe os metadados do ONBUILD que foram definidos no Dockerfile da imagem.
OpenStdin Booleano Essa opção exibe true (verdadeiro ) se o fluxo de entrada padrão estiver aberto e false (falso ) se o fluxo de entrada padrão estiver fechado.
Shell Matriz de sequências Essa opção exibe a forma de shell de RUN, CMD, ENTRYPOINT.
StdinOnce Booleano Essa opção exibe true se o fluxo de entrada padrão for fechado depois que o cliente conectado se desconectar e false se o fluxo de entrada padrão permanecer aberto.
StopSignal Sequência Essa opção descreve o sinal de parada do UNIX® a ser enviado quando o contêiner for parado.
StopTimeout Integer Essa opção exibe o tempo limite em segundos para parar um contêiner.
Tty Booleano Essa opção exibe true se um pseudo-tty estiver alocado para o contêiner e false se não estiver.
User Sequência Essa opção exibe o usuário que executa comandos dentro do contêiner em que a imagem é usada.
Volumes Mapa do valor da chave Essa opção exibe a lista de montagens de volume que estão montadas em um contêiner.
WorkingDir Sequência Essa opção exibe o diretório de trabalho que está dentro do contêiner em que os comandos especificados são executados.

Detalhes do campo Healthcheck

Campos e tipos de dados disponíveis no Health check
Campo Tipo Descrição
Interval Número inteiro (64 bit) Essa opção exibe o tempo de espera entre duas verificações de integridade em nanossegundos.
Retries Integer Essa opção exibe o número de falhas consecutivas que precisam ocorrer para considerar que um contêiner não está funcionando corretamente.
Test Matriz de sequências

Essa opção mostra como executar o teste de verificação de integridade. As seguintes opções estão disponíveis.

  • {} herda a verificação de funcionamento.
  • {"NONE"} a verificação de funcionamento está desativada.
  • {"CMD", args...} executa argumentos diretamente.
  • {"CMD-SHELL", command} executa o comando com o shell padrão do sistema.
Timeout Número inteiro (64 bit) Essa opção exibe o tempo de espera, em nanossegundos, antes que a verificação de integridade falhe.

Detalhes do campo RootFS

Campos e tipos de dados disponíveis no RootFS
Opção Tipo Descrição
BaseLayer Sequência Essa opção exibe o descritor da camada de base na imagem.
Layers Matriz de sequências Essa opção exibe os descritores de cada camada de imagem.
Type Sequência Essa opção exibe o tipo de sistema de arquivos.

Exemplo de comandos de formato Go para ibmcloud cr image-inspect

Os exemplos de código a seguir demonstram como você pode usar as opções de formatação e filtragem.

Exemplo 1 para ibmcloud cr image-inspect

Para exibir onde a documentação {{site.data.keyword.IBM_notm}} está hospedada para uma imagem pública {{site.data.keyword.IBM_notm}} especificada, execute o seguinte comando ibmcloud cr image-inspect.

ibmcloud cr image-inspect ibm_public_image --format "{{ .ContainerConfig.Labels }}"

A mensagem a seguir é um exemplo da saída do comando:

map[doc.url:/docs/images/docker_image_ibm_public_image/ibm_public_image_starter.html]

Exemplo 2 para ibmcloud cr image-inspect

Para exibir as portas expostas de uma imagem específica, execute o seguinte comando ibmcloud cr image-inspect.

ibmcloud cr image-inspect ibm_public_image --format "{{ .Config.ExposedPorts }}"

A mensagem a seguir é um exemplo da saída do comando:

map[9080/tcp: 9443/tcp:]