Aller au contenu principal

LibreChat sur GKE Autopilot

LibreChat sur GKE Autopilot

LibreChat est une interface de chat IA open source avec plus de 20 000 étoiles sur GitHub qui réplique et étend l'expérience ChatGPT à plus de 20 fournisseurs de LLM (OpenAI, Anthropic, Google Gemini, Mistral, Groq, Ollama et bien d'autres). Ce module déploie LibreChat sur GKE Autopilot en s'appuyant sur la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par LibreChat et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et le cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_GKE plutôt que de les répéter ici.


Ce que coûte LibreChat sur RAD, et comment cela se compare​

Le module LibreChat sur GKE Autopilot de RAD coûte environ 92 US$ par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 75 crédits (7,50 US$). GKE convient à LibreChat pour servir une organisation en continu ; pour le coût le plus bas, le module Cloud Run exécute le même LibreChat pour environ 46 US$ par mois. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 92 US$ deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement75 crédits (7,50 US$ au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites, puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 92 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 97 crédits par jour, soit environ 2 910 par mois (environ 291 US$ au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde acheté minimum est conservé en réserve

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 US$ par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 US$ pour une recharge unique, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (module par défaut)Par mois
Pod GKE Autopilot, 2x vCPU / 2 GiB72,16 US$
Serveur de fichiers NFS/cache (petite VM)13,43 US$
Cloud NAT et réseau5,00 US$
Cloud Storage (modules complémentaires, sauvegardes)1,00 US$
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Totalenviron 92 US$

Comment cela se compare​

  • Il n'existe pas de SaaS LibreChat hébergé officiel — il est auto-hébergé par conception.
  • Un GCE e2-standard-2 (2 vCPU/8 Go, environ 49 US$/mois) est la comparaison auto-gérée de taille plus proche pour les 2 vCPU/2 GiB du pod GKE plus le serveur de fichiers, moins les sauvegardes gérées et l'autoscaling de pod inclus par RAD.
  • Les appels aux fournisseurs de LLM sont facturés séparément de l'infrastructure dans les deux cas.
  • Ou consultez le guide Cloud Run pour l'option à moindre coût.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin​

Si LibreChat s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à LibreChat dont vous n'avez besoin qu'occasionnellement — un projet de cours, une démo, une évaluation de courte durée — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un seul module, cela ne détruit pas une VM ou le calcul propre de LibreChat un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de restaurer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ce que cela nécessite. Vous devez posséder le projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude et de démo conviennent). Google indique que la plupart des services fonctionnent à nouveau pleinement dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes de LibreChat sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé LibreChat et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le workflow de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

GKE maintient au moins un pod en cours d'exécution, il ne se met donc jamais à l'échelle à zéro de lui-même. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 US$), car RAD recrée le projet et les services partagés avant LibreChat. La suppression ne permet d'économiser de l'argent que si LibreChat devait rester inutilisé pendant environ trois jours ou plus, à la fois dans votre propre projet (environ 3,05 US$ par jour) et dans un projet géré par RAD (97 crédits par jour).
  • Supprimez tout ce que LibreChat utilise. La majeure partie du coût d'exécution est généralement la VM de fichier/cache partagée. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de LibreChat alors que quelque chose d'autre partage le projet n'économise que la partie calcul propre de LibreChat.
  • Conservez d'abord vos données. Les sauvegardes nocturnes sont stockées dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde avant de la supprimer si vous souhaitez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session LibreChat pour une classe. Chaque participant obtient LibreChat dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places à l'avance, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session, et les crédits non utilisés sont restitués au formateur.
  • Environnements gérés, pour les cabinets de conseil. Un partenaire exécute LibreChat pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin de l'engagement, le partenaire transfère le projet, et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et l'estimation quotidienne de 89 crédits de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

LibreChat s'exécute comme une charge de travail web Node.js. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods Node.js, 2 vCPU / 2 GiB par défaut, autoscaling horizontal
Base de donnéesMongoDB (service d'aide mongo:7 dans l'espace de noms par défaut)Cloud SQL n'est pas utilisé ; la compatibilité MongoDB de Firestore est une alternative optionnelle
Stockage d'objetsCloud StorageUn bucket dédié aux téléchargements de fichiers, plus des buckets supplémentaires optionnels
SecretsSecret ManagerClés JWT, clés de chiffrement des identifiants et URI MongoDB auto-générés
Cache et sessionsRedis (optionnel)Requis pour les déploiements multi-réplicas afin de maintenir la cohérence des sessions
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé optionnel + certificat géré

