Aller au contenu principal

Chroma sur GKE Autopilot

Chroma sur GKE Autopilot

Chroma est une base de données vectorielle open source native de l'IA, conçue spécifiquement pour les embeddings et la recherche de similarité. Elle alimente les pipelines RAG, la recherche sémantique et les workflows LangChain/LlamaIndex. Ce module déploie Chroma sur GKE Autopilot sur la base de 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 Chroma 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 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 Chroma sur RAD, et comment cela se compare​

Le module GKE Autopilot de Chroma sur RAD coûte environ 42,08 $ 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). Chroma est une base de données vectorielle native de l'IA pour les embeddings et la recherche de similarité, utilisée pour soutenir les pipelines RAG et la recherche sémantique. Pour le coût le plus bas, le guide Cloud Run exécute le même Chroma pour environ 19,14 $ US par mois ; choisissez GKE ici uniquement si Chroma doit rester actif en continu, s'adapter à travers les pods, ou fonctionner aux côtés d'autres charges de travail Kubernetes.

Si Chroma n'est nécessaire qu'occasionnellement — une démo, un essai, une charge de travail saisonnière ou d'étude — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les 42,08 $ US deviennent quelques dollars par mois à la place. 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 à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 42,08 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 64 crédits par jour, environ 1 920 par mois (environ 192 $ 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 minimum acheté 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 assez d'historique GKE géré par RAD pour le mesurer, donc 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 lors d'une recharge ponctuelle, moins sur un plan. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, donc une deuxième application n'ajoute pas de deuxième base de données.

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

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 1x vCPU / 1 GiB36,08 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ 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 42,08 $ US

Comment cela se compare​

  • L'offre gérée du projet, Chroma Cloud, commence à 0 $ par mois plus l'utilisation (10 bases de données, 5 $ de crédits inclus — environ 2,50 $/GiB écrit, 0,33 $/GiB stocké par mois, et une petite charge par requête et par GiB retourné), passant à 250 $ par mois plus l'utilisation sur le plan Team.
  • Si vous l'exécutez vous-même, un petit VPS exécutant le propre processus serveur de Chroma coûte moins cher en espèces : un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go coûte environ 24 $ par mois, ou un GCP e2-standard-2 environ 49 $ par mois — plus votre propre temps pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous.
  • RAD ne prétend jamais être moins cher que l'infrastructure nue en termes monétaires — ce n'est généralement pas le cas. La différence est ce que RAD gère pour vous : les correctifs, les sauvegardes, les secrets et la surveillance, ainsi que la possibilité de mettre Chroma en pause gratuitement plutôt que de payer pour une capacité inactive (voir ci-dessous).

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

Si Chroma 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 à Chroma dont vous n'avez besoin qu'occasionnellement 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 invoqué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 qu'il attend. Contrairement à la suppression d'un module, cela ne démantèle pas les ressources GKE Autopilot une par une — 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 récupérer 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 192 $ US par mois pour le maintenir en fonctionnement. Déployez Chroma, utilisez-le, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour les heures où il était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du 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 palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes 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é Chroma et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Ne payez que pendant que vous l'utilisez, l'autre façon : supprimer et redéployer​

