Skip to main content

Guia de Reinicialização de Serviços no Docker Compose | Comandos

  • Guia de Reinicialização de Serviços no Docker Compose | Comandos

Este documento descreve os três principais tipos de reinício de serviços usando Docker Compose, explicando o que cada um faz, o que NÃO faz e quando usar.

1️⃣ Restart simples — docker compose restart​

📌 Comando​

docker compose restart <serviço>

🔄 O que faz​

  • Para o processo principal do container
  • Inicia novamente o processo
  • Não recria o container

❌ O que NÃO faz​

  • Não aplica mudanças no docker-compose.yml
  • Não atualiza imagem
  • Não altera volumes, envs ou permissões
  • Não muda o ID do container

✅ Quando usar​

  • Aplicação travou
  • Serviço parou de responder
  • Recarregar conexões
  • Limpar estado em memória

❗ Quando NÃO usar​

  • Após mudar variáveis de ambiente
  • Após mudar volumes
  • Após mudar imagem
  • Após mudar configurações do compose

📌 Analogia: reiniciar um programa no sistema operacional.

2️⃣ Recriar container — docker compose up -d --force-recreate​

📌 Comando​

docker compose up -d --force-recreate <serviço>

🔄 O que faz​

  • Para e remove o container
  • Cria um novo container
  • Usa a mesma imagem
  • Reaplica tudo do docker-compose.yml

❌ O que NÃO faz​

  • Não baixa imagem nova
  • Não recompila imagem (build)

✅ Quando usar​

  • Mudou variáveis de ambiente
  • Mudou volumes
  • Mudou portas
  • Mudou permissões
  • Mudou paths (ex: volumes do n8n)
  • restart não resolveu

❗ Quando NÃO usar​

  • Quando precisa atualizar a imagem

📌 Analogia: apagar e reinstalar o programa, usando o mesmo instalador.

3️⃣ Atualizar imagem — docker compose up -d --pull always​

📌 Comando​

docker compose up -d --pull always <serviço>

🔄 O que faz​

  • Sempre baixa a imagem mais recente do registry
  • Recria o container
  • Aplica o docker-compose.yml

❌ O que NÃO faz​

  • Não recompila imagens locais (build:)
  • Não atualiza código local automaticamente

✅ Quando usar​

  • Nova versão da imagem foi publicada
  • Usa image: (ex: n8nio/n8n:latest)
  • Atualizar serviço sem derrubar outros
  • Deploy simples

❗ Quando NÃO usar​

  • Serviço usa build: local

📌 Analogia: atualizar o programa para a versão mais nova.

🧱 Caso especial: --build​

📌 Comando​

docker compose up -d --build <serviço>

🔄 O que faz​

  • Recompila a imagem local
  • Recria o container

✅ Quando usar​

  • Mudou código da aplicação
  • Mudou Dockerfile
  • Usa build: no compose

🧠 Tabela resumo​

SituaçãoComando recomendado
Serviço travoudocker compose restart
Mudou env / volume / configdocker compose up -d --force-recreate
Imagem nova no registrydocker compose up -d --pull always
Código/Dockerfile mudoudocker compose up -d --build

📌 Regra de ouro​

Se mudou algo fora do container → recrie Se mudou a imagem → puxe nova Se só travou → restart