Como Auto-Hospedar Temporal em um VPS (Guia Completo)

Temporal é um motor de orquestração de workflows de código aberto, distribuído e escalável, utilizado por desenvolvedores para construir aplicações resilientes e de longo prazo. Hospedar o Temporal em um VPS pode te dar controle total sobre sua infraestrutura, economia de custos e personalização. Este guia conduz você pelo processo de instalação do Temporal em um container Docker em um provedor de VPS, garantindo uma configuração tranquila adequada para ambientes de desenvolvimento, homelab ou produção.

Por que Auto-Hospedar o Temporal?

Hospedar o Temporal por conta própria permite que você:

• Tenha controle total sobre seu ambiente de orquestração de workflows.
• Reduza custos em comparação com soluções gerenciadas.
• Personalize configurações de acordo com suas necessidades.
• Aprenda e experimente com sistemas distribuídos.

Provedores de VPS populares como Contabo (€5,99/mês), Hetzner Cloud (€4,15/mês), DigitalOcean (US$6) e Vultr (US$6) oferecem opções acessíveis e de alto desempenho, perfeitas para hospedar o Temporal.

Pré-requisitos

• Um VPS com IP público, sistema operacional Linux (Ubuntu 22.04 preferencialmente).
• Privilegios de root ou sudo.
• Conhecimento básico de Docker, linha de comando Linux e redes.
• Um domínio ou IP fixo para configuração de SSL (opcional, mas recomendado).

Passo 1: Preparar seu VPS

Atualize os pacotes do servidor e instale o Docker:

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io
sudo systemctl enable --now docker

Verifique a instalação do Docker:

docker --version

Para facilitar sua operação, adicione seu usuário ao grupo docker:

sudo usermod -aG docker $USER
newgrp docker

Passo 2: Configurar Docker Compose

Recomendado pelo Temporal para gerenciamento de setups com múltiplos containers. Instale o Docker Compose:

sudo apt install -y docker-compose

Verifique a versão instalada:

docker-compose --version

Passo 3: Baixar Arquivos Docker Compose do Temporal

O Temporal fornece configurações de exemplo. Clone o repositório do Temporal:

git clone https://github.com/temporalio/docker-compose.git
cd docker-compose

Alternativamente, crie seu próprio arquivo docker-compose.yaml para personalizar sua configuração.

Passo 4: Configurar seu arquivo Docker Compose

Crie ou edite o arquivo docker-compose.yaml conforme suas necessidades. Aqui está um exemplo simplificado para um setup de desenvolvimento:

version: '3.8'

services:
  temporal:
    image: temporalio/server:latest
    environment:
      - TEMPORAL_CLI_ADDRESS=temporal:7233
    ports:
      - "7233:7233"
    networks:
      - temporal-network
    restart: always

  frontend:
    image: temporalio/web:latest
    ports:
      - "8080:8080"
    environment:
      - TEMPORAL_HOST=https://localhost:7233
    depends_on:
      - temporal
    networks:
      - temporal-network

networks:
  temporal-network:
    driver: bridge

Ajuste as configurações de acordo com suas necessidades. Para produção, considere usar SSL, armazenamento persistente e credenciais seguras.

Passo 5: Iniciar o Temporal

Desdobre seu stack:

docker-compose up -d

Verifique se os serviços estão rodando:

docker ps

Você deve ver o servidor Temporal e os containers da interface web ativos.

Passo 6: Acessar a Interface Web do Temporal

Abra seu navegador com o IP ou domínio do servidor na porta 8080. Você terá uma interface funcional para gerenciar workflows.

Passo 7: Configurar TLS (Opcional, mas Recomendado)

Para ambientes de produção, garantir uma web segura:

• Obtenha certificados SSL via Let’s Encrypt (usando certbot).
• Configure um reverse proxy (NGINX ou Caddy) para terminar TLS.
• Atualize seu Docker Compose com as configurações do proxy.

Monitoramento e Manutenção

Atualize seus containers regularmente:

docker-compose pull
docker-compose down
docker-compose up -d

Garanta backups dos seus workflows e metadados, principalmente em ambientes de produção.

Comparação de Provedores de VPS

Para mais opções, confira nossa comparação completa de VPS.

Perguntas Frequentes

Quão difícil é auto-hospedar Temporal em um VPS?

Hospedar o Temporal em um VPS envolve configurar Docker, Docker Compose e redes corretamente. Para desenvolvedores familiarizados com Linux e Docker, o processo é direto e geralmente leva menos de uma hora. Configurações adicionais, como segurança com SSL ou clusterização, podem aumentar a complexidade, mas são gerenciáveis com guias passo a passo e suporte comunitário em /r/selfhosted ou awesome-selfhosted.

Posso rodar Temporal em um VPS de baixo custo?

Sim. Provedores como Hetzner Cloud (€4,15/mês) ou Contabo (€5,99/mês) oferecem recursos suficientes para cargas de trabalho pequenas a médias. Os requisitos do Temporal variam com o uso, mas um VPS com 2 núcleos de CPU e 4GB de RAM é geralmente suficiente para ambientes de desenvolvimento e testes. Para produção, monitore o uso de recursos e ajuste a escala conforme necessário.

Como posso garantir a segurança da minha instância de Temporal hospedada por conta própria?

Para garantir a segurança, configure SSL/TLS para acesso web (usando Let’s Encrypt ou certificados pagos), restrinja acesso à rede com firewalls e implemente mecanismos de autenticação. Para produção, use proxies reversos como NGINX ou Caddy com terminação de TLS e gerencie credenciais de forma segura. Mantenha seus containers atualizados para mitigar vulnerabilidades.

Conclusão

Auto-hospedar Temporal em um VPS oferece controle total sobre seu ambiente de orquestração de workflows a um custo acessível. Com Docker e Docker Compose, a implantação é simples e reproduzível. Seja para desenvolvimento, testes ou produção de pequeno porte, os passos acima guiam do setup inicial até uma instância Temporal totalmente funcional. Explore mais projetos open-source de auto-hospedagem e otimize seu homelab com insights das comunidades /r/selfhosted e awesome-selfhosted.

Procura por mais ideias de hospedagem? Veja nossa comparação completa de VPS para encontrar o melhor provedor para suas necessidades de auto-hospedagem. --- FIM ---