Grocy sur GKE Autopilot
Grocy est un ERP domestique et d'épicerie auto-hébergé :
suivi des stocks avec scan 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 de recettes/repas — Grocy est l'outil ERP domestique plus large. Ce
module déploie Grocy sur GKE Autopilot au-dessus de la
fondation App_GKE, qui provisionne et gère l'infrastructure Google
Cloud et Kubernetes partagée ; Grocy_GKE 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 que Grocy utilise et comment les explorer et les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress et équilibrage de charge, autoscaling, 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_GKE 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 un pod GKE Autopilot dans votre propre projet Google Cloud coûte environ 42,08 $/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 Mettez-le 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 Cloud Run pour l'option à moindre coût.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module (une seule fois) | 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 | Identique |
| Coût d'exécution Google Cloud | 42,08 $/mois, facturé par Google au prix catalogue | ~75 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 : 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) |
|---|---|
| Pod GKE Autopilot, 1x vCPU / 1 GiB | 36,08 $ |
| Cloud NAT et réseau | 5,00 $ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ |
| Frais de gestion de cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $ |
| Total | 42,08 $ |
Les frais de gestion de cluster GKE sont exclus du total ci-dessus car ils sont partagés entre toutes les applications GKE du projet — 0 $ si c'est la seule, sinon environ 73 $/mois répartis entre le nombre d'applications que vous exécutez.
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 généralement 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 de RAD couvre ces aspects même si la base de données sous-jacente ici n'est qu'un fichier.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le 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 propre suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, aucune VM, ni 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 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 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 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 qui convient à la plupart des utilisations d'étude/démo). Google indique 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.
Payez uniquement pendant que vous l'utilisez, 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 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é assez longtemps pour que le coût de redéploiement soit inférieur à son propre coût d'exécution — pour Grocy, cela représente environ 6 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é 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 alors 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 upstream LinuxServer.io grocy
, non modifiée) sur GKE Autopilot en tant que StatefulSet. Le déploiement relie
un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot (StatefulSet) | 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 | PVC de stockage par blocs (standard-rwo, 20Gi) | /config (base de données SQLite, configuration, téléchargements, sauvegardes) est monté sur un véritable périphérique de blocs, par pod via volumeClaimTemplates — voir §4 |
| Stockage d'objets | Cloud Storage | Un bucket storage est provisionné mais inutilisé lorsque le PVC est activé (par défaut) |
| Cache | Aucun | enable_redis est codé en dur false dans main.tf — Grocy n'a pas de dépendance de cache |
| Secrets | Secret Manager | Aucun généré pour Grocy — aucune information d'identification d'administrateur injectable n'existe |
| Ingress | Service Kubernetes | LoadBalancer par défaut du module ; ce déploiement utilise ClusterIP (voir §5) |
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 upstream de Grocy (
services/DatabaseService.php) — il n'y a pas de branchement de pilote MySQL/Postgres du tout.database_typeest fixé àNONE. - Un vrai PVC de bloc, pas NFS ou GCS FUSE — par conception, pas comme un correctif de bug.
stateful_pvc_enabled = trueest la valeur par défaut du module, résolvant automatiquementworkload_typeen"StatefulSet".Grocy_Commondéfinitenable_gcs_storage_volume = !stateful_pvc_enabled, de sorte que le volume GCS-FUSE est entièrement ignoré chaque fois que le PVC est utilisé (l'état par défaut). Voir §4 pour savoir pourquoi cela est important et comment cela se compare à la variante Cloud Run. - 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 — et parce que le StatefulSet utilisevolumeClaimTemplates, augmenter le nombre de réplicas donnerait à chaque pod son propre PVC non synchronisé plutôt que de partager/config. - Aucune information d'identification d'administrateur injectable. L'image upstream fournit des informations d'identification par défaut
admin/admin, 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 vous avez exécuté
gcloud container clusters get-credentials <cluster> --region <region> --project <project>
et que PROJECT, REGION et NAMESPACE sont définis. Les noms de services et de ressources
sont rapportés dans les Sorties du déploiement.
A. GKE Autopilot — le StatefulSet Grocy
Grocy s'exécute en tant que StatefulSet à réplica unique (pas un déploiement) afin que son
volumeClaimTemplates puisse lier un PVC de bloc stable par pod.
- Console : Kubernetes Engine → Charges de travail → sélectionnez le StatefulSet.
- CLI :
kubectl get statefulset -n "$NAMESPACE"
kubectl get pods -n "$NAMESPACE" -o wide
kubectl describe statefulset <name> -n "$NAMESPACE"
Voir App_GKE pour les mécanismes StatefulSet vs. Deployment, la stratégie de déploiement et les requêtes/limites de ressources Autopilot.
B. Le PVC de stockage par blocs /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é sur un
véritable volume de blocs standard-rwo (PD équilibré) via le
volumeClaimTemplates du StatefulSet. C'est la décision de stockage la plus importante pour ce module
(voir §4) ; perdre ou mal configurer ce PVC entraîne la perte de toutes les données Grocy.
- Console : Kubernetes Engine → Stockage → Revendications de volume persistant.
- CLI :
kubectl get pvc -n "$NAMESPACE"
kubectl describe pvc <pvc-name> -n "$NAMESPACE"
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 le
PVC de bloc à 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" --filter="name~grocy"
D. Réseau et ingress
La valeur par défaut du module est un service LoadBalancer avec un domaine personnalisé facultatif via l'API Gateway. Le config/deploy.tfvars de ce déploiement remplace cela par service_type = "ClusterIP" avec reserve_static_ip = false (une contrainte de quota d'IP statique par projet) — accédez-y via kubectl port-forward ou depuis l'intérieur du cluster.
- Console : Kubernetes Engine → Passerelles, Services et Ingress.
- CLI :
kubectl get svc -n "$NAMESPACE" -o wide
kubectl port-forward -n "$NAMESPACE" svc/<service-name> 8080:80
Voir App_GKE pour l'API Gateway, les IP statiques et les domaines personnalisés.
E. Cloud Logging et Monitoring
Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques Kubernetes 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 :
kubectl logs -n "$NAMESPACE" <pod-name> --tail=100
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 PVC, 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) réside dans des fichiers sur/config, la correction du PVC de bloc est la correction du déploiement. Confirmez que le PVC est lié et inscriptible avant de faire confiance à toute donnée écrite dessus. - Aucune information d'identification d'administrateur n'est générée ou injectable. L'image upstream fournit
des informations d'identification par défaut
admin/admin. Connectez-vous avec celles-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 des requêtes HTTP
GET /, qui renvoient 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 fonctionne. - La contrainte d'écriture unique est architecturale, pas un paramètre 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. Le pod
grocygkee6a1e84d-0a signalé1/1 Running, 0 redémarrages. Les journaux de démarrage montrent un démarrage propre de s6-overlay/LinuxServer — les migrations ont réussi, les clés TLS auto-signées générées sous/config/keyssans erreurs de permission,[ls.io-init] done..kubectl exec ... curlcontreGET /a renvoyé302→Location: /stockoverview→ suivi versGET /login→200, corps contenant<title>Login | Grocy</title>(10 102 octets) — correspondant exactement à la page de connexion vérifiée par Cloud Run.
4. Pourquoi ce module utilise un PVC de bloc — une conception vierge, pas un correctif de bug
Le câblage du stockage persistant de ce module mérite d'être compris par contraste avec
son homologue, Grocy_CloudRun.
Sur Cloud Run, Grocy montait à l'origine /config sur un bucket adossé à GCS-FUSE —
le modèle habituel de ce catalogue pour la configuration d'applications persistantes — et il bouclait en cas de crash en
production. Grocy écrit sur data/grocy.db-journal à chaque transaction de base de données
(environ toutes les 1 à 2 secondes en utilisation légère), et la couche de traduction de stockage d'objets de GCS FUSE,
construite autour de la sémantique d'objet entier à cohérence éventuelle,
ne pouvait pas supporter cette fréquence d'écriture. La solution Cloud Run a été de passer /config
à un montage Cloud Filestore (NFS) à la place — voir le
guide Grocy_CloudRun, §4
pour l'histoire complète.
Grocy_GKE n'a jamais eu ce problème à résoudre, car il a été conçu avec un
primitif de stockage différent dès le départ : stateful_pvc_enabled = true est la
valeur par défaut du module, qui exécute Grocy en tant que StatefulSet avec un véritable périphérique de bloc
(standard-rwo, un disque persistant équilibré) monté par pod à
/config. Un PVC de bloc n'est pas un système de fichiers réseau et pas une couche de traduction de stockage d'objets —
du point de vue du conteneur, il se comporte exactement comme un disque local,
avec une véritable sémantique POSIX (renommer, fsync, verrous de plage d'octets) et aucune
couche FUSE ne se trouve entre le moteur SQLite et les octets sur le disque. Il n'y a
rien ici qu'un fichier journal à haute fréquence d'écriture puisse submerger.
Grocy_Common encode cette relation directement :
enable_gcs_storage_volume = !stateful_pvc_enabled — donc chaque fois que le PVC est
activé (par défaut), le volume GCS-FUSE qui a causé le bug de Cloud Run n'est même jamais
câblé. Cela signifie également que le bug de permission de montage UID/GID gcsfuse séparé spécifique à GKE
rencontré ailleurs dans ce catalogue (confirmé sur des modules comme
PeerTube_GKE, où un conteneur non root ne peut pas écrire sur un montage gcsfuse sans
options de montage explicites uid/gid) ne s'applique tout simplement pas ici non plus — il n'y a pas
de montage gcsfuse à mal configurer.
stateful_fs_group = 1000 correspond aux PUID/PGID réels de l'image LinuxServer.io
(1000/1000), de sorte que le PVC de bloc est monté avec des droits d'écriture pour le groupe du processus réel du conteneur —
confirmé en direct : le journal de démarrage du pod montre des clés TLS auto-signées générées
sous /config/keys sans aucune erreur de permission.
Le résultat : ce module a été déployé et vérifié sans aucun bug trouvé ou
corrigé. Là où l'histoire de Grocy_CloudRun est "le mauvais primitif de stockage a cassé
SQLite, et voici la solution", l'histoire de Grocy_GKE est plus simple — le bon primitif de stockage
pour une charge de travail SQLite mono-écriture a été choisi dès le départ, et rien
n'a cassé.
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_GKE 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 de l'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 le pod chaud — é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, et le volumeClaimTemplates d'un StatefulSet donne à chaque réplica supplémentaire son propre PVC non synchronisé. |
container_port | 80 | Port HTTP par défaut de Grocy. |
enable_cloudsql_volume | false | Grocy n'a pas de Cloud SQL — conservez false. |
Groupe 6 — Configuration du backend GKE
| Variable | Valeur par défaut | Description |
|---|---|---|
workload_type | null | Se résout automatiquement en "StatefulSet" car stateful_pvc_enabled = true par défaut. |
service_type | LoadBalancer | Valeur par défaut du module pour une application accessible par navigateur. Ce déploiement remplace par ClusterIP via config/deploy.tfvars (contrainte de quota d'IP statique par projet). |
Groupe 7 — Configuration du StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | true | La décision de conception fondamentale pour ce module — voir §4. Un vrai PVC de stockage par blocs, pas un système de fichiers réseau ou GCS FUSE. |
stateful_pvc_size | 20Gi | Taille suffisante pour contenir la base de données SQLite, les images/pièces jointes et les sauvegardes sous /config. |
stateful_pvc_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 des données de l'image upstream change. |
stateful_pvc_storage_class | standard-rwo | Disque persistant équilibré — un véritable périphérique de blocs, pas de couche de traduction FUSE. |
stateful_fs_group | 1000 | Correspond aux PUID/PGID réels de Grocy (1000/1000) — confirmé en direct via la génération réussie de clés TLS sous /config/keys. |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Non utilisé sur GKE, contrairement à Grocy_CloudRun qui repose sur NFS. Le PVC de bloc remplace ce rôle ici. |
Groupe 15 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | true (valeur par défaut de la variable) | Remplacé inconditionnellement par false dans main.tf quelle que soit la valeur de cette variable — Grocy n'a pas de dépendance de cache. |
Groupe 16 — 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. |
Groupe 11 — Automatisation des charges de travail
| 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 10 — 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_GKE avec un comportement standard.
6. Sorties
| Sortie | Description |
|---|---|
service_name / namespace / service_cluster_ip | Identité du service Kubernetes. |
service_external_ip / service_url | Adresse externe (si LoadBalancer et une IP statique sont utilisées). |
statefulset_name | Nom du StatefulSet exécutant Grocy. |
storage_buckets | Buckets Cloud Storage créés (le bucket storage, inutilisé pour /config lorsque le PVC est activé). |
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 | État et canaux de surveillance. |
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). |
kubernetes_ready | Indique si le point de terminaison du cluster est disponible et si toutes les ressources Kubernetes sont déployées. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | État et détails du 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 de 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 via le moteur de fondation App_GKE, 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 en cas d'erreur |
|---|---|---|---|
stateful_pvc_enabled | true | Critique | Le désactiver sans un montage gcs_volumes correspondant ramène /config à GCS FUSE, reproduisant le risque de corruption lié à la fréquence d'écriture confirmé sur Grocy_CloudRun — une couche de traduction réseau/stockage d'objets ne peut pas supporter le modèle d'écriture grocy.db-journal de Grocy. |
stateful_pvc_mount_path | /config | Critique | Grocy code en dur son chemin de données vers /config. Changer le chemin de montage sans un changement d'image correspondant 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. Parce que le StatefulSet utilise volumeClaimTemplates, toute valeur supérieure à 1 ne partage même pas le stockage entre les réplicas — chaque pod obtient sa propre copie déconnectée des données. |
stateful_fs_group | 1000 | Élevé | Grocy s'exécute en tant qu'UID 1000 / GID 1000 (LinuxServer PUID/PGID). Un fsGroup non concordant rend le PVC non inscriptible par le processus réel du conteneur, produisant des erreurs de permission au premier démarrage. |
enable_redis | Toute valeur — ignorée | Faible | main.tf code en dur enable_redis = false quelle que soit cette variable, donc la définir true n'a aucun effet. Pas un risque, juste une opération nulle à connaître. |
database_type | NONE | Moyen | Grocy ignore cela 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 à la première connexion | Élevé | Les informations d'identification par défaut admin / admin de l'image upstream sont publiquement documentées ; les laisser inchangées sur un déploiement exposé LoadBalancer 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 — Workload Identity, ingress et équilibrage de charge, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à Grocy partagée avec la variante Cloud Run est décrite dans Grocy_Common. Pour le bug de corruption de stockage que ce module a évité par conception, voir Grocy_CloudRun.
Guides associés
- Lab pratique : Grocy sur GKE Autopilot — déployez-le étape par étape, avec les écrans de console et les commandes à chaque étape.
- Grocy sur Google Cloud Run — la même application sur Cloud Run, lorsque 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.
- Déployé aux côtés de Mealie sur GKE Autopilot, Homebox sur GKE Autopilot, Wallos sur GKE Autopilot, LubeLogger sur GKE Autopilot dans la solution Gestion de la maison et de la vie.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.