Notas

Para saber mais sobre como usar a CLI do {{site.data.keyword.registryshort}} e os comandos do ibmcloud cr, consulte [Introdução ao {{site.data.keyword.registrylong_notm}}.

Você será notificado na linha de comando quando houver atualizações disponíveis para os plug-ins da CLI do ibmcloud e da CLI do container-registry. Certifique-se de manter suas interfaces de linha de comando (CLIs) atualizadas para poder utilizar todos os comandos e opções disponíveis. Se você quiser verificar a versão atual do seu plug-in da CLI do container-registry, execute o comando ibmcloud plugin list.

Para obter mais informações sobre a plataforma IAM e as funções de acesso aos serviços necessárias para alguns comandos do {{site.data.keyword.registryshort}}, consulte “Gerenciamento do acesso ao IAM para o {{site.data.keyword.registryshort_notm}} ”.

Não coloque informações pessoais em suas imagens de contêiner, nomes de namespace, campos de descrição ou em quaisquer dados de configuração de imagem (por exemplo, nomes de imagem ou rótulos de imagem).

Se os ibmcloud cr comandos {{site.data.keyword.registryshort_notm}} falharem com uma mensagem de erro informando que não são comandos registrados, consulte Por que os comandos {{site.data.keyword.registryshort_notm}}(ibmcloud cr)falham com uma mensagem informando que não estão registrados? para obter ajuda. Se os comandos falharem com uma mensagem informando que você não está conectado, consulte Por que não consigo fazer login em {{site.data.keyword.registryshort_notm}}? para obter ajuda.

Exemplos

Descubra os detalhes do ponto de extremidade da API de registro.

ibmcloud cr api

Saída

O comando no exemplo retorna a seguinte saída:

Registry API endpoint   https://us.icr.io/api
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--scope SCOPE

Para configurar sua conta como o escopo, use "*" como o valor.

Para configurar um namespace, um repositório, um resumo ou uma tag como escopo, insira o valor em um dos formatos a seguir:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

O tipo de problema de segurança que você deseja isentar. Para localizar tipos de problemas válidos, execute ibmcloud cr exemption-types.

--issue-id ISSUE_ID

O ID do problema de segurança que você deseja isentar. Para localizar um ID de problema, acesse ibmcloud cr va <image>, onde <image> é o nome da sua imagem, e utilize o valor correspondente da coluna “ID da vulnerabilidade ”.

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Crie uma isenção de CVE para o CVE com ID CVE-2018-17929 para todas as imagens no repositório us.icr.io/birds/bluebird inserindo us.icr.io/birds/bluebird para o escopo, cve para o tipo de problema e CVE-2018-17929 para o ID do problema.

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Crie uma isenção de CVE em toda a conta para o CVE com ID CVE-2018-17929 inserindo "*" para o escopo, cve para o tipo de problema e CVE-2018-17929 para o ID do problema.

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

Exemplo 1

Crie uma isenção de CVE para o CVE com ID CVE-2018-17929 para todas as imagens no repositório us.icr.io/birds/bluebird inserindo us.icr.io/birds/bluebird para o escopo, cve para o tipo de problema e CVE-2018-17929 para o ID do problema.

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Saída para o exemplo 1

O comando no exemplo 1 retorna a seguinte saída:

Creating exemption for 'CVE-2018-17929' in 'us.icr.io/birds/bluebird'...
OK

Exemplo 2

Crie uma isenção de CVE em toda a conta para o CVE com ID CVE-2018-17929 inserindo "*" para o escopo, cve para o tipo de problema e CVE-2018-17929 para o ID do problema.

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

Saída para o exemplo 2

O comando no exemplo 2 retorna a seguinte saída:

Creating exemption for 'CVE-2018-17929' in '*'...
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--scope SCOPE

(Opcional) Liste somente as isenções que se aplicarem a esse escopo.

Para configurar um namespace, um repositório, um resumo ou uma tag como escopo, insira o valor em um dos formatos a seguir:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Liste todas as suas isenções para problemas de segurança que se aplicam a imagens no repositório birds/bluebird inserindo birds/bluebird como o escopo.

A saída inclui isenções de toda a conta, isenções com escopo definido para o namespace birds e isenções com escopo definido para o repositório birds/bluebird. A saída não inclui isenções com escopo definido para tags específicas no repositório birds/bluebird.

ibmcloud cr exemption-list --scope birds/bluebird

Liste todas as suas isenções para questões de segurança que se aplicam a imagens no resumo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 inserindo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 como o escopo.

A saída inclui isenções válidas para toda a conta, isenções restritas ao namespace birds e isenções restritas ao repositório birds/bluebird e ao resumo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010. A saída não inclui isenções com escopo definido para tags específicas no repositório birds/bluebird.

ibmcloud cr exemption-list --scope birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010

Exemplo 1

Liste todas as suas isenções para problemas de segurança que se aplicam a imagens no repositório birds/bluebird inserindo birds/bluebird como o escopo.

ibmcloud cr exemption-list --scope birds/bluebird

Saída para o exemplo 1

A saída inclui isenções de toda a conta, isenções com escopo definido para o namespace birds e isenções com escopo definido para o repositório birds/bluebird. A saída não inclui isenções com escopo definido para tags específicas no repositório birds/bluebird.

O comando no exemplo 1 retorna a seguinte saída:

Listing exemptions for scope 'birds/bluebird'...
Scope              Issue type   Issue ID
*                  cve          CVE-2018-17929
birds              cve          CVE-2018-17929
birds/bluebird     cve          CVE-2018-17929
OK

Exemplo 2

Liste todas as suas isenções para questões de segurança que se aplicam a imagens no resumo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 inserindo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 como o escopo.

ibmcloud cr exemption-list --scope birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010

Saída para o exemplo 2

A saída inclui isenções válidas para toda a conta, isenções restritas ao namespace birds e isenções restritas ao repositório birds/bluebird e ao resumo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010. A saída não inclui isenções com escopo definido para tags específicas no repositório birds/bluebird.

O comando no exemplo 2 retorna a seguinte saída:

Listing exemptions for scope 'birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010'...
Scope                                       Issue type   Issue ID
*                                           cve          CVE-2018-17929
birds                                       cve          CVE-2018-17929
birds/bluebird                              cve          CVE-2018-17929
birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010          cve          CVE-2018-17929
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--scope SCOPE

Para configurar sua conta como o escopo, use "*" como o valor.

Para configurar um namespace, um repositório, um resumo ou uma tag como escopo, insira o valor em um dos formatos a seguir:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

O tipo de emissão para a isenção da emissão de títulos que você deseja remover. Para identificar os tipos de emissão correspondentes às suas isenções, acesse ibmcloud cr exemption-list.

--issue-id ISSUE_ID

O ID da isenção para o problema de segurança que você deseja remover. Para localizar os IDs de problema para suas isenções, execute ibmcloud cr exemption-list.

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Exclua uma isenção de CVE para o CVE com ID CVE-2018-17929 para todas as imagens no repositório us.icr.io/birds/bluebird inserindo us.icr.io/birds/bluebird como o escopo, cve como o tipo de problema e CVE-2018-17929 como o ID do problema.

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Exclua uma isenção de CVE em toda a conta para o CVE com ID CVE-2018-17929 inserindo "*" como o escopo, cve como o tipo de problema e CVE-2018-17929 como o ID do problema.

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

Exemplo 1

Exclua uma isenção de CVE para o CVE com ID CVE-2018-17929 para todas as imagens no repositório us.icr.io/birds/bluebird inserindo us.icr.io/birds/bluebird como o escopo, cve como o tipo de problema e CVE-2018-17929 como o ID do problema.

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Saída para o exemplo 1

O comando no exemplo 1 retorna a seguinte saída:

Deleting exemption for 'CVE-2018-17929' in 'us.icr.io/birds/bluebird'...
OK

Exemplo 2

Exclua uma isenção de CVE em toda a conta para o CVE com ID CVE-2018-17929 inserindo "*" como o escopo, cve como o tipo de problema e CVE-2018-17929 como o ID do problema.

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

Saída para o exemplo 2

O comando no exemplo 2 retorna a seguinte saída:

Deleting exemption for 'CVE-2018-17929' in '*'...
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Liste os tipos de problemas de segurança.

ibmcloud cr exemption-types

Saída

O comando no exemplo retorna a seguinte saída:

Listing exemption types...
Issue type      Description
cve             CVE
sn              Security Notice
configuration   Configuration Issue
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Exemplos

Use políticas de IAM para habilitar a autorização detalhada.

ibmcloud cr iam-policies-enable

Saída

O comando no exemplo retorna a seguinte saída:

Enabling IAM policies for account 'X's Account' in registry 'us.icr.io'...
OK

Exemplos

Mostrar o status da política de acesso IAM de sua conta.

ibmcloud cr iam-policies-status

Saída

O comando no exemplo retorna a seguinte saída:

IAM policy enforcement is enabled for account 'X's Account' in registry 'us.icr.io'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--format FORMAT

(Opcional) Formata os elementos de saída usando um modelo Go. Para obter mais informações, consulte Como formatar e filtrar a saída da CLI do {{site.data.keyword.registryshort}}.

--quiet, -q

(Opcional) Cada imagem é listada no formato: repository@digest

--output json, -o json

(Opcional) Gera a lista no formato JSON.

--restrict RESTRICTION

(Opcional) Limitar a saída para exibir apenas imagens no namespace ou no repositório especificado.

--include-ibm

(Opcional) Inclui imagens públicas fornecidas pelo {{site.data.keyword.IBM_notm}} na saída. Por padrão, apenas as imagens privadas são listadas. É possível visualizar as imagens fornecidas pela {{site.data.keyword.IBM_notm}} somente no registro global.

--no-va

(Opcional) Exclui os resultados do status de segurança do Vulnerability Advisor da saída. Se os resultados do status de segurança não forem necessários como parte de sua saída de ibmcloud cr image-digests, será possível usar esta opção para aumentar o desempenho.

--va

(Opcional) Inclui os resultados do status de segurança do Vulnerability Advisor na saída. Você pode usar a --va opção com a --restrict opção para receber apenas as informações de que precisa.

Exemplo

Exiba todas as imagens no espaço de nomes birds, incluindo imagens não marcadas, no formato repository@digest, usando --quiet para listar as imagens no formato repository@digest e inserindo birds como restrição.

ibmcloud cr image-digests --restrict birds --quiet

Saída

O comando no exemplo retorna a seguinte saída:

us.icr.io/birds/bluebird@sha256:11ab001ab10011cd1000101cd0101010001ab111100cd00ab1119f3de21ba0cd
us.icr.io/birds/blackbird@sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem para o qual deseja obter um relatório. É possível inspecionar múltiplas imagens listando cada imagem no comando com um espaço entre cada nome.

É possível identificar imagens usando a compilação <dns>/<namespace>/<repo>@<digest> ou por tag <dns>/<namespace>/<repo>:<tag>. Em que <dns> é o nome de domínio, <namespace> é o namespace, <repo> é o repositório, <digest> é a compilação, e <tag> é a tag.

Para localizar os nomes de suas imagens, execute um dos comandos a seguir:

• Para identificar a imagem por compilação, execute o comando ibmcloud cr image-digests. Combine o conteúdo da coluna Repositório (repository) e da coluna Compilação (digest) separada por um símbolo em (@) para criar o nome da imagem no formato repository@digest.
• Para identificar a imagem por tag, execute o comando ibmcloud cr image-list. Combine o conteúdo da coluna Repositório (repository) e da coluna Tag (tag) separada por dois pontos (:) para criar o nome da imagem no formato repository:tag. Se uma tag não for especificada no nome da imagem, a imagem identificada como latest será excluída por padrão.

Opções de comando

--format FORMAT

(Opcional) Formata os elementos de saída usando um modelo Go. Para obter mais informações, consulte Como formatar e filtrar a saída da CLI do {{site.data.keyword.registryshort}}.

Exemplos

Exiba detalhes sobre as portas expostas para a imagem us.icr.io/birds/bluebird:1 usando a diretiva de formatação "{{ .Config.ExposedPorts }}" e inserindo us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr image-inspect  --format "{{ .Config.ExposedPorts }}" us.icr.io/birds/bluebird:1

Saída

O comando no exemplo retorna a seguinte saída:

Inspecting 'us.icr.io/birds/bluebird:1'...
map[8080/tcp:{}]
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--format FORMAT

(Opcional) Formata os elementos de saída usando um modelo Go. Para obter mais informações, consulte Como formatar e filtrar a saída da CLI do {{site.data.keyword.registryshort}}.

--quiet, -q

(Opcional) Cada imagem é listada no formato: repository:tag

--restrict RESTRICTION

(Opcional) Limitar a saída para exibir apenas imagens no namespace ou no repositório especificado.

--include-ibm

(Opcional) Inclui imagens públicas fornecidas pelo {{site.data.keyword.IBM_notm}} na saída. Por padrão, apenas as imagens privadas são listadas. É possível visualizar as imagens fornecidas pela {{site.data.keyword.IBM_notm}} somente no registro global.

--no-trunc

(Opcional) Retorna a compilação de imagem em seu formato longo.

--show-type

(Opcional) Exibe o tipo de manifest da imagem.

--no-va

(Opcional) Exclui os resultados do status de segurança do Vulnerability Advisor da saída. Se os resultados do status de segurança não forem necessários como parte de sua saída de ibmcloud cr image-list, será possível usar esta opção para aumentar o desempenho.

--va

(Opcional) Inclui os resultados do status de segurança do Vulnerability Advisor na saída. Você pode usar a --va opção com a --restrict opção para receber apenas as informações de que precisa.

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplo

Exiba as imagens no namespace birds no formato repository:tag, sem truncar os resumos de imagem, usando --quiet para exibir a imagem no formato repository:tag, --no-trunc para exibir o resumo da imagem no formato longo e inserindo birds como restrição.

ibmcloud cr image-list --restrict birds --quiet --no-trunc

Saída

O comando no exemplo retorna a seguinte saída:

us.icr.io/birds/bluebird:1

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--force, -f

(Opcional) Forçar o comando a ser executado sem prompts de usuário.

--output json, -o json

(Opcional) Produz um JSON que contém os resultados da limpeza de suas imagens não identificadas. Essa opção deve ser usada com --force.

--restrict

(Opcional) Limitar a limpeza somente a imagens não identificadas no namespace ou repositório especificado.

Exemplos

Exclua todas as imagens não marcadas que estão no espaço de nomes birds sem nenhuma solicitação do usuário e produza os resultados no formato JSON usando a opção --force para forçar o comando a ser executado sem solicitações do usuário e inserindo --json como saída e birds como restrição.

ibmcloud cr image-prune-untagged [--force | -f [--json]] --restrict birds

Saída

O comando no exemplo retorna a seguinte saída:

Deleting untagged images in namespace 'birds'...
[
  {
    "Digest": "us.icr.io/birds/blackbird@sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0",
    "Status": "OK"
  }
]
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem que você deseja restaurar da lixeira.

Para localizar os nomes de suas imagens na lixeira, execute o comando ibmcloud cr trash-list.

É possível identificar imagens usando a tag ou a compilação. A imagem a ser restaurada pode ser referenciada por compilação <dns>/<namespace>/<repo>@<digest>, que restaura a compilação e todas as suas tags no mesmo repositório, ou por tag <dns>/<namespace>/<repo>:<tag>. Em que <dns> é o nome de domínio, <namespace> é o namespace, <repo> é o repositório, <digest> é a compilação, e <tag> é a tag.

As imagens ficam armazenadas na lixeira por 30 dias.

Exemplos

Restaure a imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr image-restore us.icr.io/birds/bluebird:1

Saída

O comando no exemplo retorna a seguinte saída:

Restoring image 'us.icr.io/birds/bluebird:1'...
Successfully restored image 'us.icr.io/birds/bluebird:1'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem que você deseja excluir. É possível excluir múltiplas imagens ao mesmo tempo listando cada imagem no comando com um espaço entre cada nome. É possível identificar imagens usando a compilação <dns>/<namespace>/<repo>@<digest> ou por tag <dns>/<namespace>/<repo>:<tag>. Em que <dns> é o nome de domínio, <namespace> é o namespace, <repo> é o repositório, <digest> é a compilação, e <tag> é a tag.

As imagens ficam armazenadas na lixeira por 30 dias.

Para localizar os nomes de suas imagens, execute um dos comandos a seguir:

• Para identificar a imagem por compilação, execute o comando ibmcloud cr image-digests. Combine o conteúdo da coluna Repositório (repository) e da coluna Compilação (digest) separada por um símbolo em (@) para criar o nome da imagem no formato repository@digest.
• Para identificar a imagem por tag, execute o comando ibmcloud cr image-list. Combine o conteúdo da coluna Repositório (repository) e da coluna Tag (tag) separada por dois pontos (:) para criar o nome da imagem no formato repository:tag. Se uma tag não for especificada no nome da imagem, a imagem identificada como latest será excluída por padrão.

Exemplos

Exclua a imagem us.icr.io/birds/bluebird:1 digitando us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr image-rm us.icr.io/birds/bluebird:1

Saída

O comando no exemplo retorna a seguinte saída:

Deleting image 'us.icr.io/birds/bluebird:1'...
Successfully deleted image 'us.icr.io/birds/bluebird:1'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

SOURCE_IMAGE

O nome da imagem de origem. É possível identificar imagens de origem usando a compilação <dns>/<namespace>/<repo>@<digest> ou por tag <dns>/<namespace>/<repo>:<tag>. Em que <dns> é o nome de domínio, <namespace> é o namespace, <repo> é o repositório, <digest> é a compilação, e <tag> é a tag.

TARGET_IMAGE

O nome da imagem de destino. TARGET_IMAGE deve estar no formato repository:tag, por exemplo, us.icr.io/namespace/image:latest.

Exemplos

Adicione outra referência de tag latest à imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem de origem e us.icr.io/birds/bluebird:latest como a imagem de destino.

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

Copie a imagem us.icr.io/birds/bluebird:peck para outro repositório no mesmo namespace birds/pigeon, digitando us.icr.io/birds/bluebird:peck como a imagem de origem e us.icr.io/birds/pigeon:peck como a imagem de destino.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

Copie a imagem us.icr.io/birds/bluebird:peck para outro namespace ao qual tenha acesso, neste exemplo, o namespace animals, digitando us.icr.io/birds/bluebird:peck como a imagem de origem e us.icr.io/animals/dog:bark como a imagem de destino.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

Exemplo 1

Adicione outra referência de tag latest à imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem de origem e us.icr.io/birds/bluebird:latest como a imagem de destino.

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

Saída para o exemplo 1

O comando no exemplo 1 retorna a seguinte saída:

Tagging 'us.icr.io/birds/bluebird:1' to 'us.icr.io/birds/bluebird:latest'...
OK

Exemplo 2

Copie a imagem us.icr.io/birds/bluebird:peck para outro repositório no mesmo namespace birds/pigeon, digitando us.icr.io/birds/bluebird:peck como a imagem de origem e us.icr.io/birds/pigeon:peck como a imagem de destino.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

Saída para o exemplo 2

O comando no exemplo 2 retorna a seguinte saída:

Tagging 'us.icr.io/birds/bluebird:peck' to 'us.icr.io/birds/pigeon:peck'...
OK

Exemplo 3

Copie a imagem us.icr.io/birds/bluebird:peck para outro namespace ao qual tenha acesso, neste exemplo, o namespace animals, digitando us.icr.io/birds/bluebird:peck como a imagem de origem e us.icr.io/animals/dog:bark como a imagem de destino.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

Resultado do exemplo 3

O comando do exemplo 3 retorna o seguinte resultado:

Tagging 'us.icr.io/birds/bluebird:peck' to 'us.icr.io/animals/dog:bark'...
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem da qual você deseja remover a tag. É possível excluir a tag de várias imagens ao mesmo tempo, listando cada imagem no comando com um espaço entre cada nome. IMAGE deve estar no formato repository:tag, por exemplo, us.icr.io/namespace/image:latest.

Para localizar os nomes de suas imagens, execute ibmcloud cr image-list. Combine o conteúdo da coluna Repositório (repository) e da coluna Tag (tag) separada por dois pontos (:) para criar o nome da imagem no formato repository:tag. Se uma tag não estiver especificada no nome da imagem, o comando falhará.

Exemplos

Remova a tag 1 da imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr image-untag us.icr.io/birds/bluebird:1

Saída

O comando no exemplo retorna a seguinte saída:

Removing tag for image 'us.icr.io/birds/bluebird:1'...
Successfully removed tag '1' from image 'us.icr.io/birds/bluebird:1'.
OK

Opções de comando

--verbose

(Opcional) Exibir informações adicionais sobre o ambiente do Registro.

Exemplos

Localize o nome e a conta do registro.

ibmcloud cr info

Saída

O comando no exemplo retorna a seguinte saída:

Plugin version                    1.3.16
Container Registry                us.icr.io
Container Registry API endpoint   https://us.icr.io/api
IBM Cloud API endpoint            https://cloud.ibm.com
IBM Cloud account details         X's Account (1100110011001100)
OK

Opções de comando

--client CLIENT

(Opcional) Selecione o cliente que você deseja efetuar login. Os valores válidos são docker e podman. Se essa opção não for usada e o Docker for instalado, o padrão será docker; se o Docker não for instalado, o padrão será podman.

Exemplos

Para fazer login no registro usando Podman, digite podman como o cliente.

ibmcloud cr login --client podman

Saída

O comando no exemplo retorna a seguinte saída:

Logging 'podman' in to 'us.icr.io'...
Logged in to 'us.icr.io'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem para a qual você deseja inspecionar o manifest. É possível identificar imagens usando a compilação <dns>/<namespace>/<repo>@<digest> ou por tag <dns>/<namespace>/<repo>:<tag>. Em que <dns> é o nome de domínio, <namespace> é o namespace, <repo> é o repositório, <digest> é a compilação, e <tag> é a tag.

Para localizar os nomes de suas imagens, execute um dos comandos a seguir:

• Para identificar a imagem por compilação, execute o comando ibmcloud cr image-digests. Combine o conteúdo da coluna Repositório (repository) e da coluna Compilação (digest) separada por um símbolo em (@) para criar o nome da imagem no formato repository@digest.
• Para identificar a imagem por tag, execute o comando ibmcloud cr image-list. Combine o conteúdo da coluna Repositório (repository) e da coluna Tag (tag) separada por dois pontos (:) para criar o nome da imagem no formato repository:tag.

Opções de comando

--quiet, -q

(Opcional) Reduz a saída para exibir apenas elementos essenciais.

Exemplos

Visualize o conteúdo do manifesto da imagem us.icr.io/birds/bluebird:1 digitando us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr manifest-inspect us.icr.io/birds/bluebird:1

Saída

O comando no exemplo retorna a seguinte saída:

{
   "schemaVersion": 2,
   "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
   "config": {
      "mediaType": "application/vnd.docker.container.image.v1+json",
      "size": 1470,
      "digest": "sha256:11ab001ab10011cd1000101cd0101010001ab111100cd00ab1119f3de21ba0cd"
   },
   "layers": [
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 2479088,
         "digest": "sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0"
      }
   ]
}

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte “Funções de gerenciamento da plataforma ” e “Funções de acesso para configurar o {{site.data.keyword.registryshort}} ”.

