Instalação Docker

🐳 Introdução

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.

🚀 Script de Implementação Única

Execute o bloco de comandos abaixo no seu terminal para automatizar desde a limpeza preventiva até a configuração de permissões.

# 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. Instalação de dependências
sudo apt update && sudo apt install -y ca-certificates curl

# 3. Configuração da Chave GPG e Repositório
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

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

# 4. Instalação do Engine
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 5. Pós-instalação
sudo usermod -aG docker $USER

📦 Docker Compose V2 Uma das grandes vantagens desta instalação é que o Docker Compose já vem integrado como um plugin nativo.

Comando Moderno: Não utilize mais docker-compose (com hífen). O novo padrão é docker compose (com espaço).

Vantagem: Isso garante que a versão do Compose esteja sempre sincronizada com o Engine principal.

⚠️ Avisos Importantes Reinicialização: O Linux só reconhece que você faz parte do grupo docker após o Logout/Login ou Reinicialização.

Segurança: A chave GPG garante que o software é assinado pela Docker Inc., prevenindo ataques.

Atualizações: O Docker será atualizado automaticamente junto com o sistema via apt upgrade.

✅ Check de Sucesso Após reiniciar, execute os comandos abaixo para validar a instalação:

# Verificando as versões instaladas
docker version
docker compose version