Skip to content
Sistema

Docker no Debian: verificações a serem realizadas antes de iniciar a instalação

Avatar illustré de Julien Macé 2 min read
Tux vérifie un serveur Debian avec Docker avant l’installation
Avant d’installer Docker sur Debian, vérifiez la version, le dépôt et les ports exposés.

Instalar o Docker no Debian não é complicado. O verdadeiro problema é fazê-lo muito rapidamente, com um pacote desatualizado. docker.io, um repositório declarado incorretamente ou um servidor cujo firewall não foi revisado.

No meu caso, sempre prefiro verificar o básico antes de iniciar a instalação: versão do Debian, arquitetura, pacotes conflitantes, serviço Docker, grupo de usuários e teste. olá-mundoIsso evita que você tenha uma instalação parcialmente funcional ou, pior ainda, um contêiner que exponha uma porta quando você pensava que ainda estava protegido pelo UFW.

O Tux verifica um servidor Debian com Docker antes da instalação.
Antes de instalar o Docker no Debian, verifique a versão, o repositório e as portas expostas.

Primeiro verifique a versão do Debian.

O Docker Engine está documentado para Debian 13, Debian 12 e Debian 11. Antes de copiar um comando encontrado em algum lugar, identifique claramente a máquina. Isso é especialmente importante se você estiver administrando um servidor antigo, uma máquina virtual clonada ou uma distribuição derivada.

cat /etc/os-release
cat /etc/debian_version
uname -m
dpkg --print-architecture

O repositório Docker usa o codinome Debian, por exemplo. leitor ávido Ou trixie. Se NOME_DE_CÓDIGO_DA_VERSÃO está vazio, ou se você estiver em uma distribuição derivada, não prossiga aleatoriamente. Substitua manualmente o codinome pelo nome de código da base Debian que está sendo usada.

Se você tiver alguma dúvida sobre isso, releia também o guia do LinuxEnCaja sobre o assunto. Comandos confiáveis ​​para verificar a versão do DebianEste é exatamente o tipo de controle que impede depósitos inconsistentes de APT.

Remova quaisquer pacotes antigos que possam estar causando problemas.

No Debian, o pacote docker.io Pode existir nos repositórios da distribuição. Não segue o mesmo ciclo de instalação dos pacotes oficiais do Docker. Se o seu objetivo é instalar o Docker Engine a partir do repositório oficial, remova primeiro quaisquer pacotes potencialmente conflitantes.

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)

Este comando pode simplesmente retornar que nada está instalado. Isso não é um problema. No entanto, ele não remove seus antigos contêineres, imagens, volumes e redes armazenados em /var/lib/dockerNão acesse esta pasta sem um backup caso o computador já tenha sido utilizado.

Adicione o repositório oficial do Docker corretamente.

O método limpo envolve um arquivo fonte APT dedicado e uma chave em /etc/apt/keyringsAconselho você a evitar tutoriais antigos que adicionam uma chave com chave aptEste já não é o método correto.

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Em seguida, adicione o repositório Docker com o codinome Debian detectado pelo sistema:

sudo tee /etc/apt/sources.list.d/docker.sources <

A verificação simples após esta etapa:

política de cache do apt docker-ce
grep -R "download.docker.com" /etc/apt/sources.list.d/

Você deverá ver o repositório Docker nas fontes e um candidato. docker-ceSe o APT não detectar nada, não force a instalação. Primeiro, corrija o arquivo. docker.sources, o nome de código ou conectividade de rede.

Instale o Docker e, em seguida, controle o serviço.

A instalação básica inclui o Docker Engine, o cliente, o containerd, o Buildx e o plugin Compose. Este é o pacote esperado para uma instalação limpa do Debian atualmente.

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Não pare na mensagem de conclusão do APT. Verifique se o serviço foi iniciado corretamente:

sudo systemctl status docker --no-pager
systemctl está ativo docker
sudo journalctl -u docker -b --no-pager | size -n 40

Se o serviço não iniciar, comece verificando os logs. Eles costumam ser mais informativos do que reinicializações repetidas. Para revisar os serviços ativos e as unidades com falha, consulte o artigo sobre systemctl e a lista de serviços do Linux Esta verificação foi concluída.

Faça o teste com "hello-world", mas não simplifique demais o grupo docker.

O teste oficial continua simples:

sudo docker run hello-world

Se a imagem for baixada, executada e exibir a mensagem de confirmação, o mecanismo do Docker está funcionando. Você também pode verificar as versões instaladas:

docker --versão
versão do docker compose
sudo docker info

A tentação, então, é adicionar seu usuário ao grupo. janela de encaixe evitar sudoÉ conveniente, mas não isento de riscos: um usuário pertencente a esse grupo pode obter privilégios muito elevados por meio do daemon do Docker. Em uma máquina de teste, por que não? Em um servidor compartilhado, eu só faria isso para uma conta de administrador claramente identificada.

sudo groupadd docker
sudo usermod -aG docker $USER
novo grupo docker
Docker Executar Olá Mundo

Se você iniciou o Docker com sudo Antes de mudar para o grupo, você também pode encontrar um problema de permissões em ~/.dockerNesse caso, corrija o proprietário em vez de executar todos os comandos aleatoriamente:

sudo chown -R "$USER":"$USER" ~/.docker
chmod -R go-rwx ~/.docker

Analise as configurações do firewall antes de expor um contêiner.

Este é o ponto que eu realmente verificaria antes de instalar o Docker em um servidor acessível pela internet. O Docker manipula as regras de rede, e as portas publicadas pelos contêineres podem contornar o que você pensa ter bloqueado com o UFW ou o firewalld.

sudo ss -ltnp
sudo docker ps
sudo docker ps --format "table {{.Names}} {{.Ports}}"
sudo ufw status numerado

Se você estiver publicando um serviço, releia o comando. -p 127.0.0.1:8080:80 não tem o mesmo impacto que -p 8080:80A primeira limita a escuta na máquina local, a segunda expõe a porta nas interfaces disponíveis.

Para um servidor Debian exposto, recomendo que você também releia o Regras UFW a serem definidas antes de abrir um servidorO Docker e o firewall devem ser considerados em conjunto, e não separadamente.

As verificações que realizo antes da validação

Antes de considerar a instalação concluída, realizo esta breve série de verificações. É rápida, mas detecta a maioria das instalações com falhas:

  • cat /etc/os-release Confirma a base Debian correta.
  • política de cache do apt docker-ce Aponta para o repositório Docker esperado.
  • sudo systemctl status docker --no-pager Nenhum erro foi relatado.
  • sudo docker run hello-world Funciona pelo menos uma vez.
  • versão do docker compose Responda se você planeja usar o Compose.
  • sudo ss -ltnp Não mostra nenhuma porta publicada inesperadamente.

Para ir mais longe, mantenha o Documentação do Docker para Debian, O Etapas pós-instalação do Linux e a página de Versões Debian mantidasE se o Docker se recusar a iniciar, não faça uma reinstalação completa imediatamente: comece por journalctl -u docker -bÉ aí que muitas vezes reside o verdadeiro erro.

Share Facebook X WhatsApp LinkedIn Pinterest Reddit Email