Aller au contenu principal

Qdrant sur Google Cloud Run

Qdrant sur Google Cloud Run

Qdrant est une base de données vectorielle et un moteur de recherche de similarité haute performance conçu pour les charges de travail d'IA — pipelines RAG, systèmes de recommandation, recherche sémantique et stockage d'embeddings. Ce module déploie Qdrant sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Qdrant et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


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

L'exécution de Qdrant dans votre propre projet Google Cloud coûte environ 19,14 $ US/mois en infrastructure, plus des frais de module uniques de 40 crédits RAD (dimensionnés à 1 vCPU / 1 GiB sur une instance Cloud Run chaude toujours active). RAD facture les frais de module une seule fois, au moment du déploiement — jamais plus lors d'une mise à jour — et les builds sont inclus dans le prix ; l'utilisation de Google Cloud elle-même est facturée à votre propre compte de facturation au prix catalogue de Google. Sur un projet géré par RAD, les mêmes ressources sont mesurées à l'heure en crédits au prix catalogue plus la marge de RAD — environ 17 crédits/jour — et les frais de module sont inférieurs de 10 %, soit 36 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement Qdrant géré par RAD peut être arrêté, sans frais de fonctionnement, jusqu'à ce que vous en ayez à nouveau besoin. (ou voir le guide GKE si vous avez besoin de Kubernetes)

Ce que vous payez sur RAD​

ÉlémentVotre propre projetProjet géré par RAD
Frais de module40 crédits (une fois)36 crédits (une fois)
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 buildIdentique
Coût de fonctionnement Google Cloud~19,14 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~17 crédits/jour, mesurés à l'heure au prix catalogue + marge de RAD

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : 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).

Coût de fonctionnement par défaut dans votre propre projet

Ressource$/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 1 GiB (chaud)13,14
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Total19,14 $

Comment cela se compare​

  • Nous n'avons pas pu vérifier un prix SaaS commercial actuel, directement comparable, pour ce projet open source exact, donc la comparaison honnête est un serveur autogéré nu : Hetzner CPX22 (2 vCPU/4 Go, ~24 $/mois), un Droplet DigitalOcean 2 vCPU/4 Go (~24 $/mois), ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, ~49 $/mois). L'empreinte propre de cette application (1 vCPU ou moins, 1 GiB ou moins) est plus petite que n'importe laquelle de ces classes, donc une machine autogérée nue dimensionnée pour correspondre coûterait moins cher que les chiffres ci-dessus — mais vous seriez toujours responsable de chaque correctif, sauvegarde et mise à jour de sécurité.
  • RAD ne prétend pas battre un VPS nu sur le prix affiché — ce n'est généralement pas le cas. Ce que RAD ajoute pour un montant en dollars identique ou similaire, c'est une base de données gérée, des identifiants conservés dans Secret Manager, une surveillance et une mise à jour en un clic, qu'un VPS nu ne vous offre pas gratuitement.
  • Sur un VPS nu, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, effectuez et testez les sauvegardes, et renouvelez les certificats ; Cloud SQL géré, Secret Manager et la surveillance de RAD gèrent les trois pour vous.

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

C'est l'option principale sur un projet géré par RAD, et elle est gratuite pendant la pause. La suppression d'un projet géré par RAD commence par dissocier sa facturation, puis demande à Google de supprimer le projet lui-même — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne détruit pas la base de données, une VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et comme la facturation est déjà dissociée, rien n'est facturé pendant qu'il attend.

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, sera utilisable 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.

La restauration — dans les 30 jours, et uniquement par le propriétaire du projet — demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à 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 qu'il faut : vous devez être propriétaire du projet (pas seulement faire gérer sa facturation par RAD), vous devez le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc 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 opérationnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logique de Cloud Storage explicitement désactivée, de sorte que le bucket de sauvegarde est très probablement supprimé 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é ce déploiement 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.

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

L'autre levier, pour un projet propre (ou un projet géré par RAD au-delà de sa fenêtre de restauration de 30 jours), est de supprimer Qdrant purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 40 crédits au total pour ce module.

La suppression ne permet d'économiser de l'argent que si Qdrant reste inutilisé suffisamment longtemps pour que le coût de redéploiement soit inférieur à son propre coût de fonctionnement — pour ce module, cela représente environ 7 jours ou plus d'inactivité, basé sur son coût de fonctionnement de 19,14 $ US/mois ci-dessus. La majeure partie de ce coût de fonctionnement est généralement la base de données et toute VM de fichier/cache partagée, et elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application seule n'économise que sa propre part de calcul si quelque chose d'autre partage le projet.