Valeurs par défaut judicieuses à connaître à l'avance :

  • Pas de Cloud SQL. LibreChat utilise MongoDB. mongodb_uri par défaut à "", mais main.tf substitue un URI de service d'aide mongo:7 calculé dans l'espace de noms (mongodb://<service>-mongo.<namespace>.svc.cluster.local:27017/LibreChat) avant d'appeler LibreChat_Common — cet aide MongoDB dans l'espace de noms est la base de données par défaut, reflétant le sidecar LibreChat_CloudRun dans le pod. Firestore ENTERPRISE avec compatibilité MongoDB est une alternative optionnelle : l'auto-provisionnement de LibreChat_Common ne se déclenche que lorsqu'il reçoit un véritable mongodb_uri vide et un firestore_mongodb_host vide, une combinaison que la configuration par défaut de ce module ne produit jamais. Définissez mongodb_uri explicitement (vers un MongoDB externe, Atlas ou un hôte Firestore) pour ne plus utiliser l'aide par défaut.
  • L'aide MongoDB par défaut nécessite NFS. Son répertoire de données /data/db est monté à partir du volume Filestore (NFS) partagé, donc enable_nfs par défaut à true. Gardez-le activé sauf si vous remplacez mongodb_uri par un MongoDB externe — avec NFS désactivé, l'aide n'a pas de volume à monter et LibreChat boucle en cas de crash.
  • Une base de données Firestore (lorsqu'elle est activée) n'est jamais supprimée lors de la destruction. La base de données est conservée pour éviter la perte de données ; supprimez-la manuellement si elle n'est plus nécessaire.
  • Les secrets JWT et d'identifiants sont auto-générés lors du premier déploiement et stockés dans Secret Manager. La rotation de CREDS_KEY ou CREDS_IV après que les utilisateurs ont enregistré des identifiants de fournisseur d'IA rend tous les identifiants stockés indéchiffrables.
  • Redis est désactivé par défaut. Activez-le pour tout déploiement avec plus d'un réplica — sans Redis, l'état de session est isolé par pod et les utilisateurs perdent leurs sessions lors des redémarrages de pod.
  • L'affinité de session est ClientIP. LibreChat utilise des connexions WebSocket ; le routage persistant maintient le trafic d'un utilisateur sur le même pod.
  • Le délai d'attente est de 600 secondes par défaut. Les réponses IA de longue durée via le streaming SSE nécessitent un délai d'attente généreux.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont signalés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail LibreChat​

Les pods LibreChat sont planifiés sur Autopilot, qui facture le CPU et la mémoire que les pods demandent réellement. L'autoscaling horizontal des pods dimensionne le déploiement entre les nombres de réplicas minimum et maximum.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail LibreChat pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'adresse IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Déploiement vs StatefulSet).

B. Aide MongoDB dans l'espace de noms — la base de données LibreChat​

LibreChat stocke tout l'historique des chats, les comptes d'utilisateurs et la configuration dans MongoDB. Par défaut, le bloc main.tf de librechat_additional_services exécute l'image officielle mongo:7 en tant qu'aide singleton (min=max=1) dans l'espace de noms Deployment+Service, accessible via le DNS du cluster à <service>-mongo.<namespace>.svc.cluster.local:27017. Cela reflète le sidecar LibreChat_CloudRun de mongo:7 dans le pod, mais sur GKE, l'aide est une charge de travail distincte plutôt qu'un conteneur dans le même pod — car LibreChat est construit autour de MongoDB standard et l'API compatible Mongo de Firestore supprime les commandes de démarrage de LibreChat. Le répertoire de données de l'aide (/data/db) est monté à partir du volume Filestore (NFS) partagé ; le nombre de réplicas singleton évite les problèmes de verrouillage de fichiers multi-écrivains que MongoDB rencontre sur NFS. mongodb_uri (par défaut "") est résolu automatiquement à l'URI de cette aide — définissez-le explicitement pour le remplacer par MongoDB Atlas ou toute instance MongoDB auto-hébergée accessible depuis le VPC.

Alternativement, effacez la configuration effective pour opter pour une base de données Firestore ENTERPRISE avec compatibilité MongoDB — cela ne se produit que lorsque LibreChat_Common lui-même reçoit un mongodb_uri vide et un firestore_mongodb_host vide, ce qui nécessite de remplacer le câblage par défaut de ce module (le librechat.tf du wrapper substitue toujours l'URI de l'aide lorsque var.mongodb_uri == "").

  • Console : Kubernetes Engine → Charges de travail → le déploiement <service>-mongo affiche le pod, les journaux et les événements de l'aide. Firestore → sélectionnez la base de données (uniquement lorsque le mode Firestore est utilisé ; l'ID correspond à firestore_mongodb_database, par défaut : LibreChat).
  • CLI :
    # Inspect the default MongoDB helper and its NFS-backed data directory:
    kubectl get pods,svc -n "$NAMESPACE" -l component=mongo
    kubectl logs -n "$NAMESPACE" deploy/<service-name>-mongo --tail=100

    # If using Firestore mode instead (opt-in only):
    gcloud firestore databases list --project "$PROJECT"
    gcloud firestore databases describe LibreChat --project "$PROJECT"

