`runner registry`
Desde a v2.173.0. Gerencia a credencial de leitura do registry de uma app
com source: {type: registry}. O contexto completo está em
Deploy por imagem de registry.
O registry sai do image: do manifesto da app.
`runner registry login --password-stdin [--username U] [--json]`
Grava a credencial, cifrada no state da app.
| Flag | Descrição |
|---|---|
--password-stdin |
Obrigatória. A senha ou o token vem só do stdin, nunca do argumento. |
--username |
Usuário do registry. Padrão: runner. O ghcr aceita qualquer usuário com um PAT. O Docker Hub exige o seu. |
--json |
Saída em JSON. |
printf %s "$TOKEN" | runner registry login minha-api --password-stdin
printf %s "$TOKEN" | runner registry login minha-api --username devborlot --password-stdinO login valida antes de gravar: o token de leitura do registry e a leitura do repositório. Se falhar, nada é gravado e a credencial antiga fica.
O pull de imagem roda com um DOCKER_CONFIG temporário. O login do host não
é lido nem alterado.
`runner registry logout [--json]`
Apaga a credencial da app. O pull volta a ser anônimo.
`runner registry test [--json]`
Testa o acesso de leitura ao repositório da imagem, com a credencial gravada (ou anônimo, sem credencial). Sai com código 1 se falhar.
Erros comuns
| Código | Causa |
|---|---|
registry_auth_falhou |
Credencial recusada, ou sem permissão de leitura. |
registry_inacessivel |
O registry não respondeu. |
registry_repositorio_inexistente |
O repositório não existe, ou a credencial não o enxerga. |
registry_limite |
Limite de pulls (429). Docker Hub anônimo é o caso típico. |
By Borlot.com.br on 27/10/2026