Guia de Instalação On-Premise

​

Pré-requisitos

​

Requisitos de Acesso

• Acesso ao Servidor:
  • Confirme o acesso aos servidores de implantação com privilégios sudo.
  • Verifique se todas as rotas de rede necessárias foram estabelecidas por meio de uma VPN segura ou configuração de rede dedicada.
• Permissões de Usuário:
  • Certifique-se de que a equipe de implantação recebeu os direitos de acesso necessários.
  • Valide se a autenticação de dois fatores (2FA) ou tokens de segurança necessários estão configurados.

​

Requisitos do Sistema

• GPU (Necessária ao implantar um LLM na mesma máquina que a plataforma EKB.)
• PEQUENO: Uma única VM com 16 núcleos, 64GB de RAM e 1 TB de SSD pode suportar cerca de 500 (100 simultâneos) usuários. O custo dessas máquinas é de aproximadamente US$ 600 por mês. Esta é uma implantação de tamanho mínimo.
• MÉDIO: Uma máquina maior com 32 núcleos, 128GB de RAM e 2 TB de SSD pode suportar cerca de 2.000 (500 simultâneos) usuários. O custo dessas máquinas é de aproximadamente US$ 1.200 por mês.
• GRANDE: Cerca de 10.000 (1.000+ simultâneos) usuários devem ser implantados em contêineres para que a infraestrutura possa escalar para atender às necessidades. Geralmente, o custo mínimo é de US$2.000 por mês. Recomenda-se calcular US$ 2.000 por mês para cada 1.000 usuários ativos adicionais. Esta é uma implantação totalmente distribuída.

​

Ferramentas de Implantação e Dependências de Software

• Scripts de Implantação:
  • Scripts de implantação em Bash verificados e com controle de versão.
• Ferramentas de Gerenciamento de Dependências:
  • Python 3
  • Git (versão atual)
  • Docker (v27.1.1) ou Podman
• Ferramentas Adicionais (Opcional):
  • Ferramentas de registro e monitoramento (por exemplo, ELK Stack, Prometheus, Grafana) conforme os requisitos de monitoramento do cliente.

​

Credenciais e Chaves

• Credenciais do Servidor:
  • Certifique-se de que todas as credenciais de acesso ao servidor estejam atualizadas e armazenadas de forma segura.
• Chaves de API e Licenças da Aplicação:
  • Verifique se todas as chaves de API e licenças específicas da aplicação (por exemplo, OpenAI, SERP, Sentry) estão disponíveis e válidas.

​

Lista de Verificação Pré-Implantação

​

Verificação de Hardware e Sistema

# Check CPU Information

lscpu                         # Works on both Ubuntu and RHEL

cat /proc/cpuinfo             # More detailed CPU information


# Check Memory Usage

free -h                       # Human-readable format for memory usage

cat /proc/meminfo             # Detailed memory information


# Check Storage Usage

df -h                         # Displays disk usage

lsblk                         # Lists block devices and partitions

​

Verificação de Software e Dependências

# Check Docker Version

docker --version              # Applicable for both Ubuntu and RHEL


# Check Docker Compose Version

docker compose version        # For modern Docker setups

docker-compose --version      # For older installations

```

# Check Python Version

python3 --version             # Preferred check for Python 3

python --version              # Alternative if python3 is not available


# Check Git Version

git --version                 # Valid for both Ubuntu and RHEL

​

Verificação de Rede e Conectividade

# Check Internet Connection Availability

ping -c 4 google.com          # Ping Google to verify network connectivity

curl -Is https://www.google.com | head -n 1  # Alternative check using curl

​

Verificações Adicionais

Observações: Todas as máquinas internas devem ser capazes de comunicar-se livremente entre si. Recomendamos o uso de conexões SSL (HTTPS); o HTTP é suportado durante POCs.

​

Arquitetura Geral

​

Diagrama de Arquitetura – On-Premise

​

Fluxo de arquitetura de implantação para implantação em Nuvem AWS