Conservez les données en premier : les sauvegardes nocturnes vont 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 voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de 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, afin que personne ne reçoive 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; Resource Manager : supprimer et restaurer des projets pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Qdrant s'exécute en tant que service Cloud Run v2 (Gen2) avec un bucket Cloud Storage monté via GCS FUSE pour le stockage persistant des collections. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Qdrant, 1 vCPU / 1 GiB par défaut, min_instance_count = 1
Stockage persistantCloud Storage via GCS FUSEBucket <prefix>-storage monté à /qdrant/storage via Gen2 GCS FUSE CSI
SecretsSecret ManagerClé API optionnelle (QDRANT__SERVICE__API_KEY)
IngressURL Cloud Run / Cloud Load BalancingPar défaut internal (VPC uniquement) ; équilibreur de charge HTTPS optionnel avec Cloud Armor

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

  • Pas de base de données SQL, pas de Redis. Qdrant gère son propre stockage embarqué. Aucune instance Cloud SQL ou dépendance Redis n'est créée.
  • Instance unique par défaut. max_instance_count = 1 est fortement recommandé. Qdrant est un stockage à écrivain unique — plusieurs instances écrivant sur le même montage GCS FUSE corrompent les collections.
  • Ingress interne par défaut. ingress_settings = "internal" restreint l'accès au VPC. Le passage à "all" (internet public) nécessite enable_api_key = true — une validation au moment de la planification bloque la combinaison d'un ingress public sans clé API.
  • L'environnement d'exécution Gen2 est requis pour les montages GCS FUSE. Le module utilise par défaut execution_environment = "gen2".
  • Deux points de terminaison de santé distincts. Le démarrage utilise /readyz ; la vivacité utilise /livez. Ne pointez jamais la sonde de vivacité vers /readyz — Qdrant se marque temporairement comme non prêt lors du chargement de grandes collections, provoquant des redémarrages de conteneurs intempestifs.
  • gRPC nécessite le protocole h2c. Cloud Run n'expose pas le port 6334. Utilisez container_protocol = "h2c" et un client gRPC sur le port principal si gRPC est nécessaire.
  • Redis est déclaré mais inactif. enable_redis est par défaut true au niveau de la variable (la valeur par défaut de la fondation App_CloudRun), mais Qdrant_CloudRun's main.tf code en dur enable_redis = false sur l'appel à App_CloudRun quelle que soit la valeur de la variable — redis_host, redis_port et redis_auth n'ont aucun effet. Qdrant n'a pas de dépendance de mise en cache.
  • Le build du conteneur est fixé par Qdrant_Common. container_image, container_image_source, container_build_config et container_resources sont déclarés uniquement pour la mise en miroir des conventions de la Fondation — Qdrant_Common définit l'image réelle (qdrant/qdrant), la source du build (custom, via un Dockerfile wrapper léger) et la forme des ressources en interne et ignore ces quatre variables.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms des services et des ressources sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Qdrant​

Qdrant s'exécute en tant que service Cloud Run v2. Chaque déploiement crée une révision immuable. Le service s'adapte entre le nombre minimal et maximal d'instances en fonction de la concurrence des requêtes.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud Storage — Stockage persistant de Qdrant​

Qdrant persiste son WAL, ses données de collection, ses fichiers d'index HNSW et ses métadonnées à /qdrant/storage à l'intérieur du conteneur. Ce chemin est sauvegardé par un bucket Cloud Storage (<prefix>-storage) monté via GCS FUSE. Le bucket est provisionné automatiquement par le module.

  • Console : Cloud Storage → Buckets — trouvez le bucket *-storage.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<storage-bucket>/
    gcloud storage ls gs://<storage-bucket>/collections/

Voir App_CloudRun pour les détails de GCS Fuse et les options CMEK.

C. Secret Manager — Clé API Qdrant​

Lorsque enable_api_key = true, une clé API alphanumérique de 32 caractères est générée et stockée dans Secret Manager. Elle est injectée sous le nom QDRANT__SERVICE__API_KEY au moment de l'exécution, exigeant que tous les appelants REST et gRPC passent api-key: <key> dans les en-têtes de requête.

  • Console : Sécurité → Secret Manager — recherchez un secret nommé <resource-prefix>-api-key.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<api-key-secret> --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

D. Réseau et ingress​

Par défaut, le service n'est accessible que depuis le VPC (ingress_settings = "internal"). Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN, et Cloud Armor peuvent être ajoutés lorsque le service doit être accessible depuis l'extérieur du VPC.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

E. Cloud Logging et Monitoring​

Les logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring. Des tests de disponibilité optionnels (contre /readyz) et des politiques d'alerte sont disponibles.

  • Console : Logging → Explorateur de logs ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" \
    --region "$REGION" --limit 50

