Docker & Containers

Analisador de referência Dockerconfira o destino e a seleção do conteúdo

Analise uma referência ou monte seus campos. Veja os valores padrão e a prioridade do digest antes de copiar.

Analisador de referência Docker

Referência ou campos

As referências ficam neste navegador. Sem consulta ao registro, envio de dados ou acesso ao daemon do Docker.

Referência analisada

Informe uma referência ou caminho de repositório.

Modo de entrada e exemplos

Cada modo mantém seu rascunho. Deixe o registro vazio para Docker Hub e informe o caminho completo do repositório separadamente. host:5000 identifica um registro sem ambiguidade.

Uma referência, até 4.096 caracteres. Caminho do repositório: 255; tag: 128. Digests sha256/384/512 completos em hexadecimal minúsculo.

Aguardando para analisar a entrada mais recente…

Este Analisador de referência Docker ajuda a entender por que uma implantação procura o registro errado. Em registry.example.com:5000/team/api:v2, os dois sinais de dois-pontos separam uma porta e uma tag. Dividir a entrada no primeiro deles perde essa distinção.

Compare o nome curto com o exemplo de registro privado. O caminho do repositório fica separado da seleção do conteúdo, sem alterar o texto original. Isso facilita identificar um host ausente ou um latest acrescentado sem intenção.

Por que usar este Analisador de referência Docker?

Enxergar os padrões que foram acrescentados

Este Analisador de referência Docker expande nginx para docker.io/library/nginx:latest. As indicações mostram o que foi adicionado e o que você informou. Caminhos em registros privados não recebem library indevidamente, permitindo conferir o destino antes de alterar uma configuração.

Uma referência curta se expande em componentes coloridos de registro, repositório e tag

Preservar a tag e destacar o digest

Uma referência pode conter os dois seletores. A forma normalizada mantém ambos para revisão, enquanto a referência efetiva mostra a seleção pelo digest. A tag visível não representa uma confirmação de que ela corresponde ao conteúdo informado.

Uma tag móvel e uma impressão digital fixa apontam para um contêiner, com a impressão digital determinando a seleção

Leia os separadores e confira os valores omitidos

01

Observe o primeiro segmento antes da barra

Um ponto, dois-pontos, letra maiúscula ou localhost nesse segmento identifica o registro. Sem barra, até localhost é um nome de repositório no Docker Hub. Já registry/api em minúsculas, sem porta, usa um namespace.

02

Use o campo certo para cada parte

Trocar de modo mantém o outro rascunho. O repositório inclui o namespace, mas :tag e @digest vão nos campos próprios. Registro vazio significa Docker Hub; isso não procura nem reconhece automaticamente um servidor local.

03

Exporte apenas o resultado atualizado

A análise automática aguarda 350 ms após a edição. Desative-a para mostrar o botão, ou use Ctrl/Cmd + Enter. Exemplos e limpeza mostram uma prévia; desfazer recupera uma vez a entrada e o resultado juntos.

Do endereço do registro ao seletor de conteúdo

Interpretar nomes curtos do Docker Hub

docker.io, library e latest são incluídos apenas nas condições correspondentes. index.docker.io é normalizado para docker.io. A tag mantém maiúsculas e minúsculas; uma letra maiúscula no caminho do repositório causa erro em vez de ser corrigida silenciosamente.

Verificar partes com regras próprias

O nome da imagem pode incluir host, porta numérica ou um registro IPv6 puro entre colchetes. Separadores de caminho, caracteres de tag e comprimento do digest são verificados separadamente, evitando tratar um hash truncado como se fosse uma versão.

Montar e exportar a mesma interpretação

Registro, repositório, tag e digest passam pelas mesmas regras no modo de campos e no texto livre. Copie uma das referências ou exporte os campos e as indicações de padrões em JSON. Alterações na entrada ou no modo bloqueiam a exportação até que o rascunho atual seja processado com sucesso.

O que uma sintaxe válida não garante

Sem inspeção da imagem remota
Não são verificados registro, permissões, manifestos, arquitetura, assinaturas nem vulnerabilidades. Montar aqui significa compor uma referência textual; não cria arquivos de imagem nem executa pull, run ou push.
Sem resolver tag para digest
latest só é adicionado quando tag e digest estão ausentes. Um digest informado determina a seleção, mas não comprova a correspondência com a tag. Nenhum hash é calculado e o registro não é consultado para descobrir essa relação.
Uma referência com nome por vez
Não há extração de imagens de Dockerfile, Compose, Kubernetes, arquivos compactados ou listas. Espaços externos são removidos; espaços internos, credenciais, esquemas de URL e variáveis não expandidas são rejeitados. Um ID isolado não permite inferir o repositório.
Limites de caracteres e algoritmos
A entrada ativa aceita 4.096 caracteres, o caminho normalizado 255 e a tag de 1 a 128 caracteres ASCII permitidos, sem ponto ou hífen inicial. Somente sha256/384/512 completos em hexadecimal minúsculo são aceitos. Identificadores de zona IPv6 e formas mistas com IPv4 pontuado ficam de fora. A porta numérica não passa por teste de conexão.

Perguntas sobre o Analisador de referência Docker

Por que o Docker mostra repository name must be lowercase?

Os segmentos do caminho do repositório precisam estar em minúsculas; a tag pode conter maiúsculas. Confira o namespace e o nome antes do separador da tag. A ferramenta informa o problema em vez de alterar o caminho e ocultar um possível erro de digitação no destino.

O Docker confere se a tag e o digest correspondem quando os dois são informados?

Não conte com essa verificação. Quando ambos aparecem, o digest determina a seleção. A saída normalizada preserva a tag e a efetiva a omite. Se precisar comprovar a correspondência, consulte separadamente os metadados reais do registro.

Como saber qual versão a tag latest realmente aponta?

latest é uma tag definida por quem publica a imagem, não uma instrução para calcular a maior versão semântica. Seu destino pode mudar. Aqui a tag é exibida literalmente; descobrir o digest atual exige consultar o registro fora desta ferramenta.

Por que meu registro local tenta enviar imagens para docker.io?

Em registry/api, o primeiro segmento é minúsculo e não tem ponto nem porta, por isso Docker o interpreta como namespace. Confira se deveria usar registry:5000/api ou um host completo. O modo de campos rejeita essa ambiguidade para não gerar um destino inesperado no Docker Hub.

Qual é a diferença entre o ID da imagem e seu digest?

O ID local identifica o conteúdo de configuração da imagem; um digest do registro pode identificar um manifesto ou índice de imagens. Esses hashes normalmente não são intercambiáveis. Informe o repositório seguido de @ e do digest correspondente; a ferramenta não deriva um identificador do outro.

Ficou alguma dúvida?

Confira a próxima referência

Use o Analisador de referência Docker para revisar o destino e o seletor juntos. Copie a referência efetiva depois que o rascunho atual passar pela validação.