Conceito e mecanismo
Uma imagem é um artefacto de distribuição, enquanto o contentor acrescenta estado de execução. Em builds por etapas, compila numa etapa e copia os artefactos necessários para uma etapa final adequada. Confirma bibliotecas de runtime; copiar apenas o executável pode ser insuficiente.
A ordem do Dockerfile também afeta cache: manifestos de dependências estáveis devem preceder código que muda frequentemente quando essa separação é válida. EXPOSE documenta portas e não configura listeners ou publicação no host. Na forma exec, ENTRYPOINT define o executável e CMD fornece argumentos predefinidos que os argumentos de docker run podem substituir.
Testa o comando efetivo para evitar diagnósticos baseados apenas no ficheiro fonte.
Aplicação guiada
Numa entrega fictícia de um adaptador de pagamentos, regista o digest aprovado e a plataforma ensaiada. Um tag reutilizado pode passar a identificar conteúdo diferente sem mudar de nome. O digest ajuda a ligar aprovação ao artefacto, mas não demonstra ausência de vulnerabilidades nem substitui atualização de segurança.
Para publicar num registry privado, a referência deve incluir hostname, porta quando necessária e repositório correto; login trata autenticação, não renomeia automaticamente a imagem. Na expansão para workers arm64, confirma variantes disponíveis e dependências nativas.
Um manifest de múltiplas plataformas aponta para variantes diferentes. Renomear um tag não converte binários. O pipeline deve conservar evidência do que foi construído, testado e efetivamente instalado.
Tag release igual, digest diferente: o artefacto precisa de nova decisão de aceitação.
Armadilhas comuns
Tag como identidade imutável; EXPOSE como publicação; etapa final sem bibliotecas; nome arm64 como conversão.
Tópicos relacionados: Swarm: estado desejado, placement e quorum · Entregas, rollback e prontidão · Daemon, logs e recuperação
Constrói, identifica e valida o artefacto para a plataforma de destino.
Referências
- Dockerfile reference · EXPOSE and exec ENTRYPOINT/CMD semantics
- Multi-stage builds · Artifact copying between build stages
- Build cache invalidation · Instruction and input dependency cache boundaries
- Pull image · Digest-pinned image identity
- Tag image · Registry host/port and repository naming
- Multi-platform builds · Manifest lists and platform selection