Argumento do Comando

NAMESPACE

O namespace que você deseja incluir. O namespace deve ser exclusivo em todas as contas do {{site.data.keyword.cloud_notm}} na mesma região. Os namespaces devem ter de 4 a 30 caracteres e conter apenas letras minúsculas, números, hífens (-) e sublinhados (_). Os namespaces devem iniciar e terminar com uma letra ou número.

Não coloque informações pessoais nos nomes de namespace.

Opções de comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(Opcional) Especifique o nome ou ID do grupo de recursos no qual você deseja incluir o namespace. Se você não configurar essa opção, o grupo de recursos de destino será usado. Se você não configurar essa opção e um grupo de recursos não estiver destinado, o grupo de recursos padrão para a conta será usado.

Exemplos

Crie um espaço de nome com o nome birds2 e adicione-o ao grupo de recursos beaks, digitando beaks como o nome do grupo de recursos e birds2 como o espaço de nome.

ibmcloud cr namespace-add -g beaks birds2

Saída

O comando no exemplo retorna a seguinte saída:

Adding namespace 'birds2' in resource group 'beaks' for account X's Account in registry us.icr.io...
Successfully added namespace 'birds2'
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte “Funções de gerenciamento da plataforma ” e “Funções de acesso para configurar o {{site.data.keyword.registryshort}} ”.

