Déploiement
SaaS, auto-hébergé, isolé du réseau
Une seule base de code et une seule image pour chaque déploiement ; DEPLOYMENT_MODE choisit. Les organisations réglementées commencent généralement en auto-hébergé ou isolé du réseau.
saasself_hostedLICENSE_PLAN).airgappedEGRESS_ALLOWLIST : un appel de modèle vers tout autre hôte est refusé et scellé. Un mode inconnu est lu comme isolé du réseau.Installer avec Helm
Le chart (helm/azoth-os) fournit l’application, ses tâches planifiées, des politiques réseau, une sauvegarde nocturne de la base intégrée, et en option un Supabase intégré (Postgres, GoTrue, PostgREST) et Redis. Les secrets viennent d’un seul Secret que vous générez hors ligne :
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-tlsLes migrations, à la main
Le chart n’applique jamais les migrations. L’image embarque l’outil qui les exécute : lancez node migrator/scripts/migrate.mjs --status, puis --apply, sous forme de Job. Il tient un registre de sommes de contrôle et refuse un fichier modifié ; l’application ne se déclare prête qu’une fois la base à la migration qu’elle attend.
Identité et e-mail
Connexion par le fournisseur OIDC de votre organisation, ou par SAML avec Entra ID ou ADFS, déconnexion unique comprise. Les e-mails passent par votre relais SMTP : STARTTLS sans rétrogradation, jamais d’identifiants en clair.
Isolé du réseau
- L’infrastructure propre du déploiement — sa base de données, Redis, son autorité d’horodatage et son collecteur de télémétrie — reste joignable ; tout le reste doit figurer dans la liste autorisée.
- Les modèles hébergés dans le déploiement — vLLM, TGI, LiteLLM, l’API OpenAI d’Ollama — forment le fournisseur
internal: la même passerelle, les mêmes règles et le même journal, au prix que vous déclarez. - Sans Internet, donnez au déploiement sa propre autorité d’horodatage : le niveau 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 youL’image signée et le bundle hors ligne
Chaque version publie une image signée et son SBOM signé, et joint un bundle hors ligne — le chart, toutes les images, un SHA256SUMS signé — qui se vérifie avec openssl seul, sans Internet.
Le catalogue de modèles
Un déploiement auto-hébergé importe chaque jour le dernier catalogue de modèles signé ; un déploiement isolé du réseau importe un fichier signé depuis l’administration de la plateforme. Un catalogue est refusé s’il n’est pas signé ou si son empreinte ne correspond pas à son sha256.
Le guide complet est docs/self-hosting.md dans le dépôt.