108 lines
5.2 KiB
Markdown
108 lines
5.2 KiB
Markdown
# Aula 06 - n8n via Helm (Ambiente LOCAL)
|
|
|
|
Deploy do n8n workflow automation em cluster Kubernetes local usando Helm.
|
|
|
|
## Arquitetura
|
|
|
|
```
|
|
┌───────────────────────────────────────────────────────────┐
|
|
│ Cluster Local │
|
|
│ (OrbStack/k3s/Docker Desktop / minikube / kind / k3d) │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────┐ │
|
|
│ │ NGINX Ingress │ │
|
|
│ │ http://n8n.localhost │ │
|
|
│ └────────────────────────┬────────────────────────────┘ │
|
|
│ │ │
|
|
│ ┌────────────────────────┼────────────────────────────┐ │
|
|
│ │ Namespace: n8n │ │
|
|
│ │ │ │ │
|
|
│ │ ┌────────────────────┼────────────────────┐ │ │
|
|
│ │ │ ▼ │ │ │
|
|
│ │ │ ┌──────────┐ │ │ │
|
|
│ │ │ │ Main │ │ │ │
|
|
│ │ │ │ (n8n) │ │ │ │
|
|
│ │ │ └────┬─────┘ │ │ │
|
|
│ │ │ │ │ │ │
|
|
│ │ │ ┌─────────────┼─────────────┐ │ │ │
|
|
│ │ │ ▼ ▼ ▼ │ │ │
|
|
│ │ │ ┌───────┐ ┌──────────┐ ┌────────┐ │ │ │
|
|
│ │ │ │Workers│ │ Webhooks │ │ MCP │ │ │ │
|
|
│ │ │ │ (2-5) │ │ (1-3) │ │Webhook │ │ │ │
|
|
│ │ │ └───────┘ └──────────┘ └────────┘ │ │ │
|
|
│ │ │ │ │ │
|
|
│ │ │ Queue Mode │ │ │
|
|
│ │ └─────────────────────────────────────────┘ │ │
|
|
│ │ │ │ │
|
|
│ │ ┌───────────────┼───────────────┐ │ │
|
|
│ │ ▼ ▼ │ │
|
|
│ │ ┌──────────┐ ┌──────────┐ │ │
|
|
│ │ │PostgreSQL│ │ Redis │ │ │
|
|
│ │ │ (1Gi) │ │ (1Gi) │ │ │
|
|
│ │ └──────────┘ └──────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────┘ │
|
|
└───────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## Pré-requisitos
|
|
|
|
- Cluster Kubernetes local:
|
|
- Docker Desktop com Kubernetes habilitado
|
|
- minikube (`minikube start`)
|
|
- kind (`kind create cluster`)
|
|
- k3d (`k3d cluster create`)
|
|
- kubectl configurado
|
|
- Helm 3.x instalado
|
|
|
|
## Instalação
|
|
|
|
```bash
|
|
cd aula-06
|
|
chmod +x setup.sh
|
|
./setup.sh
|
|
```
|
|
|
|
O script instala automaticamente:
|
|
1. NGINX Ingress Controller
|
|
2. n8n com todos os componentes
|
|
|
|
## Acesso
|
|
|
|
**URL:** http://n8n.localhost
|
|
|
|
Se `n8n.localhost` não resolver, adicione ao `/etc/hosts`:
|
|
```
|
|
127.0.0.1 n8n.localhost
|
|
```
|
|
|
|
## Componentes
|
|
|
|
| Componente | Réplicas | Recursos |
|
|
|------------|-----------|-----------------|
|
|
| Main (n8n) | 1 | 256Mi-1Gi RAM |
|
|
| Workers | 2-5 (HPA) | 256Mi-512Mi RAM |
|
|
| Webhooks | 1-3 (HPA) | 128Mi-256Mi RAM |
|
|
| PostgreSQL | 1 | 1Gi volume |
|
|
| Redis | 1 | 1Gi volume |
|
|
|
|
## Comandos Úteis
|
|
|
|
```bash
|
|
# Ver pods
|
|
kubectl get pods -n n8n
|
|
|
|
# Ver logs do n8n
|
|
kubectl logs -f -n n8n deployment/n8n
|
|
|
|
# Ver autoscaling
|
|
kubectl get hpa -n n8n
|
|
|
|
# Desinstalar
|
|
helm uninstall n8n -n n8n
|
|
kubectl delete ns n8n
|
|
```
|
|
|
|
## Para Cluster Hetzner Cloud
|
|
|
|
Se você quer fazer deploy em um cluster Hetzner Cloud com volumes persistentes e LoadBalancer, veja a **aula-09**.
|