Récupérez l'URI MongoDB résolu de Secret Manager pour vérifier la connectivité :

gcloud secrets list --project "$PROJECT" --filter="name~mongo-uri"
gcloud secrets versions access latest --secret=<mongo-uri-secret> --project "$PROJECT"

C. Cloud Storage — téléchargements de fichiers​

LibreChat_Common provisionne un bucket Cloud Storage dédié librechat-uploads pour les téléchargements de fichiers utilisateur partagés dans le chat (images, documents). Le compte de service de la charge de travail se voit accorder l'accès automatiquement.

  • Console : Cloud Storage → Buckets → recherchez le bucket avec le suffixe uploads.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<uploads-bucket>/
    # Confirm the GCS Fuse mount is active inside the pod:
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- df -h | grep -i fuse

Voir App_GKE pour le provisionnement NFS, GCS Fuse et les options CMEK.

D. Secret Manager — secrets d'application auto-générés​

LibreChat nécessite plusieurs secrets cryptographiques qui sont générés automatiquement lors du premier déploiement et ne sont jamais exposés en texte clair.

Suffixe du secretVariable d'environnementObjectif
creds-keyCREDS_KEYClé AES-GCM hexadécimale de 32 octets pour les identifiants de fournisseur enregistrés
creds-ivCREDS_IVIV AES-GCM hexadécimal de 16 octets — associé à CREDS_KEY
jwt-secretJWT_SECRETSigne les jetons d'accès utilisateur
jwt-refresh-secretJWT_REFRESH_SECRETSigne les jetons d'actualisation de longue durée
mongo-uriMONGO_URIChaîne de connexion MongoDB
  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.

E. Cache Redis (optionnel)​

Redis prend en charge la gestion des sessions de LibreChat et la mise en file d'attente des messages en temps réel. Il est requis lorsque plus d'un réplica de pod est en cours d'exécution — sans lui, chaque pod a un état de session en mémoire isolé et les utilisateurs perdent leurs sessions lorsque les requêtes sont acheminées vers un pod différent.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace
    # From inside the cluster:
    kubectl run redis-check --rm -it --image=redis --restart=Never -- redis-cli -h <redis-host> ping

F. Réseau et ingress​

Par défaut, la charge de travail est exposée via une adresse IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une adresse IP statique peut être réservée afin que l'adresse survive aux redéploiements.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les détails sur les domaines personnalisés, Cloud CDN et les adresses IP statiques.

G. Cloud Logging et Monitoring​

