O que é Registry?

O que é um registry

Registry é um serviço que armazena e distribui imagens de container. O processo de build pode enviar uma imagem para ele, permitindo que outra máquina obtenha o conteúdo necessário para criar suas instâncias.

Esse serviço pode ser público ou exigir autenticação e permissões. Você precisa conhecer o endereço e a referência da imagem, além de conferir se o ambiente de destino pode acessá-la.

Registry, repositório e tag

Dentro de um registry, um repositório agrupa imagens relacionadas, normalmente pelo nome de uma aplicação. As tags identificam referências dentro desse repositório, como uma versão ou um canal de distribuição.

Uma referência fictícia como registry.example.com/portal:1.4.0 combina o endereço do serviço, o repositório portal e a tag 1.4.0. O repositório de imagens tem outra função que o repositório Git, mesmo quando ambos aparecem na mesma plataforma.

Publicar e baixar são ações diferentes

O push envia a imagem ao registry, enquanto o pull obtém seu conteúdo para o ambiente local. Essas ações podem usar permissões diferentes, e uma credencial aceita para leitura não precisa ter autorização para substituir ou remover imagens.

O sucesso da autenticação também não garante acesso a todos os repositórios. Confira a permissão específica e o nome completo usado na chamada quando o serviço recusar uma publicação ou um download.

Tags podem mudar de associação

O registry pode permitir a associação de uma tag existente a outro conteúdo. Se dois servidores baixarem a mesma tag em momentos diferentes, poderão obter imagens distintas, conforme a política de publicação e o cache local.

O digest permite selecionar o conteúdo referenciado de forma mais precisa. Já a tag latest não significa automaticamente a versão mais recente ou estável, pois seu significado depende de como ela foi publicada.

Retenção afeta instalações futuras

Uma limpeza pode remover imagens antigas que ainda seriam necessárias para recuperar uma versão. O fato de um container continuar funcionando não comprova que outra máquina conseguirá baixar novamente a imagem usada por ele.

Defina a retenção de acordo com as versões que precisam continuar instaláveis. Confira também as dependências de acesso ao registry, pois uma falha de rede ou uma credencial expirada pode impedir a criação de novas instâncias durante uma recuperação.

O download não realiza o deploy

Obter uma imagem deixa seu conteúdo disponível, mas não substitui automaticamente containers já existentes. O deploy precisa selecionar o resultado e aplicar a atualização com as configurações do ambiente.

Compare a identidade publicada com aquela realmente usada pelas instâncias. Essa conferência permite localizar uma versão antiga em execução mesmo quando a imagem nova já está armazenada corretamente no registry.

Como conferir o percurso da imagem

Observe a saída do build, o envio ao repositório e o download pelo ambiente que fará a instalação. Cada etapa deve apontar para a imagem prevista, sem presumir que a conclusão de uma delas confirma as seguintes.

Quando a publicação falha entre a construção e a execução, o Desenvolvimento Colaborativo da Dev Side Studio pode orientar a investigação dessa tarefa ao vivo. O ponto de partida é a etapa que recusou a ação e a referência que o destino tentou obter.

Aplicação na formação

Formação DevOps

O registry armazena e distribui as imagens utilizadas para executar a aplicação em containers.

Conhecer a formação →