Aller au contenu principal

RAGFlow sur Google Cloud Run

RAGFlow sur Google Cloud Run

RAGFlow est une plateforme open source d'intelligence documentaire et de génération augmentée par récupération (RAG). Elle ingère des documents PDF, Word, des pages HTML et d'autres formats, les découpe et les intègre, stocke les vecteurs dans Elasticsearch, expose une API REST pour la réponse aux questions et fournit une interface utilisateur web pour la gestion des bases de connaissances et la recherche d'entreprise. Ce module déploie RAGFlow 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 RAGFlow 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 à 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.

Prérequis de déploiement : RAGFlow_CloudRun nécessite que Elasticsearch_GKE soit déployé en premier. La variable elasticsearch_hosts doit être définie lors de deploy_application = true — le plan est rejeté si elle est vide.


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

L'exécution de RAGFlow dans votre propre projet Google Cloud coûte environ 101,98 $ US/mois en infrastructure, plus des frais de module uniques de 110 crédits RAD (dimensionnés à 2 vCPU / 4 GiB sur une instance Cloud Run à mise à l'échelle à zéro). 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 67 crédits/jour — et les frais de module sont 10 % inférieurs, à 99 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement RAGFlow géré par RAD peut être arrêté, sans frais d'exécution, jusqu'à ce que vous en ayez à nouveau besoin. (ou consultez 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 module110 crédits (une fois)99 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 pour le temps de build à la minuteIdentique
Coût d'exécution Google Cloud~101,98 $ US/mois, facturé à votre propre compte de facturation au prix catalogue de Google~67 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 d'exécution par défaut dans votre propre projet

Ressource$ US/mois (prix catalogue Google, us-central1)
Cloud Run, 2x vCPU / 4 GiB (scaleToZero)31,53
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02
Serveur de fichiers NFS/cache (petite VM)13,43
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Total101,98 $

Comment cela se compare​

  • Nous n'avons pas pu vérifier un prix SaaS commercial actuel directement comparable pour ce projet open source exact, la comparaison honnête est donc un serveur autonome nu : Hetzner CPX22 (2 vCPU/4 Go, ~24 $/mois), un DigitalOcean 2 vCPU/4 Go Droplet (~24 $/mois), ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, ~49 $/mois).
  • 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 détenus par Secret Manager, la surveillance et la mise à jour en un clic, dont aucun n'est fourni gratuitement par un VPS nu.
  • 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é par RAD, Secret Manager et la surveillance gèrent les trois pour vous.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque 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 délie d'abord 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à délié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, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être invoquée comme 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 cela, 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 que la plupart des utilisations d'étude et de démonstration conviennent). Google indique que la plupart des services fonctionnent à nouveau pleinement 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 RAGFlow purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits au total pour ce module.

La suppression ne permet d'économiser de l'argent que si RAGFlow reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour ce module, cela représente environ 4 jours ou plus d'inactivité, basé sur son propre coût d'exécution de 101,98 $ US/mois ci-dessus. La plupart de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée, et ils ne s'arrêtent que si 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 d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de 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 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 retournent au formateur.
  • Environnements gérés, pour les cabinets 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 facture inattendue. À 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 frais propres 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​