Argumento do Comando

NAMESPACE

O namespace que você deseja designar a um grupo de recursos.

Opções de comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(Opcional) Especifique o nome ou ID do grupo de recursos ao qual você deseja designar o namespace. Se você não configurar essa opção, o grupo de recursos de destino será usado.

Exemplos

Atribua um espaço de nome com o nome birds ao grupo de recursos beaks, digitando beaks como o nome do grupo de recursos e birds como o espaço de nome.

ibmcloud cr namespace-assign -g beaks birds

Saída

O comando no exemplo retorna a seguinte saída:

Assigning namespace 'birds' to resource group 'beaks' for account X's Account in registry us.icr.io...
Successfully assigned namespace 'birds' to resource group 'beaks.'
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--verbose, -v

(Opcional) Listar todos os namespaces e incluir informações sobre o grupo de recursos e a data de criação do namespace.

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Visualize uma lista de todos os seus namespaces, incluindo informações sobre grupos de recursos e datas de criação, usando a opção “ --verbose ”.

ibmcloud cr namespace-list -v

Saída

O comando no exemplo retorna a seguinte saída:

Listing namespaces for account 'X's Account' in registry 'us.icr.io'...
Namespace   Resource Group   Created
birds       default          1 year ago
birds2      beaks            40 seconds ago
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Argumento do Comando

