Grocy sur Google Cloud Run
Grocy est un ERP domestique auto-hébergé : suivi des stocks avec
lecture de codes-barres, gestion des tâches, listes de courses et planification des repas.
Il est distinct du module Mealie de ce catalogue, qui ne couvre que la
planification des recettes/repas — Grocy est l'outil ERP domestique plus large. Ce module
déploie Grocy sur Cloud Run v2 au-dessus de la fondation
App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud
partagée ; Grocy_CloudRun est un wrapper léger qui fournit la propre configuration de Grocy
(image, port, sondes, câblage de stockage) et transmet tout le reste directement.
Ce guide se concentre sur les services cloud utilisés par Grocy 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 Grocy sur RAD, et comment cela se compare
L'exécution de Grocy sur Cloud Run dans votre propre projet Google Cloud coûte environ 32,57 $/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 75 crédits facturé une fois au moment du déploiement. Grocy est un ERP domestique léger avec sa propre base de données SQLite intégrée, de sorte que le coût d'exécution de ce déploiement est presque entièrement dû au petit serveur de fichiers NFS derrière lui, et non à une base de données gérée. Dans un projet géré par RAD, les frais de module tombent à 67,5 crédits (10 % de moins) et le coût d'exécution est mesuré à l'heure en crédits au lieu d'être facturé directement par Google — voir Mettre en pause gratuitement ci-dessous pour le seul avantage géré par RAD qu'un VPS auto-hébergé ne peut égaler — ou voir le guide GKE si vous préférez l'exécuter sur Kubernetes.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module (unique) | 75 crédits | 67,5 crédits (10 % de moins) |
| Builds | Inclus 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 build | Idem |
| Coût d'exécution Google Cloud | 32,57 $/mois, facturé par Google au prix catalogue | ~23 crédits/jour, mesuré au prix catalogue plus la 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, 1x vCPU / 1 GiB (chaud) | 13,14 $ |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ |
| Cloud NAT et réseau | 5,00 $ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ |
| Total | 32,57 $ |
Comment cela se compare
- Une comparaison auto-gérée : l'empreinte de 1 vCPU/1 GiB de Grocy est suffisamment légère pour une classe de VPS moins chère et plus petite que les boîtiers de milieu de gamme habituellement cités ici — mais pour un point de référence direct, Hetzner CPX22/DigitalOcean 2 vCPU/4 Go coûtent environ 24 $/mois et un GCP e2-standard-2 environ 49 $/mois.
- Grocy n'a pas d'offre SaaS hébergée officielle — il n'est livré qu'en tant que logiciel auto-hébergé, il s'agit donc d'une comparaison VPS vs pile gérée par RAD, et non RAD vs un abonnement.
- Ce qu'un VPS nu ne vous offre pas : sauvegardes automatiques du fichier de données SQLite, rotation des secrets ou surveillance — la pile gérée par RAD couvre ces aspects même si la base de données sous-jacente ici n'est qu'un fichier.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin
C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien lorsqu'il est en pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démonte pas Cloud SQL, aucune VM, ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.
Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de secours 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 la 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 un projet dont RAD gère uniquement la facturation), 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, de sorte que 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/démo). Google affirme que la plupart des services sont de nouveau pleinement fonctionnels 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 logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Grocy 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.
Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer
Dans votre propre projet, ou une fois que 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources définitivement, et ramener Grocy signifie le redéployer à partir de zéro. Cela coûte 75 crédits (les frais de module ; les builds sont inclus).
La suppression ne permet d'économiser de l'argent que si Grocy reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour Grocy, c'est environ 8 jours ou plus. La majeure partie de ce coût d'exécution est généralement la base de données (et, lorsque ce module en utilise une, la VM de serveur de fichiers partagée ou le cluster GKE) — ceux-ci ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que sa propre part de calcul.
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 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration.
1. Vue d'ensemble
Grocy s'exécute comme un conteneur nginx + php-fpm (l'image LinuxServer.io grocy
amont, non modifiée) sur Cloud Run v2. Le déploiement relie un ensemble ciblé de
services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | 1 vCPU / 1 GiB par défaut, min=max=1 (pas d'autoscaling — SQLite mono-écriture) |
| Base de données | Aucune | Grocy utilise une base de données SQLite intégrée — aucune instance Cloud SQL n'est créée |
| État persistant | Cloud Filestore (NFS) | /config (base de données SQLite, configuration, téléchargements, sauvegardes) est monté via NFS, pas GCS FUSE — voir §4 |
| Stockage d'objets | Cloud Storage | Un bucket storage est provisionné mais inutilisé par défaut (voir §4) |
| Secrets | Secret Manager | Aucun généré pour Grocy — aucune identifiant d'administrateur injectable n'existe |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- SQLite est la seule base de données prise en charge par Grocy. Confirmé en lisant la propre
source amont de Grocy (
services/DatabaseService.php) — il n'y a pas de branchement de pilote MySQL/Postgres du tout.database_typeest fixé àNONE. /configest persisté via NFS, pas GCS FUSE — une correction délibérée, pas la valeur par défaut habituelle du catalogue. Grocy écrit dansdata/grocy.db-journaltoutes les 1 à 2 secondes ; la couche de traduction de stockage d'objets de GCS FUSE ne peut pas supporter ce modèle d'écriture. Un/configbasé sur GCS-FUSE a bouclé en boucle en production (confirmé en direct sur 12 cycles de démarrage / plus de 20 minutes —BufferedWriteHandler.OutOfOrderErrorrépété, limitation de débit HTTP429, erreurs de descripteur de fichier périmé).Grocy_CloudRundéfinit plutôtenable_nfs = true,nfs_mount_path = "/config". Voir §4 pour l'histoire complète.- Il s'agit d'une classe de bugs véritablement différente de l'incident SQLite-sur-NFS
d'UptimeKuma. Le problème d'UptimeKuma était l'incompatibilité de verrouillage en mode WAL. Grocy n'active
jamais le mode WAL (pas de PRAGMA
journal_modenulle part dans sa source) — son problème est la fréquence d'écriture, pas la sémantique de verrouillage. Ensemble, ils montrent que "gcsfuse casse SQLite" est une leçon plus large que le simple verrouillage WAL. - Une seule instance.
min_instance_count = 1,max_instance_count = 1. La base de données SQLite de Grocy est mono-écriture sans support de clustering — l'exécution de plusieurs réplicas sur le même volume est dangereuse. - Aucun identifiant d'administrateur injectable. L'image amont fournit des identifiants
admin/adminpar défaut, modifiables via l'interface web lors de la première connexion. Aucun secret Secret Manager n'est créé pour Grocy. - Les sondes de santé atteignent
/, pas/health. Grocy n'a pas de point de terminaison de santé dédié ; la page de connexion (200, non authentifiée) est utilisée pour les sondes de démarrage et de vivacité.
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 Grocy
Grocy s'exécute comme un service Cloud Run v2 à instance unique. 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 Filestore (NFS) — le volume /config
Tout l'état de Grocy — la base de données SQLite intégrée (grocy.db), config.php,
les images/pièces jointes téléchargées et les sauvegardes — se trouve sous /config, monté via une
instance Cloud Filestore (NFS) plutôt que GCS FUSE. C'est la décision de stockage portante
pour ce module (voir §4) ; la perte ou la mauvaise configuration de ce montage
entraîne la perte de toutes les données Grocy.
- Console : Filestore → Instances.
- CLI :
gcloud filestore instances list --project "$PROJECT" --zone "$REGION-a"
gcloud filestore instances describe <instance-name> --project "$PROJECT" --zone "$REGION-a"
Voir App_CloudRun pour le comportement de découverte automatique et de provisionnement NFS.
C. Cloud Storage
Un bucket Cloud Storage storage dédié est provisionné automatiquement, mais par
défaut, il n'est pas utilisé pour sauvegarder /config — ce montage passe par NFS à la place
(voir §4). Il reste disponible pour tout gcs_volumes personnalisé qu'un opérateur ajoute.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT"
Voir App_CloudRun pour les options GCS Fuse et CMEK.
D. Réseau et ingress
Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe
avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ;
les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.
- 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 journaux de conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des stratégies d'alerte facultatives.
- Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
3. Comportement de l'application Grocy
- Pas de configuration de base de données au premier déploiement. Grocy n'a pas de base de données externe et pas de
job
db-init— il crée et migre son propre schéma SQLite intégré sous/configau premier démarrage. - La durabilité de
/configdépend du montage NFS, pas d'une base de données gérée. Parce que tout l'état de Grocy (base de données, configuration, téléchargements, sauvegardes) se trouve dans des fichiers sur/config, la correction du montage NFS est la correction du déploiement. Confirmez que le montage est sain avant de faire confiance aux données qui y sont écrites. - Aucun identifiant d'administrateur n'est généré ou injectable. L'image amont fournit
des identifiants
admin/adminpar défaut. Connectez-vous avec ceux-ci lors du premier accès et changez le mot de passe immédiatement via Utilisateurs → admin → Modifier dans l'interface utilisateur de Grocy — il n'y a pas de variable d'environnement ou de valeur Secret Manager qui le définisse pour vous. - Chemin de santé. Les sondes de démarrage et de vivacité émettent toutes deux un HTTP
GET /, qui renvoie la page de connexion de Grocy (200) sans authentification requise. Ce n'est pas un point de terminaison de santé dédié — Grocy n'en a pas — mais il indique de manière fiable que la pile nginx + php-fpm est en service. - La contrainte d'écriture unique est architecturale, pas un bouton de mise à l'échelle. Parce que la base de données
SQLite de Grocy n'a pas d'équivalent MySQL/Postgres et pas de support de clustering,
max_instance_countdoit rester à1. Il n'y a pas de configuration qui permette en toute sécurité la mise à l'échelle horizontale pour ce module. - Vérifié en direct.
https://grocycr31ffe08b-kj6qcu2rxa-uc.a.run.app— 16 échantillons curl sur environ 5 minutes contre une seule révision stable (grocycr31ffe08b-00003-h4w), servant constamment<title>Login | Grocy</title>, avec zéro entrée de journal de signature de corruption (OutOfOrderError/429/stale file/database is locked/disk I/O errortoutes absentes) après la correction NFS décrite au §4.
4. Pourquoi /config utilise NFS au lieu de GCS FUSE — la véritable histoire
Le câblage de stockage persistant de ce module n'est pas la valeur par défaut habituelle de ce catalogue, et la raison mérite d'être comprise avant de la modifier.
Grocy écrit dans data/grocy.db-journal à chaque transaction de base de données — confirmé
en direct, environ toutes les 1 à 2 secondes en utilisation légère. La couche de traduction de stockage d'objets de GCS FUSE
est construite autour de la cohérence éventuelle, de la sémantique d'objet entier ; elle
ne supporte pas ce type de modèle d'écriture de petite taille à haute fréquence. Grocy_CloudRun
montait à l'origine /config sur un bucket basé sur GCS-FUSE — le modèle habituel de ce catalogue
pour la configuration d'application persistante — et il a bouclé en boucle en production. Confirmé
en direct sur 12 cycles de démarrage complets sur plus de 20 minutes, avec des vérifications HTTP réelles ne
renvoyant jamais une page fonctionnelle :
BufferedWriteHandler.OutOfOrderErrorrépété- Réponses de limitation de débit HTTP
429de GCS - Erreurs de descripteur de fichier périmé
- Une boucle de redémarrage en cas de crash permanent
La solution : passer /config de GCS FUSE au support de volume NFS natif de la Fondation
— enable_nfs = true, nfs_mount_path = "/config" — avec
le propre Grocy_Common de enable_gcs_storage_volume défini sur false pour éviter un
double montage au même chemin. NFS implémente de véritables sémantiques de fichiers POSIX
(renommage/fsync/verrous consultatifs) que la couche de traduction de GCS FUSE n'implémente pas, et il
supporte le modèle d'écriture de Grocy sans problème.
Pourquoi il s'agit d'un bug véritablement différent de l'autre incident SQLite sur stockage partagé
du catalogue (UptimeKuma) : Le problème d'UptimeKuma était l'incompatibilité de verrouillage en mode WAL
avec NFS. Grocy n'active jamais le mode WAL — il n'y a pas de
PRAGMA journal_mode nulle part dans sa source (confirmé par rapport à l'amont
DatabaseService.php) ; il utilise le mode DELETE/journal de restauration par défaut de SQLite. Ainsi,
l'échec de Grocy sur GCS FUSE n'avait rien à voir avec le verrouillage — c'était purement un problème de
fréquence d'écriture que la sémantique de stockage d'objets de GCS FUSE ne peut pas absorber.
Lues ensemble, la leçon générale s'élargit : gcsfuse peut casser une base de données SQLite intégrée
pour plus d'une raison — non seulement le verrouillage en mode WAL, mais aussi
les modèles d'écriture à haute fréquence en général, indépendamment du mode journal.
Un bug secondaire, sans rapport, a été corrigé au passage lors de la construction de ce module : un
remplacement container_image_source = "prebuilt" égaré dans deploy.tfvars a silencieusement contourné
la construction Dockerfile personnalisée entièrement — la même classe de pièges déjà documentée dans
ce catalogue pour UptimeKuma.
La variante GKE adopte une approche différente du même problème sous-jacent.
Grocy_GKE est échafaudé mais n'a pas encore été déployé ou vérifié. Sa correction prévue
est un PVC de bloc StatefulSet à /config — un véritable stockage de blocs, pas du tout un système de fichiers réseau
— correspondant au modèle général de ce catalogue pour les variantes GKE d'applications gourmandes en SQLite
(par exemple CalibreWeb_GKE). Ce guide sera mis à jour une fois que cette
variante sera déployée et vérifiée.
5. 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 Grocy sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | grocy | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | Grocy | Nom lisible par l'homme affiché dans la console. |
application_version | latest | Tag d'image LinuxServer. "latest" se résout en v4.6.0-ls333 épinglé (l'ARG de build GROCY_VERSION, pas le générique APP_VERSION). |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
cpu_limit / memory_limit | 1000m / 1Gi | Grocy est léger ; la mémoire par défaut offre une marge pour les téléchargements d'images/pièces jointes. |
min_instance_count | 1 | Maintient l'instance chaude — évite les démarrages à froid. |
max_instance_count | 1 | Doit rester à 1. La base de données SQLite de Grocy est mono-écriture sans support de clustering. |
container_port | 80 | Port HTTP par défaut de Grocy. |
container_protocol | http1 | Grocy sert du HTTP/1.1 simple ; h2c n'est pas requis. |
execution_environment | gen2 | Requis pour le montage NFS. |
enable_cloudsql_volume | false | Grocy n'a pas de Cloud SQL — conservez false. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Fusionné avec les valeurs par défaut de Grocy_Common : PUID=1000, PGID=1000, TZ=Etc/UTC. |
secret_environment_variables | {} | Aucun secret par défaut n'existe pour Grocy — cette carte est purement fournie par l'opérateur. |
Groupe 11 — Cloud Storage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | Par défaut à true pour ce module — requis pour que /config puisse supporter le modèle d'écriture SQLite de Grocy (voir §4). Ne pas désactiver sauf si remplacé par un montage tout aussi durable et conforme à POSIX. |
nfs_mount_path | /config | Grocy conserve tout son état (base de données, configuration, téléchargements, sauvegardes) ici. Ne pas modifier sauf si le chemin de données de l'image amont change. |
create_cloud_storage | true | Le bucket storage est toujours créé (inutilisé pour /config par défaut ; disponible pour gcs_volumes personnalisé). |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Fixe — Grocy n'a aucune base de données SQL d'aucune sorte. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Pas de job d'initialisation par défaut — Grocy amorce son propre schéma SQLite au premier démarrage. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP / , délai de 15s, 10 tentatives | Page de connexion de Grocy — aucun point de terminaison de santé dédié n'existe. |
liveness_probe | HTTP / , délai de 30s, 3 tentatives | Même point de terminaison que la sonde de démarrage. |
Toutes les autres entrées sont héritées de App_CloudRun avec un comportement standard.
6. Sorties
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
grocy_url | URL de l'interface utilisateur Grocy (port 80). Accessible uniquement au sein du VPC lorsque ingress_settings = "internal". |
service_location | Région dans laquelle le service s'exécute. |
stage_services | Détails du service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
storage_buckets | Buckets Cloud Storage créés (le bucket storage, inutilisé pour /config par défaut). |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | État de la surveillance, canaux, vérifications de disponibilité. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
initialization_jobs | Noms des jobs d'initialisation créés (vides par défaut). |
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_id | Registre 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_enabled | Journalisation d'audit et état CMEK. |
7. 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 la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. La plupart des entrées hors limites ou contradictoires sont détectées avant la création de toute ressource.
| Paramètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
enable_nfs | true | Critique | Le désactiver sans un montage POSIX tout aussi durable ramène /config à GCS FUSE (ou à un chemin éphémère dans le conteneur), reproduisant la boucle de crash-redémarrage confirmée (BufferedWriteHandler.OutOfOrderError, 429, erreurs de descripteur de fichier périmé) — ou perdant silencieusement tout l'état à chaque redémarrage. |
nfs_mount_path | /config | Critique | Grocy code en dur son chemin de données vers /config. Modifier le chemin de montage sans une modification d'image correspondante entraîne la perte d'accès à la base de données, à la configuration et aux téléchargements. |
max_instance_count | 1 | Critique | La base de données SQLite de Grocy est mono-écriture sans support de clustering. Toute valeur supérieure à 1 risque de corrompre la base de données par des écritures concurrentes. |
container_image_source | custom (la valeur par défaut du module) | Élevé | Un remplacement "prebuilt" égaré contourne silencieusement la construction Dockerfile personnalisée (déjà rencontrée une fois lors de la construction de ce module, et documentée pour UptimeKuma) — Cloud Run pointe alors vers un chemin Artifact Registry non construit. |
database_type | NONE | Moyen | Grocy l'ignore entièrement (aucun chemin de code ne le lit), mais définir autre chose provisionne une instance Cloud SQL inutilisée et facturée. |
| Mot de passe administrateur | Changer lors de la première connexion | Élevé | Les identifiants admin / admin par défaut de l'image amont sont publiquement documentés ; les laisser inchangés sur un déploiement ingress_settings = "all" public est une réelle exposition. |
min_instance_count | 1 | Faible | Définir 0 permet d'économiser des coûts mais réintroduit des démarrages à froid sur la pile nginx + php-fpm de Grocy. |
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 à Grocy est décrite dans Grocy_Common.
Guides associés
- Lab pratique : Grocy sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Grocy sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- Grocy Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.