RAGFlow s'exécute en tant que service Python/Nginx conteneurisé sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service RAGFlow personnalisé, 2 vCPU / 4 GiB par défaut, démarrage à froid (min_instance_count = 0) par défaut
Base de donnéesCloud SQL pour MySQL 8.0Requis — RAGFlow ne prend pas en charge PostgreSQL
Recherche vectorielleElasticsearch (Elasticsearch_GKE)Dépendance externe — doit être déployé en premier ; elasticsearch_hosts est obligatoire
File d'attente de tâchesRedis (Memorystore)Requis pour les workers de traitement de documents
Stockage d'objetsPoint de terminaison externe compatible S3RAGFlow stocke chaque document téléchargé dans un stockage compatible S3. Sur Cloud Run, il n'y a pas de valeur par défaut fonctionnelle : fournissez un point de terminaison avec minio_host / minio_user / minio_password_secret. Un bucket Cloud Storage documents est également provisionné, mais RAGFlow ne l'utilise pas
SecretsSecret ManagerMot de passe de base de données généré automatiquement
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS Cloud Armor + domaine personnalisé en option

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

  • MySQL 8.0 est obligatoire. La sélection de PostgreSQL ou NONE interrompt le démarrage.
  • elasticsearch_hosts est requis. RAGFlow ne peut pas indexer ou rechercher des documents sans un point de terminaison Elasticsearch accessible. Cette vérification est ignorée uniquement lorsque deploy_application = false.
  • L'ingestion de documents nécessite un point de terminaison compatible S3 que vous fournissez. RAGFlow conserve les documents téléchargés dans un stockage d'objets compatible S3, un bucket par base de connaissances. Définissez minio_host, minio_user et minio_password_secret (un nom de secret Secret Manager). enable_inline_minio (un sidecar MinIO sur Filestore) est implémenté mais par défaut à false : Cloud Run rejette l'image MinIO quay.io à moins qu'elle ne soit d'abord mise en miroir dans Artifact Registry, et deux révisions qui se chevauchent partageant un répertoire de données MinIO est un risque non prouvé. Pour une valeur par défaut fonctionnelle, utilisez RAGFlow_GKE.
  • Redis est requis pour le traitement des documents. Avec enable_redis = true (par défaut), REDIS_HOST et REDIS_PORT sont injectés automatiquement. Si redis_host est laissé vide, App_CloudRun revient à l'adresse IP du serveur NFS (la VM NFS co-héberge Redis) — même comportement que la variante GKE. Sans un Redis accessible, les fichiers téléchargés restent non traités indéfiniment.
  • Démarrage à froid par défaut. min_instance_count = 0 et cpu_always_allocated = false (facturation basée sur les requêtes) — le service se met à l'échelle à zéro lorsqu'il est inactif et ne facture le CPU que pendant le traitement d'une requête. Compromis : l'exécuteur de tâches de documents en arrière-plan s'arrête lorsqu'il est inactif, de sorte que l'ingestion/l'analyse des documents nouvellement téléchargés ne s'exécute pas en arrière-plan ; la requête/le chat fonctionne toujours sur demande. Définissez cpu_always_allocated = true et min_instance_count >= 1 pour restaurer l'ingestion continue en arrière-plan (et éviter le démarrage à froid de 2 à 3 minutes pendant le chargement des modèles d'intégration).
  • L'environnement d'exécution Gen2 est requis pour NFS. execution_environment = "gen2" est la valeur par défaut ; le passage à gen1 avec enable_nfs = true échoue au moment du plan.
  • Une image personnalisée est toujours construite. Cloud Build étend infiniflow/ragflow en utilisant le Dockerfile dans RAGFlow_Common/scripts/, avec APP_VERSION défini à partir de application_version.
  • service_conf.yaml est généré au démarrage. Le point d'entrée personnalisé écrit /ragflow/conf/service_conf.yaml à partir des variables d'environnement injectées avant de démarrer les processus RAGFlow. Un pont socat adapte le socket Unix du proxy d'authentification Cloud SQL au port TCP attendu par le client MySQL de RAGFlow.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service RAGFlow​

RAGFlow s'exécute en tant que service Cloud Run v2. Par défaut, il se met à l'échelle à zéro lorsqu'il est inactif (min_instance_count = 0, cpu_always_allocated = false) ; définissez les deux pour maintenir une instance active et éviter les retards de démarrage à froid pendant le chargement du modèle d'intégration. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux 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 SQL pour MySQL 8.0​

RAGFlow stocke toutes les métadonnées de l'application (comptes utilisateurs, bases de connaissances, état des tâches) dans une instance Cloud SQL pour MySQL 8.0 gérée. Le service se connecte en privé via le sidecar Cloud SQL Auth Proxy via un socket Unix. Un pont socat à l'intérieur du conteneur mappe ce socket à 127.0.0.1:3306 pour le client MySQL TCP de RAGFlow. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

RAGFlow nécessite une instance Elasticsearch externe pour l'indexation de documents et la recherche vectorielle. Déployez Elasticsearch_GKE séparément et passez sa sortie elasticsearch_endpoint comme elasticsearch_hosts. Les variables d'environnement ELASTICSEARCH_HOSTS et ELASTICSEARCH_USERNAME sont injectées automatiquement. Elasticsearch intégré n'est pas pris en charge sur Cloud Run.

  • Console : Kubernetes Engine → Workloads → Elasticsearch namespace.
  • CLI :
    # Confirm RAGFlow can reach Elasticsearch (from Cloud Shell or a VPC-connected host):
    curl -s "$ELASTICSEARCH_HOSTS/_cluster/health" | grep status

D. Redis — file d'attente de tâches​

Redis est l'épine dorsale du pipeline de traitement de documents de RAGFlow. Les workers interrogent Redis pour les tâches ; sans lui, les fichiers téléchargés ne sont jamais analysés, découpés ou intégrés. L'instance Memorystore Redis est accessible via le VPC via le paramètre d'égression VPC PRIVATE_RANGES_ONLY (par défaut).

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace

E. Cloud Storage​

Un bucket Cloud Storage dédié (ragflow-documents) est provisionné pour l'ingestion et le stockage de documents. Des buckets supplémentaires et des montages de volume GCS Fuse peuvent être ajoutés via storage_buckets et gcs_volumes. Le compte de service de la charge de travail est automatiquement autorisé.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<documents-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour les options GCS Fuse et CMEK.

F. Secret Manager​

Le mot de passe de la base de données est stocké dans Secret Manager et injecté dans le service au moment de l'exécution ; le texte en clair n'apparaît jamais dans la configuration.

  • Console : Security → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

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

G. Réseau et ingress​

Le service est accessible à son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec Cloud Armor WAF, un domaine personnalisé et Cloud CDN peuvent être superposés. L'égression VPC est définie sur PRIVATE_RANGES_ONLY par défaut afin que le trafic Redis et MySQL transite par le VPC privé tandis que l'égression publique reste illimitée.

  • Console : Cloud Run (URL du service) ; Network services → Load balancing.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

H. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte facultatifs.

  • Console : Logging → Logs Explorer ; Monitoring → Dashboards / Alerting.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application RAGFlow​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation Cloud Run (mysql:8.0-debian) crée la base de données RAGFlow (rag_flow) et l'utilisateur (ragflow) avant le démarrage du service. Il est idempotent et peut être réexécuté en toute sécurité.

  • service_conf.yaml généré au démarrage. Le point d'entrée personnalisé génère /ragflow/conf/service_conf.yaml à partir des variables d'environnement injectées — y compris l'hôte/utilisateur/base de données MySQL, le point de terminaison Elasticsearch, l'hôte/port Redis et les identifiants facultatifs — avant de démarrer les processus RAGFlow. Un pont socat adapte le socket Unix du proxy d'authentification Cloud SQL à 127.0.0.1:3306 pour le client MySQL de RAGFlow.

  • Pipeline de traitement de documents. Les documents téléchargés sont mis en file d'attente dans Redis et traités de manière asynchrone par les workers de documents de RAGFlow : OCR, découpage, intégration et indexation dans Elasticsearch. Sans un Redis et un Elasticsearch accessibles, les fichiers apparaissent téléchargés mais ne sont jamais traités.

  • Chargement du modèle d'intégration au démarrage. RAGFlow télécharge et charge les modèles d'intégration lors du premier démarrage. La sonde de démarrage cible /v1/system/version avec un délai initial de 120 secondes et 30 tentatives de récupération en cas d'échec. Définissez min_instance_count >= 1 avec cpu_always_allocated = true pour éviter les démarrages à froid et maintenir le traitement des documents en arrière-plan en continu.

  • Points de terminaison de santé. Les sondes de démarrage et de vivacité utilisent /v1/system/version. Le test de disponibilité (s'il est activé) cible /v1/health. Ceux-ci renvoient HTTP 200 uniquement lorsque l'application est entièrement initialisée.

    Inspecter les exécutions de job :

    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

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 RAGFlow 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.
elasticsearch_hosts(requis)Point de terminaison HTTP Elasticsearch (par exemple http://10.0.0.5:9200). Défini sur la sortie elasticsearch_endpoint de Elasticsearch_GKE.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameragflowNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameRAGFlowNom convivial affiché dans la console.
description(défini)Description du service.
application_versionv0.13.0Tag de version de l'image RAGFlow passé comme APP_VERSION à Cloud Build ; incrémenter pour déployer une nouvelle version.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
cpu_limit2000mCPU par instance ; 4 vCPU ou plus recommandés pour le traitement de documents en production.
memory_limit4GiMémoire par instance ; 8–16 GiB recommandés pour la production.
cpu_always_allocatedfalseValeur par défaut de démarrage à froid axée sur les coûts. true restaure le traitement continu des documents en arrière-plan entre les requêtes.
min_instance_count0Se met à l'échelle à zéro lorsqu'il est inactif. Définissez ≥ 1 (avec cpu_always_allocated = true) pour maintenir l'exécuteur de tâches en arrière-plan et les modèles d'intégration actifs.
max_instance_count1Nombre maximal d'instances ; augmentez avec prudence (nécessite NFS pour le stockage partagé).
container_port80Le frontend Nginx de RAGFlow écoute sur le port 80.
execution_environmentgen2Doit rester gen2 — requis pour les montages NFS.
timeout_seconds600Augmentez pour les requêtes de traitement de documents volumineux (max 3600).
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions socket.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.

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

VariableValeur par défautDescription
ingress_settingsallQuels réseaux peuvent atteindre le service (all, internal, internal-and-cloud-load-balancing).
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer le trafic privé RFC-1918 (Redis, MySQL) via le 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. Ne pas remplacer MYSQL_*, ELASTICSEARCH_* ou REDIS_* — ceux-ci sont injectés automatiquement.
secret_environment_variables{}Mappage variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay / secret_rotation_period(défini)Attente de réplication / cadence de rotation.

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.

Groupe 8 — CI/CD et Binary Authorization​

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

Groupe 9 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécuter du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Cloud Armor, CDN et domaine personnalisé​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor WAF via un équilibreur de charge HTTPS global.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner des buckets GCS supplémentaires. Le bucket ragflow-documents est toujours créé.
storage_buckets[{ name_suffix="data" }]Configurations de buckets GCS supplémentaires.
enable_nfstrueVolume Filestore partagé. Requis pour les déploiements multi-instances et lorsque redis_host est vide (adresse IP du serveur NFS utilisée comme hôte Redis de secours).
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
gcs_volumes[]Volumes GCS Fuse montés dans le conteneur RAGFlow.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Fixe — ne pas modifier.
db_namerag_flowNom de la base de données. Immuable après le premier déploiement.
db_userragflowUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.
db_host_env_var_name / db_name_env_var_name / db_user_env_var_name / db_port_env_var_name / service_url_env_var_name""Noms de variables d'environnement supplémentaires sous lesquels les détails de connexion sont injectés.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job Cloud Run db-init intégré.
cron_jobs[]Jobs Cloud Run planifiés récurrents.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /v1/system/version, délai de 120 s, 30 tentativesPermet un temps suffisant pour le chargement du modèle d'intégration au premier démarrage.
liveness_probeHTTP /v1/system/version, délai de 120 sSonde de vivacité une fois le démarrage réussi.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring.
alert_policies[]Politiques d'alerte métrique.

Groupe 15 — Elasticsearch et Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis pour la file d'attente de tâches de traitement de documents. Transmis inconditionnellement à App_CloudRun — Redis est câblé que redis_host soit défini ou laissé vide.
redis_host""Point de terminaison Redis. Lorsqu'il est laissé vide, App_CloudRun injecte REDIS_HOST = <NFS server IP> comme solution de repli (comportement identique à la variante GKE, puisque la VM NFS co-héberge Redis). Définir explicitement pour pointer vers une autre instance Redis (par exemple Memorystore).
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).
elasticsearch_username""Nom d'utilisateur Elasticsearch. Laisser vide lorsque xpack.security.enabled = false.

Groupe 22 — 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.

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.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesDétails du 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é).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
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.
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
elasticsearch_hostsrequis — défini à partir de Elasticsearch_GKECritiqueRAGFlow ne peut pas indexer ou rechercher ; toutes les opérations d'ingestion et de récupération échouent. Le plan est rejeté lorsqu'il est vide et deploy_application = true.
enable_redistrueCritiqueSans Redis, la file d'attente de traitement de documents ne s'exécute jamais ; les fichiers téléchargés restent non traités indéfiniment.
database_typeMYSQL_8_0CritiqueRAGFlow nécessite MySQL ; PostgreSQL/NONE interrompt le démarrage.
enable_cloudsql_volumetrueCritiqueRAGFlow se connecte via un socket Unix ponté vers TCP par socat ; la désactivation du sidecar proxy entraîne un échec de connexion à la base de données au démarrage.
db_name / db_userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit les données.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans un backup_uri valide échoue le job d'importation.
redis_hostlaisser vide pour utiliser le Redis de secours du serveur NFS, ou définir une IP Memorystore expliciteÉlevéLorsque redis_host = "" et enable_redis = true, App_CloudRun injecte REDIS_HOST = <NFS server IP> (nécessite enable_nfs = true, la valeur par défaut) — identique à la variante GKE. Si NFS est désactivé et redis_host est laissé vide, aucun hôte Redis n'est injecté et les workers de documents asynchrones ne s'exécutent silencieusement jamais.
min_instance_count / cpu_always_allocated1 / true pour une ingestion continueÉlevéLes valeurs par défaut sont 0 / false (démarrage à froid) : le traitement des documents en arrière-plan s'arrête lorsqu'il est inactif et les démarrages à froid prennent 2 à 3 minutes. Définissez les deux pour une ingestion toujours active.
memory_limit4Gi (≥ 8Gi pour la production)ÉlevéLes modèles d'intégration et le serveur d'applications nécessitent une RAM importante ; trop peu entraîne des arrêts OOM.
vpc_egress_settingPRIVATE_RANGES_ONLYÉlevéMemorystore Redis est sur une IP VPC privée ; un routage d'égression incorrect interrompt la file d'attente de tâches.
execution_environmentgen2ÉlevéLes montages NFS nécessitent gen2 ; le passage à gen1 avec enable_nfs = true échoue au moment du plan.
elasticsearch_username"" ou utilisateur correctÉlevéSi la sécurité Elasticsearch est activée, laisser ce champ vide entraîne une erreur HTTP 401 et interrompt toute indexation.
enable_nfstrueÉlevéLes déploiements multi-instances sans stockage partagé voient des vues de documents incohérentes entre les instances.
ingress_settings / enable_iaprestreindre pour la productionÉlevéL'ingress public sans IAP expose RAGFlow à des appelants non authentifiés.
max_instance_count1 (augmenter uniquement avec NFS)MoyenLa mise à l'échelle au-delà de 1 sans NFS entraîne un accès aux documents en split-brain entre les instances.
timeout_seconds600MoyenLes téléchargements de documents volumineux peuvent prendre plusieurs minutes ; un délai trop court entraîne des timeouts 504 avant la fin du traitement.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
application_versionv0.13.0MoyenL'incrémentation déclenche une reconstruction d'image et un déploiement de révision ; vérifier la compatibilité du schéma MySQL pour les sauts de version majeure.

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 à RAGFlow partagée avec la variante GKE est décrite dans RAGFlow_Common.

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