3. Comportement de l'application Qdrant​

  • Pas de bootstrap de base de données. Qdrant gère son propre moteur de stockage embarqué. Aucun job d'initialisation n'est injecté par défaut. Le service démarre immédiatement après que le conteneur est prêt.
  • Chargement de la collection au démarrage. Qdrant charge toutes les collections de GCS FUSE en mémoire pendant le démarrage. Pour les instances avec de grandes collections, le démarrage peut prendre des dizaines de secondes. La sonde de démarrage (/readyz) attend que cela soit terminé avant que le trafic ne soit envoyé à l'instance.
  • Points de terminaison de vivacité et de disponibilité séparés. /readyz renvoie 503 pendant le chargement des collections ; /livez renvoie toujours 200 tant que le processus est actif. La sonde de vivacité utilise /livez pour éviter les redémarrages intempestifs du conteneur pendant le chargement de la collection. Ne modifiez pas la sonde de vivacité en /readyz.
  • Contrainte d'écrivain unique. Plusieurs instances Cloud Run ne peuvent pas partager en toute sécurité le même chemin de stockage GCS FUSE. Gardez max_instance_count = 1. Mettez à l'échelle verticalement (augmentez le CPU et la mémoire) pour un débit plus élevé.
  • gRPC sur HTTP/2. Cloud Run n'expose pas de deuxième port pour gRPC. Utilisez container_protocol = "h2c" avec un client gRPC qui se connecte sur HTTP/2 sur le port 6333 si gRPC est nécessaire.
  • Tâches planifiées. Utilisez cron_jobs pour planifier des instantanés périodiques de collections Qdrant via l'API REST ou pour des routines de maintenance personnalisées, exécutées en tant que jobs Cloud Run.

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 Qdrant sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Emails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameqdrantNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameQdrant Vector DatabaseNom convivial affiché dans la Console.
description(défini)Description du service Cloud Run affichée dans l'interface utilisateur de la plateforme.
application_description(défini)Champ de description alternatif mis en miroir par la Fondation ; remplit la même description de service Cloud Run.
application_versionlatestTag de version de l'image Qdrant ; épingler à un tag semver pour la production (par exemple v1.9.0).
enable_api_keyfalseGénérer une clé API aléatoire dans Secret Manager ; requis avant de définir ingress_settings = "all".

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance. Augmenter à 2000m–4000m pour les builds d'index de production et les requêtes concurrentes.
memory_limit1GiMémoire par instance. Qdrant charge les index HNSW en RAM — taille basée sur les dimensions de la collection et le nombre de vecteurs.
min_instance_count1Instances minimales. Garder ≥ 1 pour éviter les démarrages à froid pendant le chargement de l'index HNSW.
max_instance_count1Instances maximales. Garder à 1 — Qdrant est un stockage à écrivain unique.
container_port6333Port de l'API REST Qdrant.
execution_environmentgen2Gen2 requis pour les montages GCS FUSE.
timeout_seconds300Durée maximale de la requête (0–3600 s). Augmenter pour les insertions par lots importantes ou les opérations d'instantané.
enable_image_mirroringtrueMettre en miroir l'image Qdrant dans Artifact Registry pour éviter les limites de débit de Docker Hub.
container_protocolhttp1Utiliser h2c pour activer HTTP/2 pour les clients gRPC se connectant sur le port 6333.
traffic_split[]Allocation de trafic entre les révisions pour les déploiements canary ou bleu-vert.
max_revisions_to_retain7Nombre maximal de révisions Cloud Run à conserver. Non référencé — aucun effet sur le déploiement dans ce module d'application.
enable_cloudsql_volumefalseInjecte un sidecar Cloud SQL Auth Proxy. Non applicable — Qdrant n'a pas de base de données SQL ; laisser false.
cloudsql_volume_mount_path/cloudsqlNon applicable — Qdrant n'a pas de base de données Cloud SQL.
service_annotations / service_labels{}Annotations / libellés de service Cloud Run personnalisés.
container_image_source / container_image / container_build_config / container_resourcescustom / "" / (défini) / (défini)Déclaré uniquement pour la mise en miroir des conventions de la Fondation. Qdrant_Common fixe l'image réelle, la source de build et la forme des ressources ; ces quatre n'ont aucun effet.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsinternalinternal (VPC uniquement, recommandé), all (nécessite enable_api_key = true), ou internal-and-cloud-load-balancing.
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Utilisez les clés QDRANT__… pour remplacer la configuration de Qdrant.
secret_environment_variables{}Mappage de var d'env → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sPériode de rappel de rotation de Secret Manager (30 jours par défaut).
prereq_subnet_cidr_override""Remplacement du CIDR du sous-réseau primaire VPC intégré. Définir uniquement lors de la réapplication d'un déploiement existant pour éviter le remplacement des ressources.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.
backup_filebackup.sqlNom de fichier de la sauvegarde à importer ; utilisé uniquement lorsque enable_backup_import = true. Listé dans la plateforme sous le Groupe 13 (Jobs).
additional_services[]Services Cloud Run supplémentaires déployés à côté de Qdrant (par exemple, un worker sidecar ou un proxy). Non utilisé par défaut.
additional_containers[]Conteneurs sidecar in-pod partageant le même service Cloud Run et localhost. Non utilisé par défaut — Qdrant n'a pas de processus compagnon.

