Este guia documenta a abordagem oficial da Oficina-2026 para implementar a infraestrutura de containers no Debian 13 (Trixie). Esta configuração permite isolar bancos de dados e serviços, mantendo a performance do host.
1. Script de Implementação Única#
Dúvida do Usuário: Como instalar o Docker Engine garantindo que não existam conflitos e que o repositório seja o oficial?
Ação: Execute o bloco de comandos abaixo no seu terminal. Ele automatiza desde a limpeza preventiva até a configuração de permissões de usuário.
# 1. Limpeza de pacotes conflitantes
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
sudo apt remove -y $pkg
done
# 2. Atualização do sistema e instalação de dependências de rede
sudo apt update
sudo apt install -y ca-certificates curl
# 3. Configuração da Chave GPG oficial do Docker (Segurança)
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL [https://download.docker.com/linux/debian/gpg](https://download.docker.com/linux/debian/gpg) -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# 4. Adição do repositório oficial às fontes do sistema
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] [https://download.docker.com/linux/debian](https://download.docker.com/linux/debian) \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 5. Atualização da lista com o novo repositório e instalação do Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 6. Verificação final da instalação
sudo docker --version
# 7. Configuração pós-instalação (Usar Docker sem sudo)
sudo usermod -aG docker $USER
# 8. Mensagem de finalização
echo "------------------------------------------------------------"
echo "🚀 Instalação concluída com sucesso!"
echo "⚠️ IMPORTANTE: Reinicie seu computador para aplicar as permissões de usuário."
echo "------------------------------------------------------------"
Aviso de Segurança: Não tente rodar comandos docker imediatamente após o script. O Linux só reconhece que você faz parte do grupo docker após o recarregamento da sessão (Logout/Login) ou Reinicialização.
2. Check de Sucesso ✅
Após rodar o script, a saída esperada no final do terminal deve ser:
Plaintext
Docker version 29.1.3, build f52814d
------------------------------------------------------------
🚀 Instalação concluída com sucesso!
⚠️ IMPORTANTE: Reinicie seu computador para aplicar as permissões de usuário.
------------------------------------------------------------
O serviço Docker inicia automaticamente após a instalação. Para gerenciar o serviço:
Bash
# Verificar status
sudo systemctl status docker
# Inicialização manual (se necessário)
sudo systemctl start docker
# Teste final com imagem oficial
sudo docker run hello-world
3. Por que esta abordagem? (Teoria Técnica) 🧠
Limpeza Preventiva: O loop inicial evita erros causados por versões antigas do Docker que o Debian costuma trazer nos repositórios padrão.
Chave GPG (docker.asc): Garante que o software que você está baixando é realmente assinado pela Docker Inc., prevenindo ataques de "homem no meio".
Apt Sources: Ao injetar o repositório diretamente no /etc/apt/sources.list.d/, o Docker será atualizado automaticamente junto com o sistema (apt upgrade).
Permissão de Grupo: O comando usermod permite que seu código (VS Code/Python) controle containers sem precisar da senha de administrador o tempo todo.
