Despliegue
SaaS, autoalojado, aislado
Un único código base y una única imagen para todos los despliegues; DEPLOYMENT_MODE decide. Las organizaciones reguladas suelen empezar con un despliegue autoalojado o aislado.
saasself_hostedLICENSE_PLAN).airgappedEGRESS_ALLOWLIST: una llamada de modelo a cualquier otro se rechaza y se sella. Un modo desconocido se interpreta como aislado.Instalar con Helm
El chart (helm/azoth-os) incluye la aplicación, sus tareas programadas, las políticas de red, una copia de seguridad nocturna de la base de datos incluida y, de forma opcional, un Supabase incluido (Postgres, GoTrue, PostgREST) y Redis. Los secretos proceden de un único Secret que generas sin conexión:
kubectl create namespace azoth
node scripts/self-hosted/gen-secrets.mjs --name azoth-secrets --namespace azoth | kubectl apply -f -
helm install azoth helm/azoth-os -n azoth \
--set appUrl=https://azoth.bank.internal \
--set image.repository=<registry>/azoth-os --set image.digest=sha256:… \
--set ingress.tls[0].secretName=azoth-tlsMigraciones, a mano
El chart nunca aplica migraciones. La imagen incluye el ejecutor: ejecuta node migrator/scripts/migrate.mjs --status y luego --apply, como un Job. Mantiene un registro de checksums y rechaza un archivo modificado; la aplicación solo se declara lista cuando la base de datos está en la migración que espera.
Identidad y correo electrónico
Inicia sesión a través del proveedor OIDC de tu organización, o mediante SAML con Entra ID o ADFS, cierre de sesión único incluido. El correo pasa por tu relé SMTP: STARTTLS sin degradación, nunca credenciales en texto plano.
Aislado
- La infraestructura propia del despliegue — su base de datos, Redis, la autoridad de sellado de tiempo y el colector de telemetría — sigue siendo accesible; todo lo demás debe estar en la lista de permitidos.
- Los modelos alojados dentro del despliegue — vLLM, TGI, LiteLLM, la API de OpenAI de Ollama — son el proveedor
internal: la misma pasarela, las mismas reglas y el mismo diario, al precio que declares. - Sin Internet, dale al despliegue su propia autoridad de sellado de tiempo: el nivel local.
egress:
allowlist:
- llm.bank.internal # any port
- siem.bank.internal:8443 # this port only
- "*.models.bank.internal" # any sub-domain
internalModels:
- name: vllm
baseUrl: http://vllm.models.svc:8000/v1
models: [llama-3.1-70b-instruct]
price: { input: 0.4, output: 0.8 } # USD per 1M tokens, declared by youLa imagen firmada y el paquete sin conexión
Cada versión publica una imagen firmada y su SBOM firmado, y adjunta un paquete sin conexión — el chart, todas las imágenes y un SHA256SUMS firmado — que se verifica solo con openssl, sin Internet.
El catálogo de modelos
Un despliegue autoalojado importa cada día el último catálogo de modelos firmado; uno aislado importa un archivo firmado desde la administración de la plataforma. Un catálogo se rechaza salvo que esté firmado y su hash coincida con su sha256.
La guía completa es docs/self-hosting.md, en el repositorio.