Groupe 8 — CI/CD et autorisation binaire​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, github_app_installation_id, cicd_trigger_config, enable_cloud_deploy, cloud_deploy_stages, enable_binary_authorization, binauthz_evaluation_mode (non référencé — le définir n'a aucun effet sur ce module d'application).

Groupe 9 — NFS et SQL personnalisé​

VariableValeur par défautDescription
enable_nfsfalseQdrant utilise GCS pour le stockage — activer NFS uniquement pour les jobs d'initialisation personnalisés qui nécessitent un système de fichiers partagé. Nécessite Gen2.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
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 une VM NFS GCE intégrée.
nfs_volume_namenfs-data-volumeNom du volume Cloud Run pour le montage NFS. Remplacer pour un deuxième partage NFS.
enable_custom_sql_scriptsfalseNon applicable — Qdrant n'a pas de base de données SQL.
custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root"" / "" / falseNon applicable — accepté uniquement pour la compatibilité avec la Fondation.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner Global HTTPS LB + Cloud Armor WAF.
admin_ip_ranges[]CIDR exemptés des règles WAF.
application_domains[]Noms de domaine personnalisés pour le LB HTTPS (SSL géré par Google).
enable_cdnfalseActiver Cloud CDN sur le backend du LB HTTPS.
max_images_to_retain7Nombre maximal d'images de conteneurs récentes à conserver dans Artifact Registry.
delete_untagged_imagestrueSupprimer automatiquement les images non taguées d'Artifact Registry.
image_retention_days30Jours après lesquels les images sont éligibles à la suppression. Définir à 0 pour désactiver.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner le bucket de stockage GCS.
storage_buckets / gcs_volumes[]Buckets supplémentaires / montages GCS FUSE.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
enable_redistrue (valeur par défaut de la variable)Inerte. main.tf code en dur enable_redis = false sur l'appel App_CloudRun quelle que soit cette valeur — Qdrant n'a pas de dépendance de mise en cache.
redis_host / redis_port / redis_auth"" / 6379 / ""Inerte — jamais transféré, puisque Redis est désactivé en dur.

Groupe 12 — Backend de base de données​

Non applicable — Qdrant n'a pas de base de données SQL. database_type est transféré à App_CloudRun mais sa valeur par défaut (NONE) est la seule valeur prise en charge ; la modifier ne donnerait pas à Qdrant une connexion de base de données fonctionnelle car Qdrant_Common ne connecte jamais les identifiants de la base de données au conteneur. Les éléments suivants sont acceptés uniquement pour la compatibilité avec la Fondation et n'ont aucun effet : sql_instance_name, sql_instance_base_name, database_password_length, application_database_name, application_database_user, db_password_env_var_name, enable_postgres_extensions, postgres_extensions, enable_mysql_plugins, mysql_plugins, enable_auto_password_rotation, rotation_propagation_delay_sec, db_host_env_var_name, db_user_env_var_name, db_name_env_var_name, db_port_env_var_name, service_url_env_var_name.

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

VariableValeur par défautDescription
initialization_jobs[]Qdrant ne nécessite pas de job d'initialisation par défaut ; fournir uniquement des tâches de chargement de données ou de migration personnalisées.
cron_jobs[]Jobs Cloud Run récurrents pour les instantanés de collection périodiques ou la maintenance.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe/readyz, délai de 15sSonde HTTP — Qdrant signale qu'il est prêt une fois toutes les collections chargées.
liveness_probe/livez, délai de 30sSonde HTTP — point de terminaison de vivacité dédié non affecté par l'état de chargement de la collection.
startup_probe_configenabled=true, path=/readyzInterface de sonde de démarrage alternative au niveau de la Fondation.
health_check_configenabled=true, path=/livezInterface de sonde de vivacité alternative au niveau de la Fondation.
uptime_check_configdésactivé, /readyzTest de disponibilité Cloud Monitoring.
alert_policies[]Politiques d'alerte métriques.