Le stdout/stderr des pods est acheminé vers Cloud Logging ; les métriques GKE sont acheminées vers Cloud Monitoring. Des vérifications de disponibilité et des politiques d'alerte optionnelles sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read \
    'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application LibreChat​

  • Pas de job de migration de base de données. LibreChat migre automatiquement son schéma MongoDB au premier démarrage ; aucun job d'initialisation séparé n'est nécessaire.
  • Aide mongo:7 dans l'espace de noms par défaut, pas Firestore. mongodb_uri par défaut à "", mais main.tf substitue un URI de service d'aide mongo:7 calculé dans l'espace de noms avant d'appeler LibreChat_Common — voir §1 et §2.B. L'auto-provisionnement Firestore ENTERPRISE (découverte ou création, plus provisionnement automatique d'utilisateurs SCRAM) est une alternative optionnelle atteinte uniquement lorsque le mongodb_uri effectif passé à LibreChat_Common est vide, ce qui nécessite de remplacer le câblage par défaut de ce module. Lorsque le mode Firestore est utilisé, la base de données n'est jamais détruite avec le module.
  • Clés API du fournisseur d'IA. LibreChat lui-même se connecte aux API du fournisseur d'IA au moment de la requête. Injectez les clés du fournisseur (OpenAI, Anthropic, etc.) via secret_environment_variables, qui fait référence à des secrets Secret Manager préexistants. Ne passez pas les clés en tant que environment_variables en clair — elles apparaîtraient dans les spécifications de pod visibles via kubectl describe pod.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent / (la racine de LibreChat), qui renvoie HTTP 200 une fois que l'application est entièrement initialisée et connectée à MongoDB. La sonde de démarrage a un seuil d'échec généreux pour permettre l'établissement de la connexion MongoDB au premier démarrage.
  • Continuité WebSocket et SSE. LibreChat utilise les Server-Sent Events (SSE) pour le streaming des réponses IA et WebSocket pour les mises à jour en temps réel. L'affinité de session (ClientIP) maintient la connexion d'un utilisateur sur le même pod. Assurez-vous que timeout_seconds est suffisamment élevé (600 s par défaut) pour éviter de tronquer les réponses IA longues en cours de diffusion.
  • Enregistrement des utilisateurs. L'auto-enregistrement est activé par défaut. Définissez allow_registration = false après la création du compte administrateur initial pour empêcher les inscriptions non autorisées sur les déploiements publics.

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour LibreChat sont listés ; toutes les autres entrées sont héritées de App_GKE avec leur comportement et leurs valeurs par défaut standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail et les ressources régionales.
firestore_mongodb_host""Hôte du point de terminaison MongoDB de Firestore (remplacement manuel). Laissez vide pour la découverte automatique.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails autorisés à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelibrechatNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameLibreChat AI ChatNom convivial affiché dans la console.
application_description(défini)Annotation de description de la charge de travail.
application_versionlatestBalise de version de l'image LibreChat — épingler à une version spécifique en production.
mongodb_uri""URI de connexion MongoDB (sensible). Laissez la valeur par défaut "" pour utiliser le service d'aide mongo:7 dans l'espace de noms que main.tf calcule automatiquement — l'auto-provisionnement Firestore est un chemin d'accès optionnel distinct (voir §2.B), ce n'est pas ce que laisser ce champ vide déclenche seul.
app_titleLibreChatTitre affiché dans l'en-tête de l'interface utilisateur LibreChat et l'onglet du navigateur.
allow_registrationtrueAutoriser les nouveaux utilisateurs à s'auto-enregistrer. Définissez false après la création du compte administrateur initial.
allow_social_loginfalseActiver les fournisseurs de connexion sociale OAuth. Nécessite une configuration d'application OAuth dans librechat.yaml.
allow_social_registrationnullAutoriser la création de compte via la connexion sociale. Par défaut, la valeur de allow_social_login.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltprebuilt (GHCR) ou custom (Cloud Build).
container_imageghcr.io/danny-avila/librechatURI de l'image conteneur.
container_resources{ cpu_limit = "2000m", memory_limit = "2Gi" }CPU et mémoire par pod ; 2 vCPU / 2 GiB minimum.
container_port3080Port HTTP natif de LibreChat.
min_instance_count1Réplicas minimum. Gardez ≥ 1 pour éviter les démarrages à froid et les flux SSE interrompus.
max_instance_count5Réplicas maximum (plafond HPA).
timeout_seconds600Délai d'expiration de la requête ; augmentez-le pour les backends LLM lents ou les réponses IA longues.
enable_cloudsql_volumefalseDoit rester false. LibreChat n'utilise pas Cloud SQL.
enable_vertical_pod_autoscalingfalseLaissez Autopilot ajuster automatiquement les requêtes de ressources.
enable_image_mirroringtrueMettre en miroir l'image GHCR vers Artifact Registry — évite les limites de débit.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les variables principales de LibreChat sont définies automatiquement.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager. Utilisez ceci pour les clés API du fournisseur d'IA.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service Kubernetes est exposé.
session_affinityClientIPRoutage persistant pour la continuité WebSocket et SSE.
workload_typenullSe résout automatiquement en StatefulSet lorsque le stockage par pod est activé.
network_tags['nfsserver']Balises de nœud/pod ; nfsserver est requis pour la connectivité NFS.
termination_grace_period_seconds60Secondes à attendre après SIGTERM avant de terminer de force ; augmentez pour les requêtes IA en cours.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enablednullActiver le PVC par pod. Sélectionne automatiquement StatefulSet.
stateful_pvc_size10GiTaille de stockage pour chaque PVC.
stateful_pvc_mount_path/dataChemin du conteneur pour le PVC.
stateful_pvc_storage_classstandard-rwoStorageClass Kubernetes pour les PVC.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalsePlafonner les comptes CPU/mémoire/objets de l'espace de noms.
quota_memory_requests / quota_memory_limits""Doit utiliser des unités binaires (4Gi, 8192Mi) — les entiers nus sont lus comme des octets et bloquent toute planification.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgetfalseCréer un PodDisruptionBudget (désactivé par défaut car le nombre maximal de réplicas est de 1 pod).
pdb_min_available1Augmentez min_instance_count au-dessus de 1 si vous avez besoin d'une marge d'éviction.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_config{ path="/", initial_delay_seconds=30, failure_threshold=12 }Sonde HTTP permettant le temps de connexion MongoDB et le chargement des actifs.
health_check_config{ path="/", initial_delay_seconds=60, failure_threshold=3 }Sonde de vivacité ciblant le chemin racine de LibreChat.
uptime_check_configdésactivé, /Vérification de disponibilité Cloud Monitoring optionnelle.
alert_policies[]Politiques d'alerte métrique optionnelles.

