Aller au contenu principal

Chibisafe sur Google Cloud Run

Chibisafe sur Google Cloud Run

Chibisafe est un téléchargeur de fichiers et d'images auto-hébergé avec un tableau de bord moderne, des téléchargements par glisser-déposer, des albums et une API publique. Ce module déploie la pile Chibisafe complète — l'interface utilisateur web à /, l'API REST sous /api, la référence OpenAPI à /docs, et les fichiers téléchargés servis par nom — comme un seul service sur Cloud Run v2, au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée. L'amont livre Chibisafe sous forme de trois conteneurs (le backend chibisafe-server, un frontend Next.js et un proxy inverse Caddy) ; ce module les combine en une seule image personnalisée.

Statut : l'image full-stack n'a pas encore été construite ou déployée, donc le comportement ci-dessous est décrit à partir de la source du module et de la version v6.5.5 de l'amont, non vérifié en direct.

Ce guide se concentre sur les services cloud que Chibisafe utilise 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 du socle App_CloudRun plutôt que de les répéter ici.


Ce que coûte Chibisafe sur RAD, et comparaison​

Chibisafe sur le module Cloud Run de RAD coûte environ 33 $ US par mois dans votre propre projet Google Cloud, sans frais de licence supplémentaires — Chibisafe est open source. Dans un projet géré par RAD pour vous, le même déploiement est facturé à 23 crédits par jour (environ 690 par mois, soit environ 69 $ US au prix de la recharge). Ou consultez le guide GKE pour une capacité toujours active sur plusieurs pods. Si vous n'avez besoin de Chibisafe qu'occasionnellement — pour des études, une démo, un projet de courte durée — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ce chiffre mensuel devient quelques dollars à la place. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Chibisafe est open source, il n'y a donc pas de frais de licence. Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement40 crédits (4 $ US au prix de la recharge)36 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 33 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 23 crédits par jour, environ 690 par mois (environ 69 $ US au prix de la recharge)
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

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).

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

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

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 Gio (chaud)13,14 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 33 $ US

Les prix de Cloud SQL et des pods Cloud Run/GKE sont les mêmes en africa-south1 (Johannesburg) ; la petite VM coûte environ 10 % de plus là-bas.

  • Ce module est maintenu chaud par défaut (min_instance_count ≥ 1), donc le chiffre Cloud Run ci-dessus suppose déjà qu'il ne se met jamais à l'échelle à zéro.

Comparaison pour un hébergeur de fichiers personnel ou pour petite équipe​

Chibisafe n'a pas d'offre hébergée officielle — il est livré comme une pile auto-hébergée, donc la comparaison réaliste est un serveur nu :

  • Un Hetzner CPX22 ou un droplet DigitalOcean (2 vCPU/4 Go, environ 24 $/mois) ou un GCP e2-standard-2 (2 vCPU/8 Go, environ 49 $/mois) le ferait fonctionner confortablement — surdimensionné pour l'empreinte de 1 vCPU/1 Gio de Chibisafe ici, donc une classe d'instance plus petite et moins chère ferait tout aussi bien l'affaire.
  • Sur un VPS nu, vous possédez le système d'exploitation, les correctifs de sécurité et votre propre discipline de sauvegarde. Le module de RAD vous offre le calcul, Secret Manager et Cloud Monitoring déjà câblés, pour les frais de module plus l'utilisation de Google Cloud ci-dessus.

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

Si Chibisafe s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet — plutôt que la suppression de ce seul module — délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet. Google le conserve, récupérable, pendant 30 jours, et 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 Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement.

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 est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut demander à Google de récupérer le projet et de rattacher son compte de facturation, puis 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, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD ne gère que la facturation), le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et à nouveau atteindre le seuil d'admission du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage désactivée, il est donc très probable qu'il disparaisse dès que le projet est supprimé — même si le projet lui-même est récupérable pendant 30 jours. Copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de la supprimer s'il y a quelque chose à conserver ; pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Source : Supprimer et restaurer des projets.

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