NAMESPACE

O namespace que deseja remover.

Opções de comando

--force, -f

(Opcional) Forçar o comando a ser executado sem prompts de usuário.

Exemplos

Remova o espaço de nome birds inserindo birds como o espaço de nome.

ibmcloud cr namespace-rm birds

Saída

O comando no exemplo retorna a seguinte saída:

Removing namespace 'birds'...
Successfully removed namespace 'birds'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Envie seu plano de preços no formato JSON inserindo json como saída.

ibmcloud cr plan -o json

Saída

O comando no exemplo retorna a seguinte saída:

{
	"plan": "Free"
}

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Argumento do Comando

PLAN

(Opcional) O nome do plano de precificação para o qual você deseja fazer upgrade. Se PLAN não for especificado, o padrão será standard.

Exemplos

Faça upgrade para o plano de preços padrão inserindo standard como o plano.

ibmcloud cr plan-upgrade standard

Saída

O comando no exemplo retorna a seguinte saída:

Upgrading account to 'standard' plan in registry 'us.icr.io'...
OK

Pré-requisitos

• Deve-se configurar o {{site.data.keyword.mon_full_notm}}, consulte Tutorial de introdução para o {{site.data.keyword.mon_full_notm}}.
• Ative sua instância do {{site.data.keyword.mon_full_notm}} para as métricas de plataforma.
• Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--enable

