Despliegue en Producción

El NKZ GitOps Starter es la forma canónica de desplegar NKZ OS en producción. Un repo plantilla con wizard interactivo que configura tu dominio, genera secrets y despliega toda la plataforma vía ArgoCD en menos de 10 minutos.

Despliegue rápido

git clone https://github.com/nkz-os/nkz-gitops-starter
cd nkz-gitops-starter
./scripts/setup.sh

El wizard pregunta: dominio, subdominios (derivados automáticamente), nombre de empresa, email, y opcionalmente IP del servidor para bootstrap automático (K3s + ArgoCD + cert-manager).

# Crear secrets (copiar del output del wizard)
kubectl create namespace nekazari
kubectl create secret generic jwt-secret --from-literal=secret="..." -n nekazari
# ... (6 secrets)

# Subir a tu fork privado
git init && git add -A && git commit -m "NKZ para ejemplo.com"
git remote add origin https://github.com/TU_ORG/nkz-gitops-config
git push -u origin main

# Aplicar root app de ArgoCD
kubectl apply -f bootstrap/root-config.yaml

En 5-10 minutos ArgoCD sincroniza todos los servicios. Los certificados TLS se emiten automáticamente con Let’s Encrypt.

Requisitos DNS

Subdominio	Servicio	Obligatorio
`(tu dominio)`	Frontend	Sí
`api.(tu dominio)`	API Gateway	Sí
`auth.(tu dominio)`	Keycloak SSO	Sí
`minio.(tu dominio)`	Almacenamiento	Sí
`argo.(tu dominio)`	Dashboard ArgoCD	Sí
`vpn.(tu dominio)`	VPN / Tailscale	Opcional

Requisitos del servidor

Recurso	Mínimo	Recomendado
CPU	2 cores	4+ cores
RAM	4 GB	8 GB
Disco	40 GB	80+ GB SSD
SO	Ubuntu 22.04+	Ubuntu 24.04