GKE Autopilot 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) dans votre propre projet. La suppression ne permet d'économiser de l'argent que si Chroma devait rester inutilisé pendant environ 6 jours ou plus dans votre propre projet (1,40 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (64 crédits par jour).
  • Conservez d'abord vos données. Les sauvegardes nocturnes sont écrites 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.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lors du déploiement.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant obtient l'application 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, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute l'application 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, 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 propres à RAD et estimations de crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle ; Chroma Cloud. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Chroma s'exécute comme une charge de travail de base de données vectorielle conteneurisée. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods StatefulSet ou Deployment, 1 vCPU / 1 GiB par défaut
Persistance des donnéesStatefulSet PVC (par défaut) ou GCS FUSEPVC par défaut ; GCS FUSE uniquement lorsque stateful_pvc_enabled = false
Stockage d'objetsCloud StorageBucket <prefix>-data auto-provisionné ; utilisé comme stockage principal lorsque PVC n'est pas activé
Jeton d'authentificationSecret ManagerJeton API optionnel — CHROMA_SERVER_AUTHN_CREDENTIALS injecté à l'exécution
IngressCloud Load BalancingClusterIP par défaut (accès interne au cluster) ; LoadBalancer optionnel avec IAP ou jeton d'authentification

Valeurs par défaut judicieuses à connaître d'emblée :

  • Pas de base de données SQL et pas de Redis. Chroma gère son propre stockage embarqué. Aucune instance Cloud SQL n'est créée et aucune connexion Redis n'est configurée.
  • ClusterIP par défaut. Le service n'est accessible qu'à l'intérieur du cluster ; la sortie endpoint_url n'est pas accessible depuis l'extérieur du cluster avec cette valeur par défaut. Définissez service_type = "LoadBalancer" uniquement si un accès externe est nécessaire, et activez enable_auth_token ou IAP en même temps.
  • Instance unique recommandée. max_instance_count = 1 est la valeur par défaut. Plusieurs pods Chroma partageant un seul PVC ne sont pas pris en charge — les écritures concurrentes corrompraient les collections.
  • StatefulSet PVC par défaut. stateful_pvc_enabled = true (la valeur par défaut) résout automatiquement le type de charge de travail en StatefulSet et désactive le volume GCS FUSE à /data pour éviter un conflit de double montage.
  • Le jeton d'authentification est facultatif mais recommandé pour tout déploiement accessible en dehors de l'espace de noms du pod. Lorsqu'il est activé, le jeton est stocké dans Secret Manager et doit être transmis comme Authorization: Bearer <token> dans chaque appel API.
  • Les sondes de santé sont fixées à /api/v2/heartbeat. C'est le seul point de terminaison de santé exposé par Chroma.
  • La télémétrie anonymisée est toujours désactivée. ANONYMIZED_TELEMETRY=false est injecté automatiquement.
  • De nombreuses entrées de configuration de base de données/Redis/build sont inertes. Chroma_GKE déclare la surface complète des variables App_GKE (base de données, Redis, build de conteneur, quota et autres entrées miroir de la fondation) pour la parité check_conventions.py, mais la plupart d'entre elles sont codées en dur ou ignorées par Chroma_Common/main.tf — voir la Section 4 pour la liste complète, par groupe.

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 rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Chroma​

Les pods Chroma sont planifiés sur Autopilot, qui facture le CPU et la mémoire que les pods demandent réellement. Le déploiement s'exécute en tant que StatefulSet (lorsqu'il est soutenu par PVC) ou Deployment (lorsqu'il est soutenu par GCS FUSE), avec Horizontal Pod Autoscaling gérant le nombre de réplicas.

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

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

B. Persistance des données — StatefulSet PVC ou GCS FUSE​

Chroma stocke sa base de données SQLite embarquée, ses fichiers d'index HNSW et les métadonnées de collection dans un volume persistant à /data. Deux backends de stockage sont disponibles :

StatefulSet PVC (par défaut) : Un PersistentVolumeClaim Kubernetes soutenu par un PD équilibré (standard-rwo) ou SSD (premium-rwo) est provisionné par pod, fournissant un accès disque local à faible latence pour les lectures et écritures d'index.

  • Console : Kubernetes Engine → Stockage → PersistentVolumeClaims.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    kubectl describe pvc -n "$NAMESPACE" <pvc-name>

GCS FUSE (uniquement lorsque stateful_pvc_enabled = false) : Un bucket Cloud Storage (<prefix>-data) est provisionné et monté à /data via le pilote CSI GCS FUSE.

  • Console : Cloud Storage → Buckets — recherchez le bucket dont le nom se termine par -data.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/chroma/ # inspect Chroma's on-disk layout
    # Confirm the GCS FUSE mount inside a pod:
    kubectl exec -n "$NAMESPACE" <pod-name> -- df -h | grep /data

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

C. Secret Manager​

Lorsque enable_auth_token = true, le jeton d'authentification API de Chroma est généré et stocké en tant que secret Secret Manager. Il est injecté dans les pods à l'exécution en tant que CHROMA_SERVER_AUTHN_CREDENTIALS ; le texte en clair n'apparaît jamais dans la configuration.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    # Retrieve the token to configure API clients:
    gcloud secrets versions access latest --secret=<prefix>-auth-token --project "$PROJECT"

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

D. Réseau et ingress​

Par défaut, le service Chroma est exposé en tant que ClusterIP, accessible uniquement au sein du cluster. Lorsque service_type = "LoadBalancer" est défini, une adresse IP externe de Cloud Load Balancing est provisionnée. Un domaine personnalisé, une adresse IP statique et Cloud Armor peuvent être superposés.

  • Console : Kubernetes Engine → Services et Ingress ; Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"
    # Test the Chroma heartbeat from inside the cluster:
    kubectl run -n "$NAMESPACE" --rm -it curl --image=curlimages/curl -- \
    curl http://<cluster-ip>:8000/api/v2/heartbeat

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'adresse IP statique.

E. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE sont acheminées vers Cloud Monitoring. Des tests de disponibilité optionnels contre /api/v2/heartbeat et des stratégies d'alerte 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 Chroma​

  • Pas de bootstrap de base de données. Chroma gère son propre stockage embarqué et ne nécessite aucun job d'initialisation de base de données. Aucun job db-init n'est injecté. Si vous fournissez des initialization_jobs personnalisés, ils s'exécutent avant le démarrage de l'application.
  • Chargement de l'index au démarrage. Lorsque Chroma redémarre (après une éviction de pod ou une mise à jour progressive), il charge ses index HNSW à partir du PVC ou du bucket GCS. Pour les grandes collections, cela peut prendre des dizaines de secondes ; la sonde de démarrage à /api/v2/heartbeat attend que Chroma signale sa disponibilité.
  • Contrainte d'écriture unique. Chroma n'a pas de verrouillage distribué sur son stockage. L'exécution de plusieurs pods écrivant sur le même PVC ou chemin GCS corrompra les collections. Gardez max_instance_count = 1 à moins que vous n'exécutiez un déploiement de cluster Chroma avec un stockage séparé par pod.
  • Utilisation du jeton d'authentification. Lorsque enable_auth_token = true, tous les appels API doivent inclure Authorization: Bearer <token>. Récupérez le jeton de Secret Manager, puis utilisez-le avec le client Python :
    # Retrieve token
    TOKEN=$(gcloud secrets versions access latest \
    --secret=<prefix>-auth-token --project "$PROJECT")
    import chromadb
    client = chromadb.HttpClient(
    host="<cluster-ip>", port=8000,
    headers={"Authorization": f"Bearer {TOKEN}"}
    )
  • Sonde de santé. Les sondes de démarrage et de vivacité ciblent toutes deux /api/v2/heartbeat avec un délai initial de 15 secondes. Le chemin de la sonde est fixé par Chroma_Common et ne peut pas être modifié.
  • Tâches planifiées. Chroma n'a pas de commandes planifiées intégrées. Utilisez cron_jobs si vous avez besoin de captures instantanées de collection périodiques ou de tâches de maintenance.

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 Chroma sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standard.

Groupe 0 — Métadonnées du module​

VariableValeur par défautDescription
module_descriptionChroma is the AI-native open-source vector database with 18,000+ GitHub stars, purpose-built for embeddings and similarity search. Accelerates AI application development with a production-grade store for RAG pipelines, semantic search, and LangChain/LlamaIndex workflows. Deploy on GKE Autopilot with StatefulSet persistence, GCS Fuse storage, optional token authentication, Workload Identity, Secret Manager, and horizontal auto-scaling.La description du module. (par exemple, "Chroma GKE : Déployer la base de données vectorielle Chroma sur GKE Autopilot.")
module_documentationhttps://docs.radmodules.dev/docs/modules/Chroma_GKEL'URL de la documentation du module.
module_dependency(défini)Spécifiez les noms des modules dont dépend ce module dans l'ordre dans lequel ils doivent être déployés. (par exemple, ["Services_GCP"])
module_services(défini)Spécifiez les services du module.
credit_cost75Spécifiez le coût du module. (par exemple, 50)
require_credit_purchasesfalseLorsque true, les frais de module ne peuvent être payés qu'avec des crédits achetés (abonnement ou recharge), et non avec des crédits offerts ou d'événement.
enable_purgetrueDéfinir à true pour activer la possibilité de purger ce module.
public_accesstrueDéfinir à true pour activer la disponibilité du module pour tous les utilisateurs de la plateforme.
require_services_gcp_moduletrueForce le déploiement du module Services_GCP avant ce module. Lorsque true, le déploiement échoue au moment de la planification avec une erreur claire si aucun réseau VPC géré par Services_GCP n'est détecté dans le projet. Définir à false pour permettre un déploiement autonome avec des ressources prérequises intégrées.
resource_creator_identityrad-module-creator@YOUR_PLATFORM_PROJECT.iam.gserviceaccount.comLe compte de service utilisé par Terraform pour créer des ressources dans le projet de destination. (par exemple, "rad-module-creator@YOUR_PLATFORM_PROJECT.iam.gserviceaccount.com")
shared_users(défini)Liste des utilisateurs qui peuvent afficher et déployer ce module quelle que soit la valeur du paramètre public_access. Saisissez une ou plusieurs adresses e-mail d'utilisateur. Métadonnées uniquement.
technical_support_users(défini)Liste des utilisateurs responsables du support technique de ce module. Saisissez une ou plusieurs adresses e-mail d'utilisateur. Le portail de déploiement achemine les demandes de support pour ce module vers ces utilisateurs. Métadonnées uniquement.
impersonation_service_account``E-mail du compte de service à emprunter lors de l'appel des API GCP à partir de scripts shell. Laisser vide pour utiliser les propres identifiants de l'exécuteur. (par exemple, 'deployer@my-project.iam.gserviceaccount.com')
job_execution_wait_timeout900Nombre maximal de secondes pendant lesquelles un déploiement attend que le job de configuration de la base de données (db-create) se termine avant d'avorter, de sorte qu'un job bloqué échoue rapidement au apply au lieu de rester bloqué jusqu'au timeout externe du build. Définissez-le à au moins la durée d'exécution du job plus une marge.
explicit_secret_values(défini)Valeurs sensibles brutes à injecter directement dans les Secrets Kubernetes, en contournant les lectures de source de données Secret Manager. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
scripts_dir``Chemin vers le répertoire des scripts d'initialisation. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
requires_services(défini)Mappage explicite des ressources provisionnées par Services_GCP dont ce module a besoin, indépendamment des valeurs par défaut actuelles des variables de Services_GCP. La plateforme lit ce mappage (pas module_services, qui est une liste lisible par l'homme pour l'interface utilisateur de confirmation de déploiement) pour décider quels commutateurs create_* de Services_GCP doivent être activés lors du provisionnement automatique ou de la mise à jour du déploiement Services_GCP partagé pour le projet de destination. Les clés reflètent les noms de variables booléennes de Services_GCP 1:1. create_redis et create_filestore_nfs doivent rester faux pour le chemin de déploiement automatisé : la VM NFS+Redis Compute Engine gratuite (create_network_filesystem) est ce que chaque déploiement automatisé obtient ; le passage à Cloud Memorystore/Filestore géré est une optimisation manuelle post-déploiement, jamais quelque chose qu'une chaîne de dépendances automatisée devrait demander par elle-même.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)Sélectionnez un projet existant sur la plateforme RAD ou entrez l'ID du projet d'un projet GCP externe. Vous devez accorder le rôle Propriétaire au compte de service de l'agent RAD GCP Project lors du déploiement dans un projet externe. (par exemple, 'my-project-123')
tenant_iddemoSpécifiez un identifiant unique de locataire ou de déploiement. Cela identifie de manière unique votre déploiement d'application et est utilisé dans la dénomination des ressources (1-7 caractères alphanumériques minuscules, pas de tirets — la limite de 7 caractères provient de la limite de 30 caractères de l'ID de compte de service de GCP).
regionus-central1Région GCP pour le déploiement des ressources (par exemple, 'us-central1'). Utilisé comme solution de repli lorsque la découverte du réseau ne peut pas déterminer la région à partir des sous-réseaux VPC existants.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
support_users(défini)Adresses e-mail des utilisateurs auxquels sera accordé l'accès au projet Google Cloud, aux alertes de surveillance et aux notifications (par exemple, ['admin@example.com', 'ops@example.com']).
resource_labels(défini)Étiquettes clé-valeur appliquées à toutes les ressources créées par ce module. Utilisez-les pour appliquer des politiques de marquage organisationnelles telles que le centre de coûts, l'environnement ou la propriété de l'équipe. (par exemple, { env = "prod", team = "engineering" })

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namechromaNom de l'application utilisé dans la dénomination des ressources. Doit commencer par une lettre et ne contenir que des lettres minuscules, des chiffres et des tirets (1-20 caractères). (par exemple, "chroma")
application_display_nameChroma Vector DatabaseNom de l'application lisible par l'homme à des fins d'affichage. (par exemple, "Base de données vectorielle Chroma")
application_descriptionChroma Vector Database on GKE AutopilotBrève description de l'objectif de l'application. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
descriptionChroma — the AI-native open-source vector database for embeddings and similarity searchBrève description de l'objectif du déploiement Chroma. Renseigne la description de la charge de travail GKE et la documentation de la plateforme. (par exemple, 'Base de données vectorielle Chroma pour les applications d'IA')
application_versionlatestTag de version de l'image Docker Chroma. Utilisez 'latest' pour la version stable la plus récente, ou épinglez à une version spécifique pour des déploiements reproductibles. (par exemple, 'latest', '0.5.0')

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir à true pour déployer l'infrastructure de l'application. Lorsque false, seules les ressources partagées (secrets, stockage, IAM) sont créées sans déployer la charge de travail GKE réelle.
container_image_sourcecustomDétermine la source de l'image conteneur. Utilisez 'prebuilt' pour déployer directement une URI d'image existante, ou 'custom' pour construire l'image à partir de la source. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
container_image``URI de l'image. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
container_build_config(défini)Configuration de build. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
enable_image_mirroringtrueMet en miroir l'image conteneur Chroma dans Artifact Registry avant le déploiement. Recommandé pour éviter les limites de débit de Docker Hub et améliorer la fiabilité du pull dans les environnements de production.
min_instance_count1Nombre minimum de réplicas de pods à maintenir en cours d'exécution en permanence. Pour Chroma, définissez-le à au moins 1 pour éviter les démarrages à froid. Doit être inférieur ou égal à max_instance_count. (par exemple, 1)
max_instance_count1Nombre maximal de réplicas de pods autorisés à s'exécuter simultanément. Pour Chroma sans mode distribué, 1 est typique. Doit être supérieur ou égal à min_instance_count. (par exemple, 1)
enable_vertical_pod_autoscalingfalseActiver l'autoscaling vertical de pods (VPA). Lorsqu'il est activé, l'HPA basé sur le CPU/Mémoire est désactivé pour éviter les conflits. Le VPA optimise automatiquement les demandes de ressources. (par exemple, false)
container_port8000Port TCP sur lequel le conteneur Chroma écoute. Pour Chroma, c'est toujours 8000 (défini via Chroma_Common) ; cette variable n'est pas transmise à App_GKE et n'a aucun effet.
container_protocolhttp1Version du protocole HTTP utilisée par le backend du service Kubernetes. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
container_resources(défini)Limites CPU/Mémoire pour le conteneur Chroma. Remarque : utilisez les variables cpu_limit et memory_limit pour définir les ressources du conteneur — cet objet structuré est accepté pour la compatibilité de l'interface utilisateur mais ne remplace pas cpu_limit/memory_limit.
timeout_seconds300Délai d'expiration de la requête en secondes (0-3600). Temps maximal qu'une requête peut prendre. (par exemple, 300)
enable_cloudsql_volumefalseInjecte un conteneur sidecar Cloud SQL Auth Proxy dans le pod GKE. Chroma n'utilise pas Cloud SQL — cela doit rester faux à moins que vous n'exécutiez un sidecar personnalisé aux côtés de Chroma.
cloudsql_volume_mount_path/cloudsqlChemin de montage du socket Cloud SQL Auth Proxy. Non référencé — Chroma n'a pas de base de données Cloud SQL.
service_annotations(défini)Annotations personnalisées appliquées à la ressource Service Kubernetes. (par exemple, { "cloud.google.com/neg" = "{\\"ingress\\": true}" })
service_labels(défini)Étiquettes personnalisées appliquées spécifiquement à la ressource Service Kubernetes. (par exemple, { category = "production", tier = "database" })
cloud_sql_proxy_version2-alpineTag d'image Cloud SQL Auth Proxy. Non applicable — Chroma n'a pas de base de données Cloud SQL.
cpu_limit1000mLimite CPU allouée au conteneur Chroma. (par exemple, '1000m', '2000m')
memory_limit1GiLimite de mémoire allouée au conteneur Chroma. Chroma charge les index d'embedding en mémoire ; dimensionnez-le en fonction de vos collections. (par exemple, '1Gi', '4Gi')
enable_auth_tokenfalseGénère un jeton d'authentification aléatoire et le stocke dans Secret Manager. Lorsque true, Chroma est démarré avec CHROMA_SERVER_AUTHN_CREDENTIALS et CHROMA_SERVER_AUTHN_PROVIDER définis de sorte que tous les appels API nécessitent le jeton. Recommandé pour tout déploiement accessible en dehors du pod/namespace.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables(défini)Variables d'environnement statiques pour le conteneur Chroma sous forme de paires clé-valeur. (par exemple, { CHROMA_LOG_CONFIG_FILE = "/chroma/log_config.yml" })
secret_environment_variables(défini)Variables d'environnement de Secret Manager. Mappe le nom de la variable d'environnement au nom du secret Secret Manager.
secret_rotation_period2592000sCalendrier de rotation des secrets. (par exemple, '2592000s' pour 30 jours)
secret_propagation_delay30Temps en secondes à attendre après la création ou la mise à jour d'un secret avant de poursuivre les opérations dépendantes. (par exemple, 30)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 6 — Backend et cluster GKE​

