Instalação
Guias de instalação para diferentes ambientes
Instalação do Sinapse
Esta seção contém guias detalhados para instalar o Sinapse em diferentes ambientes e configurações.
Métodos de Instalação
Requisitos
Requisitos de sistema e dependências
Docker
Instalação rápida com containers
Kubernetes
Deploy em produção com K8s
Manual
Instalação tradicional sem containers
Instalação Rápida (Docker)
# Clone o repositório
git clone https://github.com/sinapse/core-api.git
cd core-api
# Configure ambiente
cp .env.example .env
# Edite .env com suas configurações
# Inicie com Docker Compose
docker-compose up -d
# Execute migrações
docker-compose exec api alembic upgrade head
# Crie dados iniciais
docker-compose exec api python scripts/create_initial_data.pyQual Método Escolher?
Docker (Recomendado para Dev)
- Setup rápido
- Ambiente isolado
- Fácil de resetar
- Overhead de containers
Kubernetes (Produção)
- Alta disponibilidade
- Escalabilidade automática
- Gerenciamento avançado
- Complexidade maior
Manual (Casos Específicos)
- Controle total
- Performance máxima
- Setup complexo
- Gerenciamento manual
Checklist Pré-Instalação
Sistema operacional compatível Python 3.11+ instalado PostgreSQL 15+ disponível Redis 7+ disponível Mínimo 8GB RAM 20GB espaço em disco
Configuração Pós-Instalação
Após a instalação, você precisará:
- Configurar variáveis de ambiente
- Executar migrações de banco
- Criar usuário administrador
- Configurar HTTPS (produção)
- Habilitar monitoramento
Dicas
Desenvolvimento: Use Docker para começar rapidamente. É a opção mais simples e rápida.
Produção: Sempre use HTTPS e siga as recomendações de segurança do guia de Kubernetes.
Suporte: Se encontrar problemas, consulte o Troubleshooting ou abra uma issue no GitHub.
Escolha seu método de instalação preferido nos cards acima ou continue com os Requisitos.