Groupe 11 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laissez vide — LibreChat migre automatiquement MongoDB au démarrage. Ajoutez des tâches de configuration personnalisées si nécessaire.
cron_jobs[]CronJobs Kubernetes planifiés pour les tâches périodiques (nettoyage des données, préchauffage du cache, etc.).

Groupe 12 — CI/CD et intégration GitHub​

Intégration standard App_GKE Cloud Build / Cloud Deploy — voir App_GKE. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfstrueProvisionner un volume Filestore NFS partagé entre tous les réplicas. Requis par l'aide MongoDB par défaut.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner des buckets GCS supplémentaires.
storage_buckets[{ name_suffix = "data" }]Buckets supplémentaires au-delà du bucket de téléchargements auto-provisionné.
gcs_volumes[]Buckets GCS à monter via le pilote CSI GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redisfalseActiver Redis pour la gestion des sessions. Requis pour les déploiements multi-réplicas.
redis_host""Point de terminaison Redis. Requis lorsque enable_redis = true.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis optionnel (sensible).

Groupe 16 — Base de données / MongoDB​

VariableValeur par défautDescription
database_typeNONEFixe — ne pas modifier. LibreChat n'utilise pas Cloud SQL.
firestore_mongodb_databaseLibreChatID de la base de données Firestore / nom de la base de données MongoDB.
firestore_mongodb_username""Nom d'utilisateur SCRAM pour l'authentification Firestore.
firestore_mongodb_password""Mot de passe SCRAM (sensible). Auto-généré s'il n'est pas défini.

Groupe 17 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde NFS automatisé (UTC).
backup_retention_days7Rétention ; augmentez à 30–90 pour la production/conformité.

Groupe 18 — Scripts SQL personnalisés​

Non applicable — LibreChat n'utilise pas Cloud SQL. Voir App_GKE pour les mécanismes partagés.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner une passerelle Kubernetes pour les noms d'hôte personnalisés + certificat géré.
application_domains[]Noms d'hôte à servir.
reserve_static_iptrueIP externe stable entre les redéploiements.

Groupe 20 — Proxy conscient de l'identité (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google devant LibreChat.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder.
iap_oauth_client_id / iap_oauth_client_secret""Requis lorsque l'IAP est activé (sensible).
iap_support_email""Affiché sur l'écran de consentement OAuth.

Groupe 21 — Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor (WAF) au backend Ingress.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
cloud_armor_policy_namedefault-waf-policyNom de la politique.