(Opcional) Ative a configuração para sua conta.

--disable

(Opcional) Desative a configuração para sua conta.

--status

(Opcional) Exiba se a configuração estiver ativada para a sua conta.

Exemplos

Ative as métricas da plataforma para sua conta usando a opção --enable.

ibmcloud cr platform-metrics --enable

Saída

O comando no exemplo retorna a seguinte saída:

OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--enable

(Opcional) Evitar pulls ou pushes de imagem em conexões de rede pública para sua conta.

--disable

(Opcional) Restabelecer pulls ou pushes de imagem em conexões de rede pública para a sua conta.

--status

(Opcional) Verificar se o uso de conexões públicas é evitado para pushes ou pulls de imagem em sua conta.

Exemplos

Evite a extração ou envio de imagens por conexões de rede pública para sua conta usando a opção --enable.

ibmcloud cr private-only --enable

Saída

O comando no exemplo retorna a seguinte saída:

Enabling private-only networking for account 'X's Account' in registry 'us.icr.io'...
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Exiba suas cotas de tráfego e armazenamento no formato JSON, digitando json como opção de saída.

ibmcloud cr quota -o json

Saída

O comando no exemplo retorna a seguinte saída:

{
	"usage": {
		"traffic": 0,
		"store": 0
	},
	"limit": {
		"traffic": 5368709120,
		"store": 536870912
	}
}

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para configurar o {{site.data.keyword.registryshort}}.

