Como Publicar Imagens Docker no DockerHub

O DockerHub é o padrão da indústria para armazenamento e distribuição de imagens. Neste guia, vamos aprender o fluxo completo: build, tag e push.

Pré-requisitos

• Ter o Docker instalado e configurado em sua máquina.
• Ter uma conta criada no DockerHub.

0. Autenticação (Login)

Antes de enviar qualquer imagem, você precisa autenticar seu terminal no DockerHub. Execute:

docker login

Digite seu nome de usuário e senha (ou token de acesso) quando solicitado.

1. Build da Imagem

Navegue até a pasta do seu projeto (onde está o seu Dockerfile) e execute o build. Usaremos a flag -t para definir o nome e a tag da imagem.

docker build -t hostaqui/<nome_projeto>:latest .

• hostaqui/: Substitua pelo seu namespace ou nome de usuário no DockerHub.
• <nome_projeto>: Nome do repositório que será criado.
• :latest: A tag padrão para indicar que esta é a versão mais recente.

2. Envio da Imagem (Push)

Com a imagem construída, envie-a para o seu repositório remoto:

docker push hostaqui/<nome_projeto>:latest

3. Versionamento (Tagging)

Enviar apenas a tag latest não é uma boa prática para ambientes de produção, pois ela pode ser sobrescrita facilmente. Vamos criar uma versão imutável (ex: 0.0.1):

# Sintaxe: docker tag <nome_imagem_original> <novo_nome_com_tag>
docker tag hostaqui/<nome_projeto>:latest hostaqui/<nome_projeto>:0.0.1

4. Envio da Imagem Versionada

Agora, envie a nova versão específica para o DockerHub:

docker push hostaqui/<nome_projeto>:0.0.1

Dicas de Especialista (DevOps)

Por que versionar? Ao utilizar 0.0.1, você garante reprodutibilidade. Se houver um erro na versão 0.0.2, você pode facilmente reverter seu container para a 0.0.1 sem depender da tag latest, que pode ter sido alterada.

• Verificação: Após o comando push, acesse seu painel no DockerHub e clique na aba Tags. Você verá tanto a latest quanto a 0.0.1 listadas lá.
• Limpeza: Se quiser listar as imagens que você tem localmente para conferir se criou a tag corretamente, use o comando:

docker images