Groupe 22 — Contrôles de service VPC et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Ces valeurs sont renvoyées en cas de déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsMappage des ClusterIP pour les services spécifiques à chaque étape (Cloud Deploy).
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre LibreChat.
storage_bucketsBuckets Cloud Storage créés (inclut le bucket des téléchargements).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsStatut et canaux de surveillance.
initialization_jobsNoms des jobs de configuration exécutés.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster et la charge de travail sont prêts. Faux lors du premier apply d'un nouveau cluster intégré — relancez l'apply pour terminer.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence si incorrect
CREDS_KEY / CREDS_IV (auto-généré)défini une foisCritiqueClés AES-GCM pour les identifiants de fournisseur d'IA enregistrés. La rotation après que les utilisateurs ont enregistré des clés détruit tous les identifiants stockés — chaque utilisateur doit ressaisir ses clés API.
mongodb_urilaisser par défaut (aide mongo:7 dans l'espace de noms) ou définir explicitementCritiqueLibreChat nécessite MongoDB. L'aide mongo:7 par défaut dans l'espace de noms a besoin de enable_nfs = true pour son répertoire de données ; la surcharge de mongodb_uri à "" sur l'appel LibreChat_Common (contournant le câblage par défaut de ce module) avec une configuration Firestore/Atlas défectueuse fait planter le pod au démarrage et ne sert aucun trafic.
enable_cloudsql_volumefalseCritiqueDoit rester false. L'activation injecte un sidecar Cloud SQL Auth Proxy qui entre en conflit avec le routage de connexion MongoDB uniquement.
database_typeNONECritiqueLa définition d'un moteur SQL provisionne une instance Cloud SQL inutilisée à un coût supplémentaire sans bénéficier à LibreChat.
secret_environment_variables (clés IA)utiliser des secretsCritiqueLes clés de fournisseur d'IA passées en environment_variables sont visibles dans kubectl describe pod et les journaux d'audit GCP. Utilisez toujours des références Secret Manager.
iap_oauth_client_id / _secretdéfinir lorsque IAP est activéCritiqueRequis lorsque enable_iap = true. Si non fourni, la passerelle IAP ne s'initialise pas et le service devient inaccessible.
quota_memory_requests / _limitsunités binairesCritiqueLes entiers bruts sont des octets et bloquent toute planification.
allow_registrationfalse après la configurationÉlevéL'enregistrement ouvert sur un déploiement exposé par un LoadBalancer permet à quiconque de créer un compte. Désactiver après la création de l'administrateur ou restreindre avec IAP.
enable_redistrue pour multi-réplicaÉlevéSans Redis, les redémarrages de pod et la replanification interrompent toutes les sessions actives et les flux SSE acheminés vers ce pod.
redis_hostpoint de terminaison expliciteÉlevéRequis lorsque enable_redis = true. Si vide, LibreChat ne parvient pas à se connecter à Redis au démarrage.
timeout_seconds600ÉlevéLe streaming SSE pour les longues réponses d'IA peut dépasser plusieurs minutes. Un délai d'expiration insuffisant tronque les réponses en cours de flux.
min_instance_count1ÉlevéLa mise à l'échelle à zéro interrompt tous les flux SSE en cours et provoque une latence de démarrage à froid au réveil.
JWT_SECRET (auto-généré)défini une foisÉlevéLa rotation invalide toutes les sessions actives simultanément. Planifiez la rotation pendant une fenêtre de maintenance.
enable_nfstrue (par défaut) avec l'aide MongoDB par défautÉlevéL'aide mongo:7 dans l'espace de noms (le backend de base de données par défaut) monte son répertoire de données (/data/db) à partir du volume NFS — désactiver enable_nfs avec l'aide active le laisse sans volume à monter. Également nécessaire pour les déploiements multi-réplicas afin que les fichiers téléchargés ne soient pas locaux au pod.
backup_scheduledéfinir pour la productionÉlevéSans sauvegardes, l'historique des conversations et les données utilisateur dans MongoDB/Firestore n'ont pas d'instantanés au niveau GCS.
application_versionversion épingléeMoyenlatest peut introduire des modifications de schéma MongoDB ou des incompatibilités d'API lors de mises à niveau non planifiées.
enable_iap / enable_cloud_armoractiver pour la productionMoyenLibreChat est autrement directement accessible depuis l'internet public avec seulement une connexion au niveau de l'application pour le protéger.
pdb_min_available vs min_instance_countlaisser de la margeMoyen1/1 peut bloquer les mises à niveau de nœuds (un seul pod ne peut pas être expulsé).

Pour le comportement de base référencé partout — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à LibreChat partagée avec la variante Cloud Run est décrite dans LibreChat_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.