Opções de comando

--traffic TRAFFIC

(Opcional) Muda sua cota de tráfego para o valor especificado em megabytes. A operação falhará se você não estiver autorizado a configurar o tráfego ou se configurar um valor que exceda o seu plano de precificação atual.

--storage STORAGE

(Opcional) Muda sua cota de armazenamento para o valor especificado em megabytes. A operação falhará se você não estiver autorizado a configurar cotas de armazenamento ou se configurar um valor que exceda o seu plano de precificação atual.

Exemplos

Defina o limite de cota para tráfego pull para 7000 megabytes e para armazenamento para 600 megabytes, digitando 7000 como cota de tráfego e 600 como cota de armazenamento.

ibmcloud cr quota-set --traffic 7000 --storage 600

Saída

O comando no exemplo retorna a seguinte saída:

Setting quotas: 'storage: 600 , traffic: 7000'...
OK

Exemplos

Descubra qual é a região e o registro que você está almejando.

ibmcloud cr region

Saída

O comando no exemplo retorna a seguinte saída:

You are targeting region 'us-south', the registry is 'us.icr.io'.
OK

Argumento do Comando

REGION

(Opcional) O nome da sua região de destino, por exemplo, us-south. Para obter mais informações, consulte Regiões.

Exemplos

Segmente a região de Dallas inserindo us-south como a região.