VariableValeur par défautDescription
gke_cluster_name``Nom du cluster GKE dans lequel déployer. Laisser vide pour la découverte automatique. (par exemple, 'gke-cluster-1')
prereq_gke_subnet_cidr10.201.0.0/24Plage CIDR pour le sous-réseau GKE intégré. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
gke_cluster_selection_modeprimaryStratégie de choix du cluster GKE cible. (par exemple, 'primary')
prereq_subnet_cidr_override``Remplacement pour le CIDR du sous-réseau primaire VPC intégré.
namespace_name``Espace de noms Kubernetes pour le déploiement. Laisser vide pour générer automatiquement à partir de application_name et tenant_id. (par exemple, 'chroma-prod')
prereq_gke_pod_cidr_override``Remplacement pour le CIDR de la plage secondaire de pods GKE intégrée.
prereq_gke_service_cidr_override``Remplacement pour le CIDR de la plage secondaire de services GKE intégrée.
workload_typenullType de charge de travail Kubernetes. Utilisez 'StatefulSet' (recommandé pour Chroma) pour une identité de pod stable et des redémarrages ordonnés, ou 'Deployment' pour un fonctionnement sans état avec un stockage basé sur GCS. (par exemple, 'Deployment' ou 'StatefulSet')
service_typeClusterIPType de service Kubernetes. Gardez 'ClusterIP' (par défaut) pour que Chroma ne soit accessible qu'à l'intérieur du cluster — la sortie api_url n'est pas accessible depuis l'extérieur du cluster avec ce paramètre. Définissez 'LoadBalancer' uniquement si un accès externe est nécessaire, et activez IAP ou enable_auth_token en même temps.
session_affinityNoneMode d'affinité de session pour le service Kubernetes. (par exemple, 'None' ou 'ClientIP')
enable_multi_cluster_servicefalseActive les services multi-clusters (MCS) pour l'application. Non référencé — la définition de cette variable n'a aucun effet.
extra_service_ports(défini)Ports supplémentaires à exposer sur le service Kubernetes, pour une charge de travail qui utilise plus d'un protocole sur le même pod. Reflète la variable App_GKE pour satisfaire les vérifications de convention ; déclarée mais NON transmise par ce module, donc sa définition n'a aucun effet ici. Par défaut, une liste vide, ce qui rend exactement le service que ce module rendait auparavant.
configure_service_meshfalseActive l'injection de maillage de services Istio pour l'espace de noms de l'application. Nécessite que Cloud Service Mesh ou Anthos Service Mesh soit installé sur le cluster.
enable_network_segmentationfalseActiver les NetworkPolicies Kubernetes pour la micro-segmentation. (par exemple, false)
termination_grace_period_seconds60Secondes pendant lesquelles Kubernetes attend après SIGTERM avant de terminer de force. Augmenter pour permettre à Chroma de vider les écritures en cours. Plage valide : 0–3600. (par exemple, 60)
deployment_timeout1800Nombre maximal de secondes pendant lesquelles Terraform attend la fin du déploiement Kubernetes. (par exemple, 1800)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 7 — Configuration StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueActiver la revendication de volume persistant pour StatefulSet. Recommandé pour Chroma afin d'éviter la surcharge d'E/S de GCS FUSE pour les grandes collections. Lorsque true sans workload_type explicite, se résout automatiquement en 'StatefulSet'. (par exemple, false)
stateful_pvc_size20GiTaille de stockage pour chaque PVC provisionné par le StatefulSet. Dimensionnez le PVC pour contenir toutes les collections Chroma plus la surcharge. (par exemple, '20Gi', '50Gi')
stateful_pvc_mount_path/dataChemin du système de fichiers à l'intérieur du conteneur Chroma où le PVC par pod est monté. (par exemple, '/data')
stateful_pvc_storage_classstandard-rwoStorageClass Kubernetes pour les PVC StatefulSet. 'standard-rwo' (PD équilibré) est la valeur par défaut pour GKE Autopilot. Utilisez 'premium-rwo' pour des IOPS plus élevées. (par exemple, 'standard-rwo', 'premium-rwo')
stateful_headless_servicenullCréer un service sans tête pour le StatefulSet afin d'activer des identités réseau stables. (par exemple, true)
stateful_pod_management_policynullContrôle l'ordre dans lequel les pods sont créés et supprimés. 'OrderedReady' est requis pour des redémarrages Chroma sûrs. (par exemple, 'OrderedReady' ou 'Parallel')
stateful_update_strategynullStratégie de mise à jour pour le StatefulSet. Utilisez 'RollingUpdate' pour des mises à jour sans temps d'arrêt. (par exemple, 'RollingUpdate' ou 'OnDelete')
stateful_fs_group1000GID défini comme fsGroup au niveau du pod dans le contexte de sécurité du StatefulSet. Garantit que le PVC est inscriptible par le groupe. Définir à 0 pour laisser fsGroup non défini. (par exemple, 1000)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalseCrée un ResourceQuota Kubernetes dans l'espace de noms de l'application.
quota_cpu_requests``Quota total de requêtes CPU pour l'espace de noms. Non référencé — la définition de cette variable n'a aucun effet.
quota_cpu_limits``Quota total de limites CPU pour l'espace de noms. Non référencé — la définition de cette variable n'a aucun effet.
quota_memory_requests``Quota total de requêtes mémoire pour l'espace de noms (par exemple, '4Gi'). Doit utiliser des suffixes d'unité binaire tels que 'Gi' ou 'Mi' — les entiers nus sont traités comme des octets par Kubernetes et bloqueront toute planification de pod.
quota_memory_limits``Quota total de limites mémoire pour l'espace de noms (par exemple, '8Gi'). Doit utiliser des suffixes d'unité binaire tels que 'Gi' ou 'Mi' — les entiers nus sont traités comme des octets par Kubernetes et bloqueront toute planification de pod.
quota_max_pods``Nombre maximal de pods dans l'espace de noms. Non référencé — la définition de cette variable n'a aucun effet.
quota_max_services``Nombre maximal de services dans l'espace de noms. Non référencé — la définition de cette variable n'a aucun effet.
quota_max_pvcs``Nombre maximal de PVC dans l'espace de noms. Non référencé — la définition de cette variable n'a aucun effet.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueCrée un PodDisruptionBudget Kubernetes pour limiter l'indisponibilité des pods lors de perturbations volontaires.
pdb_min_available1Nombre minimum de pods disponibles lors de perturbations volontaires. (par exemple, '1')
enable_topology_spreadfalseAjoute des TopologySpreadConstraints Kubernetes. Non référencé — la définition de cette variable n'a aucun effet.
topology_spread_strictfalseContrôle le comportement whenUnsatisfiable de la contrainte de répartition de topologie. Non référencé — la définition de cette variable n'a aucun effet.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_config(défini)Configuration de la sonde de démarrage Kubernetes. Chroma expose /api/v2/heartbeat. Exemple : { enabled = true, type = "HTTP", path = "/api/v2/heartbeat", initial_delay_seconds = 15, timeout_seconds = 5, period_seconds = 10, failure_threshold = 10 }.
health_check_config(défini)Configuration de la sonde de vivacité Kubernetes. Utilise /api/v2/heartbeat (point de terminaison de santé de Chroma). Exemple : { enabled = true, type = "HTTP", path = "/api/v2/heartbeat", initial_delay_seconds = 30, timeout_seconds = 5, period_seconds = 30, failure_threshold = 3 }.
uptime_check_config(défini)Configuration du test de disponibilité. Surveille la disponibilité du service. Exemple : { enabled = true, path = "/api/v2/heartbeat", check_interval = "60s", timeout = "10s" }.
alert_policies(défini)Stratégies d'alerte personnalisées pour Cloud Monitoring.
startup_probe(défini)Configuration de la sonde de démarrage. Chroma expose /api/v2/heartbeat une fois qu'il est entièrement prêt à servir les requêtes. Exemple : { enabled = true, type = "HTTP", path = "/api/v2/heartbeat", initial_delay_seconds = 15, timeout_seconds = 5, period_seconds = 10, failure_threshold = 10 }.
liveness_probe(défini)Configuration de la sonde de vivacité. Utilise /api/v2/heartbeat (point de terminaison de santé de Chroma). Exemple : { enabled = true, type = "HTTP", path = "/api/v2/heartbeat", initial_delay_seconds = 30, timeout_seconds = 5, period_seconds = 30, failure_threshold = 3 }.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
initialization_jobs(défini)Jobs Kubernetes pour les tâches d'initialisation. Chroma ne nécessite aucune initialisation par défaut ; ne fournissez des jobs que pour le chargement de données personnalisées ou les tâches de migration.
cron_jobs(défini)Liste des CronJobs à déployer aux côtés de Chroma (par exemple, pour les instantanés de collection ou les tâches de maintenance).
additional_services(défini)Liste des services Kubernetes supplémentaires à déployer aux côtés de Chroma (par exemple, sidecars, services d'aide).

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 12 — CI/CD, Binary Authorization et Cloud Deploy​

VariableValeur par défautDescription
enable_cicd_triggerfalseActiver le déclencheur Cloud Build automatisé pour CI/CD. (par exemple, false)
github_repository_url``URL du dépôt GitHub pour CI/CD automatisé (par exemple, 'https://github.com/username/repo').
github_token``Jeton d'accès personnel (PAT) GitHub. Requis lorsque enable_cicd_trigger est true.
github_app_installation_id``ID d'installation de l'application GitHub.
cicd_trigger_config(défini)Configuration du déclencheur Cloud Build pour le pipeline CI/CD automatisé. Exemple : { branch_pattern = "^main$", included_files = [], ignored_files = [], trigger_name = null, description = "Automated build and deployment trigger", substitutions = { } }.
enable_cloud_deployfalseActiver Google Cloud Deploy pour un pipeline de promotion géré Dev → Staging → Prod. Nécessite enable_cicd_trigger = true.
cloud_deploy_stages(défini)Liste ordonnée des étapes du pipeline Cloud Deploy.
enable_binary_authorizationfalseActiver Binary Authorization pour ce déploiement. (par exemple, false)
binauthz_evaluation_modeALWAYS_ALLOWMode d'application de Binary Authorization. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 13 — NFS​

VariableValeur par défautDescription
enable_nfsfalseProvisionne une instance Cloud Filestore (NFS) et la monte dans le pod GKE en tant que volume persistant partagé.
nfs_mount_path/mnt/nfsChemin du système de fichiers à l'intérieur du conteneur où le volume NFS est monté. (par exemple, '/mnt/nfs')
nfs_volume_namenfs-data-volumeNom du volume pour le montage NFS. (par exemple, 'nfs-data-volume')
nfs_instance_name``Nom d'une VM NFS GCE existante à utiliser. Laisser vide pour la découverte automatique.
nfs_instance_base_nameapp-nfsNom de base pour la VM NFS GCE intégrée. (par exemple, 'app-nfs')

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueContrôle si le module provisionne les buckets GCS définis dans storage_buckets.
storage_buckets(défini)Buckets Cloud Storage à créer en plus du bucket de données Chroma.
gcs_volumes(défini)Montages de volume GCS FUSE via le pilote CSI. Le bucket de données Chroma est automatiquement ajouté ; utilisez ceci pour des volumes supplémentaires.
manage_storage_kms_iamfalseLorsque true, crée un trousseau de clés KMS CMEK et une clé de chiffrement de stockage.
enable_artifact_registry_cmekfalseLorsque true, active le chiffrement CMEK des images conteneurs dans Artifact Registry.
max_images_to_retain7Nombre maximal d'images conteneurs récentes à conserver dans Artifact Registry. Définir à 0 pour désactiver. (par exemple, 7)
delete_untagged_imagestrueSupprimer automatiquement les images conteneurs non taguées d'Artifact Registry. (par exemple, true)
image_retention_days30Jours après lesquels les images conteneurs sont éligibles à la suppression. Définir à 0 pour désactiver. (par exemple, 30)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 15 — Redis (transmis, non applicable à Chroma)​

VariableValeur par défautDescription
enable_redisfalseActive la configuration Redis pour l'application en injectant les variables d'environnement REDIS_HOST et REDIS_PORT dans le déploiement GKE. Si true et que redis_host est laissé vide, le module utilise par défaut l'adresse IP du serveur NFS comme hôte Redis. Définissez redis_host explicitement pour vous connecter à une instance Redis dédiée telle que Memorystore.
redis_host``Nom d'hôte ou adresse IP du serveur Redis injecté en tant que variable d'environnement REDIS_HOST. Utilisé uniquement lorsque enable_redis est true. Laisser vide pour utiliser par défaut l'adresse IP du serveur NFS. (par exemple, '10.0.0.5', 'redis.internal.example.com')
redis_port6379Port TCP du serveur Redis injecté en tant que variable d'environnement REDIS_PORT. Utilisé uniquement lorsque enable_redis est true. (par exemple, '6379')
redis_auth``Mot de passe d'authentification Redis. Non applicable à Chroma. Transmis au module de fondation pour compatibilité.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 16 — Configuration de la base de données (transmis, non applicable à Chroma)​

VariableValeur par défautDescription
database_typeNONEMoteur de base de données Cloud SQL. Non référencé — Chroma n'a pas de base de données SQL ; le database_type est fixé à NONE par Chroma_Common.
sql_instance_name``Nom d'une instance Cloud SQL existante. Non référencé — Chroma n'a pas de base de données SQL.
sql_instance_base_nameapp-sqlNom de base pour l'instance Cloud SQL intégrée. Non référencé — Chroma n'a pas de base de données SQL.
application_database_namegkeappdbNom de la base de données à créer dans l'instance Cloud SQL. Injecté dans l'application en tant que variable d'environnement DB_NAME. Utilisé uniquement lorsque database_type n'est pas 'NONE'. (par exemple, 'app_db', 'crm_production')
application_database_usergkeappuserNom d'utilisateur de l'utilisateur de la base de données créé pour l'application. Injecté dans l'application en tant que variable d'environnement DB_USER. Utilisé uniquement lorsque database_type n'est pas 'NONE'. (par exemple, 'app_user', 'crm_svc')
database_password_length32Longueur du mot de passe de la base de données généré aléatoirement. Non référencé — Chroma n'a pas de base de données SQL. Transmis à la fondation pour compatibilité. (par exemple, 32)
enable_postgres_extensionsfalseActiver les extensions PostgreSQL. Non référencé — Chroma n'a pas de base de données SQL.
postgres_extensions(défini)Extensions PostgreSQL à installer. Non référencé — Chroma n'a pas de base de données SQL.
enable_mysql_pluginsfalseActiver les plugins MySQL. Non référencé — Chroma n'a pas de base de données SQL. (par exemple, false)
mysql_plugins(défini)Liste des plugins MySQL à installer. Non référencé — Chroma n'a pas de base de données SQL.
enable_auto_password_rotationfalseActiver la rotation automatique du mot de passe de la base de données. Non applicable — Chroma n'a pas de base de données SQL.
rotation_propagation_delay_sec90Secondes à attendre après un événement de rotation du mot de passe de la base de données. Non applicable — Chroma n'a pas de base de données SQL.
db_password_env_var_name``Variable d'environnement supplémentaire pour exposer le mot de passe de la base de données. Non applicable — Chroma n'a pas de base de données SQL.
db_host_env_var_name``Nom de variable d'environnement supplémentaire pour exposer l'hôte de la base de données à côté du DB_HOST standard. Laisser vide pour injecter uniquement DB_HOST. (par exemple, 'DB_HOSTNAME')
db_user_env_var_name``Nom de variable d'environnement supplémentaire pour exposer l'utilisateur de la base de données à côté du DB_USER standard. Laisser vide pour injecter uniquement DB_USER. (par exemple, 'DB_USERNAME')
db_name_env_var_name``Nom de variable d'environnement supplémentaire pour exposer le nom de la base de données à côté du DB_NAME standard. Laisser vide pour injecter uniquement DB_NAME. (par exemple, 'DB_DATABASE')
db_port_env_var_name``Nom de variable d'environnement supplémentaire pour exposer le port de la base de données à côté du DB_PORT standard. Laisser vide pour injecter uniquement DB_PORT. (par exemple, 'DB_PORT_NUMBER')
db_namechromadbNon référencé — Chroma n'a pas de base de données SQL. Transmis au module de fondation pour compatibilité.
db_userchromauserNon référencé — Chroma n'a pas de base de données SQL. Transmis au module de fondation pour compatibilité.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 17 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Planification Cron pour les sauvegardes automatisées (par exemple, '0 2 * * *' pour tous les jours à 2h du matin). Laisser vide pour désactiver.
backup_retention_days7Nombre de jours pour conserver les fichiers de sauvegarde dans le bucket de sauvegarde GCS. (par exemple, 7)
enable_backup_importfalseActiver l'importation automatique d'une sauvegarde pendant le déploiement. (par exemple, false)
backup_sourcegcsSource de sauvegarde : 'gdrive' ou 'gcs'. (par exemple, 'gcs')
backup_filebackup.tarNom de fichier de la sauvegarde à importer. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
backup_uri``URI de sauvegarde. Pour GCS : URI complet comme 'gs://bucket/path/backup.tar'. Pour Google Drive : ID de fichier.
backup_formattarFormat du fichier de sauvegarde. (par exemple, 'tar')

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 18 — Scripts SQL personnalisés (non applicable à Chroma)​

VariableValeur par défautDescription
enable_custom_sql_scriptsfalseActiver l'exécution de scripts SQL personnalisés depuis GCS pendant l'initialisation. Non applicable à Chroma (pas de base de données SQL). (par exemple, false)
custom_sql_scripts_bucket``Nom du bucket GCS contenant les scripts SQL personnalisés. Non applicable à Chroma.
custom_sql_scripts_path``Préfixe de chemin dans le bucket GCS pour les scripts SQL. Non applicable à Chroma.
custom_sql_scripts_use_rootfalseExécuter des scripts SQL personnalisés en tant qu'utilisateur root de la base de données. Non applicable à Chroma. (par exemple, false)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
enable_custom_domaintrueActiver la configuration de domaine personnalisé via l'API Kubernetes Gateway avec des certificats SSL. (par exemple, false)
application_domains(défini)Liste des domaines personnalisés pour l'application (par exemple, ['chroma.example.com']).
reserve_static_iptrueRéserver une IP externe statique. Recommandé pour la production.
static_ip_name``Nom de l'IP statique réservée. Laisser vide pour générer automatiquement.
network_tags(défini)Tags réseau appliqués aux nœuds GKE. Le tag 'nfsserver' est requis lorsque enable_nfs est true. (par exemple, ['allow-ingress', 'nfsserver'])
network_name``Nom du réseau VPC à utiliser. Laisser vide pour la découverte automatique. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.
gateway_backend_stagedevÉtape Cloud Deploy dont le service est ciblé par la Gateway HTTPRoute. Pertinent uniquement lorsque enable_cloud_deploy est true. (par exemple, 'dev')

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseActiver Identity-Aware Proxy (IAP) pour l'authentification via Kubernetes Gateway. Requis lorsque service_type est 'LoadBalancer' pour empêcher l'accès externe non authentifié à l'API Chroma. Nécessite que enable_custom_domain ou enable_cdn soit true. (par exemple, false)
iap_authorized_users(défini)Liste des e-mails d'utilisateurs autorisés à accéder via IAP (par exemple, ['user:alice@example.com']).
iap_authorized_groups(défini)Liste des groupes Google autorisés à accéder via IAP (par exemple, ['group:engineering@example.com']).
iap_oauth_client_id``ID client OAuth pour IAP. Requis lorsque enable_iap est true.
iap_oauth_client_secret``Secret client OAuth pour IAP. Requis lorsque enable_iap est true.
iap_support_email``E-mail de support pour l'écran de consentement OAuth IAP. Non référencé — la définition de cette variable n'a aucun effet sur le déploiement dans ce module d'application.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

Groupe 21 — Cloud Armor et CDN​

VariableValeur par défautDescription
enable_cloud_armorfalseAttache une politique de sécurité Cloud Armor au backend Ingress GKE. Nécessite que enable_custom_domain soit true ou que service_type soit 'LoadBalancer'.
admin_ip_ranges(défini)Plages CIDR d'administration autorisées pour l'accès privilégié. (par exemple, ['203.0.113.0/24'])
cloud_armor_policy_namedefault-waf-policyLe nom de la politique de sécurité Cloud Armor à appliquer. (par exemple, "default-waf-policy")
enable_cdnfalseActiver Cloud CDN via GCPBackendPolicy. (par exemple, false)

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
enable_vpc_scfalseActiver l'application du périmètre des contrôles de service VPC.
vpc_cidr_ranges(défini)Plages CIDR de sous-réseau VPC pour le niveau d'accès réseau VPC-SC.
vpc_sc_dry_runtrueLorsque true, les violations VPC-SC sont journalisées mais non bloquées.
organization_id``ID d'organisation GCP pour la politique Access Context Manager VPC-SC.
enable_audit_loggingfalseActiver les journaux d'audit Cloud détaillés pour tous les services GCP pris en charge.

Toutes les autres entrées de ce groupe suivent le comportement standard d'App_GKE.


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 interne au 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).
endpoint_urlPoint de terminaison de l'API REST Chroma (<service-url>:8000).
storage_bucketsBuckets Cloud Storage créés.
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_channelsÉtat et canaux de surveillance.
initialization_jobsNoms des jobs de configuration personnalisés.
statefulset_nameNom du StatefulSet (lors de l'utilisation d'un stockage adossé à un PVC).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants du projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt(e).
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat de VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état 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 en cas d'erreur
enable_auth_tokentrue pour tout déploiement accessible de l'extérieurCritiqueSans jeton, tout appelant pouvant atteindre l'API Chroma peut lire, écrire ou supprimer chaque collection.
stateful_pvc_enabledtrue pour la productionÉlevéSans PVC, Chroma stocke les données dans le système de fichiers éphémère du conteneur. Un redémarrage du pod efface toutes les collections et tous les vecteurs.
stateful_pvc_mount_path/dataCritiqueSi le chemin de montage ne correspond pas au répertoire de stockage de Chroma, les données sont écrites dans la couche éphémère et perdues silencieusement au redémarrage.
stateful_pvc_size20Gi (taille généreusement)ÉlevéUn PVC plein provoque le crash de Chroma avec des erreurs de disque plein. La capacité du PVC ne peut pas être réduite après le provisionnement.
max_instance_count1ÉlevéPlusieurs pods Chroma sur le même stockage corrompront les collections — Chroma n'a pas de verrou d'écriture distribué.
memory_limit4Gi+ pour la productionÉlevéChroma charge les index HNSW en mémoire. Le 1Gi par défaut ne prend en charge que de très petites collections ; les arrêts OOM interrompent les requêtes en cours.
workload_typedéfini par stateful_pvc_enabledÉlevéLa définition explicite de "Deployment" avec stateful_pvc_enabled = true échoue au moment de la planification.
quota_memory_requests / _limitsunités binairesCritiqueLes entiers bruts sont des octets et bloquent toute planification de pod.
application_versionépingler à une balise spécifiqueMoyenL'utilisation de latest rend les déploiements non reproductibles. Les formats de données Chroma peuvent changer entre les versions majeures.
iap_oauth_client_id / _secretdéfinir avant d'activer IAPÉlevéLa définition de enable_iap = true sans informations d'identification OAuth valides bloque tout le trafic.
enable_iap / enable_cloud_armoractiver pour les services accessibles de l'extérieurÉlevéSans authentification, un point de terminaison Chroma exposé à l'extérieur est entièrement ouvert.
backup_retention_daysaugmenter pour la productionMoyenTrop court pour la reprise après sinistre ; les instantanés GCS ou PVC réguliers sont la principale voie de récupération.
min_instance_count1MoyenLa mise à l'échelle à zéro entraîne la suppression du pod ; après la mise à l'échelle, Chroma doit recharger les index à partir du PVC ou de GCS, ce qui ajoute de la latence au démarrage.
database_type / sql_instance_name / application_database_name_user / redis_host_port_authlaisser par défautFaibleCes entrées du groupe 15/16 sont transmises à App_GKE uniquement pour la parité de convention ; Chroma_Common corrige database_type = "NONE" et main.tf code en dur enable_redis = false, donc les modifier n'a aucun effet.
container_image_source / container_protocol / container_build_configlaisser par défautFaibleNon référencé par ce module — la source de l'image, le build et le protocole sont fixés par Chroma_Common. Les modifier n'a aucun effet.

Pour le comportement du socle 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 à Chroma partagée avec la variante Cloud Run est décrite dans Chroma_Common.

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