Groupe 15 — Réseau avancé​

VariableValeur par défautDescription
network_name""Nom du réseau VPC à utiliser. Laisser vide pour découvrir automatiquement un seul réseau géré par Services_GCP ; requis uniquement lorsqu'il en existe plus d'un dans le projet.

Groupe 23 — VPC Service Controls 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.

Groupe 0 — Métadonnées du module (avancé/interne)​

Au-delà des métadonnées orientées plateforme (module_description, module_documentation, module_dependency, module_services, credit_cost, require_credit_purchases, enable_purge, public_access, shared_users, technical_support_users, resource_creator_identity, impersonation_service_account, require_services_gcp_module), trois variables contrôlent le provisionnement interne de la plateforme et ne sont normalement pas définies manuellement : requires_services (indique à la plateforme quelles ressources Services_GCP provisionner automatiquement pour ce module — par défaut, le chemin de la VM Compute NFS/Redis gratuite, et non Memorystore/Filestore géré), job_execution_wait_timeout (900s — combien de temps le déploiement attend un job d'initialisation avant d'avorter), et module_writable_secret_ids ({} — autorisations d'écriture Secret Manager pour les hooks post-installation ; inutilisé par Qdrant).


5. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
qdrant_urlURL VPC interne pour l'API REST Qdrant (port 6333). Accessible uniquement depuis le même VPC lorsque ingress_settings = "internal".
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration personnalisé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_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat 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 si incorrect
enable_api_keytrue (tout déploiement externe)CritiqueSans clé API, tout appelant pouvant atteindre le service peut lire, modifier ou supprimer toutes les collections.
ingress_settingsinternal (par défaut)CritiqueDéfinir sur "all" sans enable_api_key = true est bloqué au moment de la planification ; cela expose Qdrant à l'internet public.
application_namedéfini une foisCritiqueImmuable après le premier déploiement ; la modification recrée le stockage et perd toutes les collections.
max_instance_count1ÉlevéPlusieurs instances écrivant sur le même chemin GCS FUSE corrompent les collections — Qdrant est un stockage à écrivain unique.
Chemin liveness_probe/livez (par défaut)ÉlevéPointer la vivacité vers /readyz provoque des redémarrages intempestifs du conteneur chaque fois qu'une grande collection est chargée depuis GCS.
memory_limit≥ 4Gi pour la productionÉlevéLa valeur par défaut 1Gi ne prend en charge que les petites collections de test ; les arrêts OOM terminent toutes les requêtes en cours et déclenchent un rechargement complet de l'index depuis GCS.
execution_environmentgen2 (par défaut)ÉlevéGCS FUSE nécessite Gen2 ; les déploiements Gen1 avec enable_nfs = true échouent au moment de la planification.
application_versionépingler à semver pour la productionMoyenL'utilisation de latest peut entraîner une mise à niveau involontaire du format de stockage qui rend les collections existantes illisibles.
min_instance_count1MoyenLa mise à l'échelle à zéro provoque un rechargement à froid de toutes les collections depuis GCS lors de la prochaine requête ; à éviter pour les charges de travail sensibles à la latence.
timeout_seconds300MoyenLes grandes recherches ANN, les insertions par lots ou les opérations d'instantané peuvent dépasser la valeur par défaut — augmenter à 600 ou plus pour les charges de travail lourdes.
enable_iap / enable_cloud_armoractiver pour les déploiements exposésÉlevéSans contrôles d'accès, l'API REST Qdrant est accessible par tout appelant sur le réseau autorisé.
secret_propagation_delay30MoyenDans les grands projets, la réplication de Secret Manager peut dépasser 30 s ; augmenter à 60 pour éviter de lire un secret de clé API vide.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide échoue le job d'importation.
enable_redis / redis_host / redis_port / redis_authlaisser aux valeurs par défautFaibleInerte — main.tf désactive Redis en dur quelle que soit la valeur de ces variables. Les définir n'a aucun effet et n'indique pas une mauvaise configuration.
database_type / sql_instance_name et les autres variables de base de données du Groupe 12laisser aux valeurs par défautFaibleInerte pour Qdrant — Qdrant_Common ne connecte jamais les identifiants de la base de données au conteneur, donc modifier ces variables ne crée pas de connexion de base de données utilisable.
container_image / container_image_source / container_build_config / container_resourceslaisser aux valeurs par défautFaibleInerte — Qdrant_Common fixe l'image réelle, la source de build et la forme des ressources.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Qdrant partagée avec la variante GKE est décrite dans Qdrant_Common.

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