ibmcloud cr region-set us-south

Saída

O comando no exemplo retorna a seguinte saída:

The region is set to 'us-south', the registry is 'us.icr.io'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--output json, -o json

(Opcional) Gera a lista no formato JSON.

Exemplos

Liste as políticas de retenção em sua conta no formato JSON, digitando json como saída.

ibmcloud cr retention-policy-list -o json

Saída

O comando no exemplo retorna a seguinte saída:

{
	"birds": {
		"namespace": "birds",
		"account": "",
		"images_per_repo": 10,
		"deletion_threshold_days": 365,
		"retain_untagged": false
	},
	"birds2": {
		"namespace": "birds2",
		"account": "",
		"images_per_repo": -1,
		"retain_untagged": true
	}
}

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

NAMESPACE

O namespace para o qual você deseja criar uma política.

Opções de comando

--retain-untagged

(Opcional) Reter todas as imagens não identificadas quando a política de retenção estiver sendo processada. Somente as imagens identificadas serão analisadas e se elas não atenderem aos critérios, serão excluídas. Se a opção não for especificada, todas as imagens identificadas e não identificadas serão analisadas e se as imagens não atenderem aos critérios, elas serão excluídas.

--deletion-threshold-days

(Opcional) Define a idade mínima, em dias, que uma imagem deve atingir antes que a política de retenção possa excluí-la. Imagens com data posterior a DAYS são sempre mantidas, mesmo que isso faça com que o número de imagens ultrapasse o valor definido em --images. DAYS deve ser um número inteiro positivo. O valor padrão é 0``, o que significa que não há limite aplicado.

--force, -f

(Opcional) Forçar o comando a ser executado sem prompts de usuário.

--images

Determina quantas imagens são mantidas dentro de cada repositório no namespace especificado. As imagens mais recentes são retidas. A idade das imagens é determinada por sua data de construção. IMAGE_COUNT é a quantidade de imagens que você deseja reter em cada repositório para o namespace. Para restaurar uma política ao estado padrão, que mantém todas as imagens definidas como IMAGE_COUNT para All.

Exemplo 1

Defina uma política que retenha as 20 imagens mais recentes de cada repositório no espaço de nomes birds, digitando 20 como o número de imagens a serem mantidas e birds como o espaço de nomes. Analise todas as imagens marcadas e não marcadas. Se as imagens não atenderem aos critérios, elas serão excluídas.

ibmcloud cr retention-policy-set --images 20 birds

Saída para o exemplo 1

O comando no exemplo 1 retorna a seguinte saída:

Found n images to delete.
OK
A scheduled retention policy is set that keeps 20 images in each repository in birds and retain-untagged is set to false.
OK

Exemplo 2

Defina uma política que mantenha as 10 imagens mais recentes em cada repositório no namespace birds, mas que proteja contra exclusão qualquer imagem com menos de 90 dias, mesmo que a retenção dessas imagens exceda o limite de 10.

ibmcloud cr retention-policy-set --images 10 --deletion-threshold-days 90 birds

Saída para o exemplo 2

O comando no exemplo 2 retorna a seguinte saída:

Found n images to delete.
OK
A scheduled retention policy is set that keeps 10 images in each repository in birds, with a deletion threshold of 90 days, and retain-untagged is set to false.
OK

Exemplo 3

Reverta a política para o estado padrão para que você mantenha todas as suas imagens no espaço de nome birds inserindo All como o número de imagens a serem mantidas e birds como o espaço de nome.

ibmcloud cr retention-policy-set --images All birds

Resultado do exemplo 3

O comando do exemplo 3 retorna o seguinte resultado:

The retention policy to keep all images in birds is set.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

NAMESPACE

O namespace que você deseja limpar.

Opções de comando

--force, -f

(Opcional) Forçar o comando a ser executado sem prompts de usuário.

--output json, -o json

(Opcional) Saídas JSON que contêm os resultados da limpeza de seu namespace. Essa opção deve ser usada com --force.

--retain-untagged

(Opcional) Reter todas as imagens não identificadas quando a política de retenção estiver sendo processada. Somente as imagens identificadas serão analisadas e se elas não atenderem aos critérios, serão excluídas. Se a opção não for especificada, todas as imagens identificadas e não identificadas serão analisadas e se as imagens não atenderem aos critérios, elas serão excluídas.

--deletion-threshold-days

