Pular para o conteúdo principal

🐙 Docker Swarm na plataforma SaveinCloud

Este guia tem como objetivo orientar a criação de um cluster Docker Swarm na plataforma da SaveinCloud, explicando as opções disponíveis, comandos essenciais, práticas recomendadas e gerenciamento com Portainer.

🛠️ Instalação via Marketplace​

  1. Acesse o painel da SaveinCloud.
  2. Clique em MARKETPLACE.
  3. Pesquise por Docker Swarm Cluster.

Você verá uma tela com opções como:

imagem

🔢 Docker Version​

Selecione a versão desejada do Docker (ex: 28.1.1-almalinux-9).

⚙️ Manager Nodes / Worker Nodes​

Defina quantas instâncias de Manager e de Worker seu cluster irá ter.

🧠 Entendendo os Campos: Manager Nodes e Worker Nodes​

🧑‍✈️ Manager Nodes​

Os Managers são os nós responsáveis por:

  • Gerenciar o estado global do cluster
  • Coordenar tarefas, serviços e escalonamento
  • Tomar decisões de orquestração (por exemplo, reiniciar containers em caso de falha)

Recomendações:

  • Use número ímpar de managers para evitar empates (1, 3, 5...)
  • Para alta disponibilidade, o ideal é ter 3 managers
  • Managers também podem executar containers (mas você pode desabilitar isso com --availability drain)

🧑‍🔧 Worker Nodes​

Os Workers são os nós que:

  • Executam as tarefas e containers atribuídos pelos managers
  • Não participam das decisões de orquestração
  • São ideais para escalar horizontalmente seus serviços

Recomendações:

  • Adicione mais workers conforme a carga da sua aplicação
  • Workers podem ser substituídos facilmente se falharem, sem comprometer o cluster
dica

💡 Você pode começar com 1 manager e 1 worker para testes, e aumentar conforme necessidade.
Para produção, o recomendado mínimo é 3 managers + 2 workers.

🧹 Clean Cluster​

Cria um cluster vazio, sem serviços pré-configurados.

📦 Deploy Stack YML​

Permite enviar automaticamente um arquivo docker-compose.yml para subir sua stack assim que o cluster for criado.

✅ Instalar Portainer UI​

Instala o painel gráfico para gestão do Swarm e aplica certificados SSL com Let's Encrypt.

dica

💡 O Portainer ficará acessível em:

https://<nome-do-ambiente>.sp1.br.saveincloud.net.br:4848/

🧪 Exemplo de Stack​

Exemplo básico de docker-compose.yml para usar com docker stack deploy:

version: "3.8"
services:
  app:
    image: nginxdemos/hello
    ports:
      - 80:80
    deploy:
      replicas: 3

🔐 Segurança no Docker Swarm​

atenção

⚠️ Nunca exponha a porta 2377 do cluster Swarm para a internet!

  • Use rede privada entre os nós.
  • Bloqueie portas administrativas.
  • Utilize autenticação por chave SSH.

📊 Gerenciamento com Portainer​

Acesse o Portainer, clique em Environments > Add environment e conecte ao socket local para gerenciar o cluster com interface visual.

📚 Recursos Relacionados​

✅ Checklist Final​

  • Cluster iniciado via marketplace
  • Workers e managers ativos
  • Portainer instalado e acessível
  • Deploy realizado com sucesso