Dans votre propre projet, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est 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) : 40 crédits (4,00 $ US) au prix de la recharge. La suppression ne permet d'économiser de l'argent que si Chibisafe reste inutilisé pendant environ 3 jours ou plus — dans votre propre projet, cela représente environ 1,09 $ US par jour, et dans un projet géré par RAD, c'est 23 crédits par jour.
  • La majeure partie du coût d'exécution ici est généralement la base de données et/ou la VM ou le cluster de fichiers/cache partagé. Ils ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de Chibisafe alors qu'une autre application partage le projet n'économise que la partie calcul de Chibisafe.
  • 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 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 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 RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et la mise en garde sur le bucket de sauvegarde ; les prix changent, vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Chibisafe s'exécute comme un conteneur unique, construit sur mesure, sur Cloud Run v2 — Caddy devant deux processus Node.js (backend et frontend) — sans base de données externe. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Image full-stack construite sur mesure (Caddy sur le port 8000 → backend + frontend Next.js sur loopback) ; 1 vCPU / 1 Gio par défaut ; min=max=1 (instance unique)
Base de donnéesAucuneChibisafe conserve sa base de données SQLite, ses téléchargements et ses logs sur le volume monté — aucune instance Cloud SQL n'est créée
Stockage persistantCloud Storage (GCS Fuse)Un bucket storage est toujours provisionné et monté à /data via GCS Fuse (nécessite gen2) ; pas un périphérique de bloc durable
SecretsSecret ManagerOptionnel ADMIN_PASSWORD (géré par enable_api_key, désactivé par défaut)
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut, publique par défaut (ingress_settings = "all")

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

  • SQLite est la seule "base de données". database_type est fixé à NONE par Chibisafe_Common ; les nombreuses variables database_*/db_*/sql_instance_* reflétées dans variables.tf existent uniquement pour la parité de convention de la Fondation et n'ont aucun effet.
  • La persistance est GCS Fuse, pas un périphérique de bloc — et le module le dit. Cloud Run n'a pas d'option PVC/stockage par blocs, donc le seul bucket storage est monté à /data via GCS Fuse. Le propre module_description de ce module avertit explicitement : "Envisagez Chibisafe_GKE avec un PVC de bloc pour un stockage SQLite durable en production." Les sémantiques de verrouillage de fichiers POSIX de GCS Fuse sont plus faibles qu'un vrai système de fichiers, ce qui est un risque réel pour une application SQLite à un seul rédacteur sous une charge d'écriture soutenue.
  • Instance unique, rédacteur unique. min_instance_count = max_instance_count = 1 par défaut — ne pas mettre à l'échelle au-delà de 1 sans repenser le stockage.
  • Image construite sur mesure avec une version spécifique à l'application. Le Dockerfile est basé sur chibisafe/chibisafe-server (backend à /app), copie le frontend Next.js chibisafe/chibisafe (/opt/chibisafe-web) et un binaire Caddy 2.11.4 statique, et lit son propre argument de build CHIBISAFE_VERSION (pas le générique APP_VERSION que la Fondation injecte ; une balise épingle le backend et le frontend) ; application_version = "latest" est épinglé à v6.5.5 au moment du build.
  • Pas de Redis, jamais. Le module reflète une variable enable_redis (par défaut true) pour la parité de convention de la Fondation, mais main.tf transmet toujours enable_redis = false à App_CloudRun quelle que soit sa valeur — Chibisafe n'a pas de dépendance Redis.
  • enable_cloudsql_volume est inerte. Sa valeur par défaut déclarée est déjà false, et main.tf code en dur enable_cloudsql_volume = false dans l'appel à App_CloudRun — la valeur de la variable est ignorée de toute façon.
  • Ingress public par défaut. ingress_settings = "all" — Chibisafe est une interface utilisateur publique de téléchargement/hébergement de fichiers consultée directement. (Ce module a été précédemment affecté par un bug à l'échelle de la flotte où le boilerplate "charge de travail de base de données" copié-collé définissait par défaut ingress_settings à "internal" ; la source actuelle confirme que la valeur par défaut ici est correctement "all".)
  • Mot de passe administrateur. Le compte propriétaire de la première exécution de Chibisafe est admin. Avec enable_api_key = true (valeur par défaut de ce module, et requise par un garde-fou au moment de la planification lorsque ingress_settings = "all"), son mot de passe est une valeur aléatoire ADMIN_PASSWORD de Secret Manager ; sinon, c'est la valeur par défaut bien connue de l'amont admin — changez-la immédiatement après la première connexion.
  • Le chemin de santé est /api/health. Les sondes startup_probe / liveness_probe de ce module ciblent /api/health via le proxy Caddy intégré au conteneur : un 200 {"status":"yes"} littéral, non authentifié, qui prouve que le proxy et le backend fonctionnent. / est l'interface utilisateur web, dont le code de statut est le choix du frontend plutôt qu'un signal de santé. Les variables séparées startup_probe_config / health_check_config (maintenant également par défaut à /api/health) sont supplantées pour ce module — voir §6.
  • Les téléchargements de plus de 32 Mio nécessitent une taille de bloc plus petite. Voir §3.
  • Tout l'état réside sous un seul montage. Le point d'entrée lie symboliquement les répertoires /app/database, /app/uploads et /app/logs de l'image dans des sous-répertoires du volume GCS Fuse unique (/data), migrant tout contenu amorcé par l'image au premier démarrage.

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

A. Cloud Run — le service Chibisafe​

Chibisafe s'exécute comme un seul service Cloud Run v2. Chaque déploiement crée une révision immuable ; avec min=max=1, il y a normalement exactement une instance de conteneur active.

  • 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 — le volume d'état persistant​

Chibisafe n'a pas de service de base de données à inspecter — son état entier (base de données SQLite, fichiers téléchargés et logs) réside sur le seul bucket Cloud Storage monté via GCS Fuse à /data (nécessite execution_environment = "gen2"). Chibisafe_Common provisionne toujours ce bucket storage ; des buckets supplémentaires peuvent être déclarés via storage_buckets, et des montages GCS Fuse supplémentaires via gcs_volumes.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~chibisafe"
    gcloud storage ls gs://<data-bucket>/database gs://<data-bucket>/uploads gs://<data-bucket>/logs

Voir App_CloudRun pour les mécanismes de montage GCS Fuse et les options CMEK.

C. Secret Manager​

Chibisafe ne génère aucun secret par défaut. Le seul secret optionnel est un mot de passe administrateur aléatoire, contrôlé par enable_api_key (par défaut true dans ce module) : lorsqu'il est activé, une valeur aléatoire de 24 caractères est stockée dans Secret Manager (suffixe de nom api-key) et injectée comme variable d'environnement ADMIN_PASSWORD via le chemin de référence standard de Cloud Run Secret Manager — le backend de Chibisafe amorce son compte administrateur de première exécution à partir de cette valeur au lieu de la valeur par défaut bien connue de l'amont.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~chibisafe"
    gcloud secrets versions access latest --secret=<api-key-secret-name> --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation. Notez que (contrairement à la variante GKE) le outputs.tf de ce module n'affiche pas le nom du secret généré comme sortie — localisez-le avec le filtre gcloud secrets list ci-dessus.

D. Réseau et ingress​

Le service est accessible à son URL run.app par défaut (ingress_settings = "all"), ce qui est approprié pour une interface utilisateur publique de téléchargement/hébergement de fichiers. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être ajouté via enable_cloud_armor.

  • 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. Les tests de disponibilité et les règles d'alerte optionnels sont désactivés par défaut (uptime_check_config.enabled = false).

  • 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 Chibisafe​

  • Pas de job d'initialisation ou de migration. Chibisafe gère son propre stockage SQLite ; Chibisafe_Common n'injecte aucun job db-init/de migration (database_type = NONE). La variable initialization_jobs est transmise au socle mais n'est utile que pour les tâches de chargement de données personnalisées.

  • Relocalisation de l'état au premier démarrage. L'image conserve l'état mutable sous trois répertoires frères dans son WORKDIR — /app/database (SQLite), /app/uploads (fichiers/miniatures) et /app/logs. Le point d'entrée (entrypoint.sh) lie symboliquement chacun d'eux dans un sous-répertoire du montage GCS Fuse unique (/data), migrant tout contenu amorcé par l'image dans le volume vide au premier démarrage. Ceci est idempotent à travers les redémarrages — les répertoires déjà liés symboliquement sont laissés intacts. Le même script de point d'entrée est partagé avec la variante GKE, qui monte un PVC de bloc au même chemin à la place.

  • Compte administrateur. Au premier démarrage, le backend crée le compte propriétaire admin. Si enable_api_key = true (la valeur par défaut), une valeur aléatoire est générée et injectée comme ADMIN_PASSWORD, que le backend utilise comme mot de passe de ce compte au lieu de la valeur par défaut bien connue de l'amont (admin) ; sinon, connectez-vous avec admin/admin et changez-le immédiatement. ADMIN_PASSWORD est transmis uniquement au processus backend — le point d'entrée le supprime de l'environnement du frontend et de Caddy.

  • Pas d'alias de variables d'environnement de base de données. database_type = NONE — il n'y a pas d'injection ou d'alias DB_HOST/DB_USER à craindre ; SQLite réside entièrement sur le volume GCS Fuse /data.

  • Processus et ports. tini est PID 1 ; le point d'entrée (après la relocalisation d'état ci-dessus) démarre trois processus :

    ProcessusÉcoute surSert
    Caddy0.0.0.0:$PORT (= container_port, par défaut 8000)Le seul écouteur vers lequel Cloud Run achemine
    Backend chibisafe-server127.0.0.1:18000 (loopback uniquement)/api/*, /docs*
    Frontend Next.js127.0.0.1:18001 (loopback uniquement)L'interface utilisateur web

    Ils sont supervisés en mode fail-fast : si l'un d'eux se termine, les autres sont arrêtés et le conteneur se termine avec le statut 1, de sorte que Cloud Run le redémarre (choisi plutôt que supervisord, qui maintiendrait un conteneur en bonne santé avec un frontend mort).

  • Routage (Caddyfile v6.5.5 de l'amont, même ordre) : tout chemin nommant un fichier sous /data/uploads est servi directement par Caddy (le backend ne sert pas les téléchargements en production) ; /api/* → backend (l'API REST — voir la sortie api_url) ; /docs* → backend (la référence OpenAPI Scalar) ; tout le reste → frontend (l'interface utilisateur web à /, par exemple /dashboard, /login). Deux déviations par rapport à l'amont : l'en-tête Host est préservé, de sorte que les liens de fichiers que le backend construit sont corrects sans définir "Servir les téléchargements depuis" ; et X-Forwarded-For/X-Real-IP sont définis sur l'IP client que Caddy résout lui-même (plages Google front-end fiables, sélection stricte la plus à droite), de sorte qu'un client ne peut pas les usurper.

  • Frontend → backend. Le rendu côté serveur du frontend appelle directement le backend à BASE_API_URL=http://127.0.0.1:18000, défini par le point d'entrée — rien ne dépend de l'interpolation par Cloud Run de $(VAR), ce qu'il ne fait pas. Le navigateur appelle le même-origine /api.

  • Environnement du conteneur. NODE_ENV=production est la seule valeur par défaut à l'échelle du conteneur ; HOST/HOSTNAME/PORT pour les deux processus Node sont définis par processus par le point d'entrée. PORT n'est délibérément pas injecté par Chibisafe_Common car Cloud Run réserve ce nom de variable d'environnement et le définit automatiquement à partir de container_port — l'injecter explicitement provoquerait une erreur 400 lors de l'appel de création de service. Caddy écoute sur ce PORT.

  • container_port est actif ici (contrairement à la variante GKE). chibisafe.tf fusionne container_port = var.container_port dans la configuration du module que la Fondation lit, donc changer cette variable change réellement le port vers lequel Cloud Run achemine et la valeur PORT sur laquelle Caddy écoute. Il ne doit pas être 18000 ou 18001 (les ports internes) ; le conteneur refuse de démarrer.

  • Téléchargements de plus de 32 Mio. Cloud Run plafonne le corps d'une requête HTTP/1 à 32 Mio, et la taille de bloc de téléchargement par défaut de Chibisafe est d'environ 81 Mo, de sorte que les téléchargements de fichiers de plus de 32 Mio échouent sur Cloud Run jusqu'à ce qu'un administrateur réduise la Taille de bloc dans les paramètres du tableau de bord (par exemple, à 25-30 Mo). Ceci est dérivé de la source amont et de la limite documentée de Cloud Run, non mesuré en direct. Chibisafe_GKE derrière un équilibreur de charge n'a pas une telle limite.

  • Mémoire. La valeur par défaut 1Gi contient maintenant deux processus Node plus Caddy ; cela n'a pas encore été mesuré en direct — augmentez memory_limit si les révisions sont tuées par manque de mémoire.

  • Mise à jour d'un déploiement existant. Une MISE À JOUR d'un déploiement effectué avec la version précédente uniquement backend reconstruit automatiquement l'image (le hachage de contenu du répertoire scripts change), conserve le port 8000, supprime la variable d'environnement HOST=0.0.0.0 à l'échelle du conteneur (maintenant définie par processus) et laisse les données sur /data intactes. / passe d'une réponse JSON 404 à l'interface utilisateur web.

  • Chemin de santé. Les sondes de démarrage et de vivacité sont toutes deux HTTP GET /api/health (variables startup_probe/liveness_probe de ce module, par défaut initial_delay_seconds = 15 / 30), envoyées via Caddy au backend, qui renvoie un 200 littéral une fois qu'il est en service, sans authentification requise. Voir §6 pour savoir pourquoi les variables séparées startup_probe_config / health_check_config n'ont en fait pas d'importance ici.

  • Inspecter la configuration en cours d'exécution :

    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT" \
    --format='value(status.url)'
    gcloud run revisions describe <revision-name> --region "$REGION" --project "$PROJECT" \
    --format='value(spec.containers[0].env)'
    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 Chibisafe sont listés ; toute autre entrée est héritée 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_iddemoCourt suffixe qui rend les noms de ressources uniques par environnement.
support_users[]E-mails autorisés à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namechibisafeNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameChibisafeNom lisible par l'homme affiché dans la console.
description(défini)Description du service.
application_versionlatestBalise d'image chibisafe/chibisafe-server ; latest est épinglé à v6.5.5 au moment du build via l'argument de build CHIBISAFE_VERSION spécifique à l'application.
enable_api_keytrueGénère une valeur aléatoire de 24 caractères dans Secret Manager, injectée comme ADMIN_PASSWORD, amorçant le premier identifiant administrateur au lieu de la valeur par défaut de l'amont.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000m1 vCPU par défaut.
memory_limit1Gi1 Gio par défaut. Le texte de description mentionne "index vectoriels"/"collections" — un artefact de copier-coller d'un module de base de données vectorielle ; ignorez la formulation, la valeur par défaut est correcte.
min_instance_count / max_instance_count1 / 1Maintenir à 1 — Chibisafe est une application SQLite à un seul rédacteur sur un montage GCS Fuse.
container_port8000Le port du proxy Caddy. Actif (voir §3) — modifie à la fois la route Cloud Run et la variable d'environnement injectée PORT. Ne doit pas être 18000/18001.
execution_environmentgen2Requis pour le montage GCS Fuse /data.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseInerte — main.tf code en dur false pour la Fondation quelle que soit la valeur de cette variable. Chibisafe n'a pas de base de données Cloud SQL.
container_protocolhttp1La description mentionne "requis pour Chibisafe gRPC" — un autre artefact de copier-coller ; Chibisafe n'a pas d'interface gRPC. Laisser à http1.
service_annotations / service_labels{}Annotations/étiquettes de service Cloud Run personnalisées.
enable_image_mirroringtrueMettre en miroir l'image construite dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour les déploiements progressifs.
max_revisions_to_retain7Déclaré pour la parité de convention ; non transmis par le main.tf de ce module.
container_image_source / container_image / container_build_config / container_resourcescustom / "" / {enabled=true} / {1000m,512Mi}Espaces réservés inertes, reflétés par la Fondation — le build réel (Dockerfile, argument de build CHIBISAFE_VERSION) provient de la configuration fixe de Chibisafe_Common, pas de ces variables.

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallPublic par défaut — Chibisafe est une interface utilisateur de téléchargement de fichiers directement consultée.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google.
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. NODE_ENV=production et HOST=0.0.0.0 sont définis automatiquement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et maintenance​

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 sont transmis au socle mais sont des opérations nulles — Chibisafe n'a pas de base de données SQL (database_type = NONE).

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

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner un équilibreur de charge HTTPS global + Cloud Armor WAF.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage, système de fichiers et Redis (inerte)​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionne le bucket storage toujours présent.
storage_buckets[]Buckets GCS supplémentaires au-delà du bucket de données auto-provisionné.
enable_nfstrueDoit rester true sur Cloud Run : la base de données SQLite, les téléchargements et les logs de Chibisafe résident sous /data, et GCS FUSE ne peut pas héberger une base de données SQLite.
nfs_mount_path/dataChemin de montage à l'intérieur du conteneur (pertinent uniquement si enable_nfs est défini).
gcs_volumes[]Montages de volume GCS Fuse supplémentaires. Le bucket Chibisafe storage est automatiquement ajouté à /data.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
enable_redistrue (reflété, inerte)Déclaré uniquement pour la parité de convention de la Fondation — main.tf transmet toujours enable_redis = false à App_CloudRun quelle que soit cette valeur. Chibisafe n'a pas de dépendance Redis.

Groupe 12 — Backend de base de données (non applicable)​

database_type est fixé à NONE par Chibisafe_Common. Toutes les autres variables du Groupe 12 — sql_instance_name, sql_instance_base_name, database_password_length, application_database_name, application_database_user, db_password_env_var_name, 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, enable_mysql_plugins/mysql_plugins, enable_postgres_extensions/postgres_extensions, enable_auto_password_rotation/rotation_propagation_delay_sec — sont déclarées uniquement pour la mise en miroir de la convention de la Fondation et n'ont aucun effet sur ce module.

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

VariableValeur par défautDescription
initialization_jobs[]Aucun job par défaut n'est injecté ; à utiliser uniquement pour des tâches de chargement de données personnalisées.
cron_jobs[]Jobs Cloud Run planifiés récurrents ; aucun par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/health, délai initial de 15sLa sonde de démarrage effective et active (voir §3).
liveness_probeHTTP /api/health, délai initial de 30sLa sonde de vivacité effective et active.
startup_probe_configHTTP /api/health, activéeInerte pour ce module — le socle d'App_CloudRun préfère toujours la sonde startup_probe spécifique à l'application fournie via application_config à cette variable autonome, donc la modifier n'a aucun effet sur la sonde déployée.
health_check_configHTTP /api/health, activéeMême inertie que startup_probe_config — liveness_probe (Groupe 14, ci-dessus) est ce qui est réellement déployé.
uptime_check_config{ enabled=false, path="/api/health" }Test de disponibilité Cloud Monitoring ; désactivé par défaut.
alert_policies[]Règles d'alerte métrique.

Groupe 23 — VPC Service Controls et Audit Logging​

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.
organization_id""Remplacement pour les projets imbriqués dans des dossiers.
enable_audit_loggingfalseLogs d'audit Cloud détaillés.

5. Sorties​

Retournées 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_urlURL de l'interface web de Chibisafe (servie à /). La même origine sert l'API REST sous /api, la référence OpenAPI à /docs et les fichiers téléchargés par leur nom.
api_urlURL de base de l'API REST (<service_url>/api), pour les clients et scripts de téléchargement ; GET <api_url>/health retourne 200 {"status":"yes"}.
service_nameNom du service Cloud Run.
chibisafe_urlAlias de service_url (l'interface web) ; accessible uniquement depuis le même VPC lorsque ingress_settings est internal.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURLs de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsque enable_cloud_armor 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_namesStatut de surveillance, canaux, tests de disponibilité.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
initialization_jobsNoms de tous les jobs d'initialisation personnalisés.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

Notez l'absence de sortie pour le secret optionnel enable_api_key — contrairement à Chibisafe_GKE (qui expose chibisafe_api_key_secret_id), ce module ne fait pas apparaître le nom du secret généré ; trouvez-le via gcloud secrets list --filter="name~chibisafe".


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).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de base App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un container_port/timeout_seconds/backup_retention_days hors de portée, un runtime gen1 combiné à gcs_volumes, un traffic_split invalide. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'apply ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
Modèle de persistanceGCS Fuse /data (seule option de ce module)CritiqueSQLite sur les sémantiques de verrouillage de fichiers POSIX de GCS Fuse n'est pas entièrement sûr en cas d'écritures soutenues/concurrentes. Les métadonnées du module recommandent explicitement Chibisafe_GKE (PVC de bloc) pour un stockage de production durable ; utilisez cette variante Cloud Run uniquement pour les téléchargeurs légers/à faible trafic.
max_instance_count1CritiqueChibisafe est une application SQLite à un seul rédacteur ; la mise à l'échelle au-delà d'une instance risque de corrompre la base de données SQLite sur le montage GCS Fuse partagé par des rédacteurs concurrents.
startup_probe / liveness_probe path/api/healthMoyen/api/health est un 200 littéral via le proxy vers le backend. / est l'interface web, dont le code d'état est le choix du front-end, donc une sonde à cet endroit n'est pas un signal de santé fiable.
container_port8000Moyen18000/18001 entrent en collision avec les ports internes du backend/front-end et le conteneur refuse de démarrer.
Taille du bloc de téléchargementréduire à 25–30 Mo dans les paramètres du tableau de bordMoyenLa limite de 32 Mio du corps de requête HTTP/1 de Cloud Run rejette les blocs par défaut de ~81 Mo de Chibisafe, de sorte que les téléchargements de fichiers de plus de 32 Mio échouent (dérivé de la source en amont, non mesuré en direct).
enable_api_keytrue pour tout déploiement en dehors d'un réseau de confianceÉlevéAvec ingress_settings = all (la valeur par défaut) et enable_api_key = false, la garde-fou au moment de la planification rejette la configuration ; sans cela, le compte admin conserverait le mot de passe bien connu en amont admin jusqu'à ce que quelqu'un le change.
ingress_settingsallMoyenConfirmez que votre copie de travail de ce module n'a pas régressé à internal — un bug historique de copier-coller à l'échelle de la flotte a fait que plusieurs ingress_settings de modules par défaut étaient internal, ce qui rendrait ce téléchargeur de fichiers public complètement inaccessible malgré la réussite des tests de santé.
startup_probe_config / health_check_configlaisser tel quel ; comprendre qu'ils sont inertesFaibleLa fondation d'App_CloudRun préfère toujours les startup_probe/liveness_probe spécifiques à l'application fournis via application_config à ces variables autonomes lorsque les deux sont présentes, donc la modification de ces deux n'a aucun effet sur la sonde déployée.
enable_cloudsql_volumefalse (seule valeur qui compte)Faiblemain.tf code en dur false à la Fondation, quelle que soit la valeur de cette variable ; Chibisafe n'a pas de base de données Cloud SQL.
enable_redistoute valeur (inerte)Faiblemain.tf transmet toujours enable_redis = false — la modification de cette variable n'a aucun effet ; ne vous y fiez pas pour ajouter la connectivité Redis.
memory_limit / min_instance_count / container_protocol descriptionsignorer le libelléFaibleLe texte de description de ces variables fait référence à des "index vectoriels", des "collections", du "chargement d'index" et du "gRPC" — un copier-coller résiduel d'un modèle de module de base de données vectorielle. Chibisafe est un téléchargeur de fichiers qui n'a rien de tout cela ; les valeurs par défaut numériques/chaînes elles-mêmes (1Gi, 1, http1) sont correctes et non affectées.
database_type / db_* / sql_instance_* variablesNONE / inertesFaibleChibisafe n'a pas de base de données SQL ; celles-ci n'existent que pour la mise en miroir des variables de la Fondation et sont ignorées silencieusement.
enable_api_key découvrabilité du secretutiliser gcloud secrets list --filter="name~chibisafe"FaibleLe outputs.tf de ce module n'expose pas le nom du secret généré comme sortie (contrairement au chibisafe_api_key_secret_id de Chibisafe_GKE).

Pour le comportement de la fondation référencé partout — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Autorisation binaire, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Chibisafe partagée avec la variante GKE se trouve dans le module Chibisafe_Common (modules/Chibisafe_Common/README.md) ; la variante GKE elle-même est documentée dans Chibisafe_GKE.

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