Documentação CeTI

Appearance

🐳 Instalação do Docker ​

Nota

Última atualização: Agosto 2025

Referência

Esta documentação foi criada tendo como base a Documentação oficial do Docker

Pré-requisitos ​

Por convenção da SSS, as aplicações que rodarão em containeres Docker, serão instaladas dentro da pasta /opt/apps, portanto deverá ser utilizado o Template Ubuntu Docker nesse caso. O Docker somente é compatível com iptables-nft e iptables-legacy, portanto o ufw não vai funcionar como firewall de máquina e as portas expostas pelos containeres vão bypassar as regras do ufw.

Instalação ​

Remover quaisquer outras instalações de docker que possam haver na máquina (se for uma instalação limpa, pular essa parte).

shell
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

Usando o repositório apt ​

Configurar o repositório do Docker no apt.

shell
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Instalar os pacotes necessários.

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

O Docker está instalado. Para validar a instalação executar:

shell
sudo docker run hello-world

Executando o docker sem utilizar o sudo ​

Se você quiser evitar ter que digitar sudo sempre que for executar o comando docker, adicione seu nome de usuário no grupo docker.

Nas máquinas da PMDF, somente o usuário suporte deverá ser adicionado ao grupo suporte e somente ele deverá ser usado para executar os comandos docker para padronizar o owner dos arquivos

shell
sudo usermod -aG docker ${USER}

IMPORTANTE

Por convenção, na PMDF todos os containeres rodarão pelo usuário suporte, portanto ao logar na máquina com o usuário, é importante que mudemos para o usuário suporte e em seguida faremos as atividades necessárias nos containeres.

shell
sudo su - suporte