Skip to main content
O tool @registry-tags lista as tags publicadas de uma imagem de contêiner em registries OCI públicos e privados — Docker Hub, GCR, GHCR, Quay, ACR, Harbor e Artifactory. É keyless para imagens públicas e lê o ~/.docker/config.json para as privadas. Nenhuma imagem é baixada — só a API read-only de tags do registry é consultada, então é rápido e sem efeito colateral.
Use antes de referenciar um image:tag num Dockerfile, chart Helm ou manifesto Kubernetes — assim você confirma que a tag existe (e descobre quais existem) sem docker pull.

​
Uso

O registry é inferido a partir da referência da imagem; o Docker Hub é o default quando não há host. O LLM invoca @registry-tags automaticamente quando precisa validar ou descobrir tags.

​
Argumentos

Registries OCI como o GHCR listam as tags em ordem de push (mais antigas primeiro). Sem sort, o @registry-tags retorna as primeiras N — então as versões novas ficam de fora. Use sort: "newest" (ou last: 10): a busca pagina até o fim, ordena por versão (semver) e então corta para o limit. newest/oldest usam um comparador semver próprio (release > pre-release; tags não-versionadas vão por último); pushed inverte a ordem do registry.

​
Credenciais

Credenciais são opcionais. Quando omitidas, a ordem de resolução é:
1

Argumentos explícitos

username/password ou token passados na chamada.
2

~/.docker/config.json

A entrada auths (base64) ou identitytoken do registry correspondente — exatamente como o docker e o crane leem. (Os helpers credsStore/credHelpers não são invocados.)
3

Variáveis de ambiente

REGISTRY_USERNAME / REGISTRY_PASSWORD / REGISTRY_TOKEN.
Imagens públicas não precisam de credencial alguma.

​
Registries que gateiam leitura anônima

GHCR, Quay e GCR exigem um token mesmo para ler tags públicas. O @registry-tags faz a negociação de Bearer token do padrão OCI automaticamente (lê o desafio WWW-Authenticate, pega o token no realm e repete a chamada), então essas imagens retornam tags sem você configurar nada.

​
Saída

Uma tag por linha, com cabeçalho de imagem/host/contagem. Quando o número de tags excede o limit, a saída é truncada e o aviso é indicado:

​
Notas

  • É read-only e concurrency-safe — o orquestrador pode rodar vários @registry-tags em paralelo.
  • Segue paginação (Docker Hub next, OCI Link) até o limit, em vez de truncar silenciosamente na primeira página.
  • Usa o cliente HTTP compartilhado das web tools: respeita proxy corporativo (HTTPS_PROXY) e o trust de TLS global (CHATCLI_CA_BUNDLE).
  • Registries internos (registry.empresa.com, localhost:5000) funcionam — só endpoints de metadata de nuvem são bloqueados (proteção SSRF).
Combine com o Scheduler e o @send para ser avisado quando uma nova tag de uma imagem base que você acompanha for publicada.