(Opcional) Define a idade mínima, em dias, que uma imagem deve atingir antes que a execução da retenção possa excluí-la. Imagens com data posterior a DAYS são sempre mantidas, mesmo que isso faça com que o número de imagens ultrapasse o valor definido em --images. DAYS deve ser um número inteiro positivo. O valor padrão é 0``, o que significa que não há limite aplicado.

--images

Determina quantas imagens são mantidas dentro de cada repositório no namespace especificado. As imagens mais recentes são retidas. A idade das imagens é determinada por sua data de construção. IMAGE_COUNT é a quantidade de imagens que você deseja reter em cada repositório para o namespace.

Exemplos

Mantenha as 20 imagens mais recentes de cada repositório no espaço de nome birds, digitando 20 como o número de imagens a serem mantidas e birds como o espaço de nome.

ibmcloud cr retention-run --images 20 birds

Saída

O comando no exemplo retorna a seguinte saída:

Retrieving images to delete from namespace 'birds' in registry us.icr.io'...
Found n images to delete.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Opções de comando

--restrict NAMESPACE

(Opcional) Limite a saída para exibir apenas imagens no namespace especificado.

--output json, -o json

(Opcional) Gera JSON que contém os detalhes do conteúdo da lixeira.

Exemplos

Exiba as imagens que estão na lixeira do espaço de nome birds, digitando birds como restrição.

ibmcloud cr trash-list --restrict birds

Saída

O comando no exemplo retorna a seguinte saída:

Listing the contents of the trash...
Digest   Days until expiry   Tags
110011   24                  1
OK

Exemplos

Saiba qual versão do Vulnerability Advisor você está usando.

ibmcloud cr va-version

Saída

O comando no exemplo retorna a seguinte saída:

You are targeting Vulnerability Advisor version 'v4'.
OK

Argumento do Comando

VERSION

(Opcional) A versão do Vulnerability Advisor que você deseja usar. O único valor válido é v4. Se VERSION não for especificado, o padrão é v4.

Exemplos

Defina a versão de Vulnerability Advisor para a versão 4, digitando v4 como a versão:

ibmcloud cr va-version-set v4

Saída

O comando no exemplo retorna a seguinte saída:

You are targeting Vulnerability Advisor version 'v4'.
OK

Pré-requisitos

Para saber mais sobre as permissões necessárias, consulte Funções de acesso para usar o {{site.data.keyword.registryshort}}.

Argumento do Comando

IMAGE

O nome da imagem para o qual deseja obter um relatório. O relatório indica se a imagem tem qualquer vulnerabilidade de pacote conhecida. É possível solicitar relatórios para múltiplas imagens ao mesmo tempo listando cada imagem no comando com um espaço entre cada nome.

Para localizar os nomes de suas imagens, execute ibmcloud cr image-list. Combine o conteúdo da coluna Repositório (repository) e da coluna Tag (tag) separada por dois pontos (:) para criar o nome da imagem no formato repository:tag. Se uma tag não for especificada no nome da imagem, o relatório avaliará a imagem identificada como latest.

Para obter mais informações sobre as imagens base do Docker suportadas, consulte Pacotes vulneráveis.

Para obter mais informações, consulte Gerenciando a segurança da imagem com o Vulnerability Advisor.

Opções de comando

--extended, -e

(Opcional) A saída de comando mostra informações adicionais sobre correções para pacotes vulneráveis.

--vulnerabilities, -v

(Opcional) A saída de comando é restrita para mostrar somente as vulnerabilidades.

--output FORMAT, -o FORMAT

(Opcional) A saída de comando é retornada no formato escolhido. O formato padrão é text.

Os seguintes formatos são suportados:

• text
• json

Exemplos

Visualize um relatório de avaliação de vulnerabilidade padrão para a imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

Visualize um relatório de avaliação de vulnerabilidade que mostre as vulnerabilidades da imagem us.icr.io/birds/bluebird:1 no formato JSON usando a opção -- vulnerabilities e inserindo json como o formato da saída e us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr vulnerability-assessment --vulnerabilities --output json us.icr.io/birds/bluebird:1

Exemplo 1

Visualize um relatório de avaliação de vulnerabilidade padrão para a imagem us.icr.io/birds/bluebird:1 inserindo us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

Saída para o exemplo 1

O comando no exemplo 1 retorna a seguinte saída:

Checking security issues for 'us.icr.io/birds/bluebird:1'...
Image                              Current   Configuration Issues   Vulnerabilities
us.icr.io/birds/bluebird:1         OK        0                      0
OK

Exemplo 2

Visualize um relatório de avaliação de vulnerabilidade que mostre as vulnerabilidades da imagem us.icr.io/birds/bluebird:1 no formato JSON usando a opção -- vulnerabilities e inserindo json como o formato da saída e us.icr.io/birds/bluebird:1 como a imagem.

ibmcloud cr vulnerability-assessment --vulnerabilities --output json us.icr.io/birds/bluebird:1

Saída para o exemplo 2

O comando no exemplo 2 retorna a seguinte saída:

[
  {
    "image": "us.icr.io/birds/bluebird:1",
    "vulnerabilities": [],
    "status": "OK"
  }
]