Aller au contenu principal

LubeLogger sur GKE Autopilot

LubeLogger sur GKE Autopilot

LubeLogger est un outil gratuit et open source de suivi de l'entretien des véhicules et de la consommation de carburant, basé sur ASP.NET Core (.NET), livré sous forme d'une seule image conteneur avec une base de données LiteDB intégrée. Ce module déploie LubeLogger sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par LubeLogger 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 à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_GKE plutôt que de les répéter ici.


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

LubeLogger sur le module GKE Autopilot de RAD coûte environ 42 $ US par mois dans votre propre projet, sans frais par véhicule. RAD facture 75 crédits une fois par déploiement dans votre propre projet (67,5 crédits, soit 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. La même application se déploie également sur Cloud Run pour environ 33 $ US par mois — voir le guide Cloud Run pour l'option à moindre coût. Si vous n'en avez besoin qu'occasionnellement, 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 au lieu de cela — voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,5 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 42 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 75 crédits par jour, soit environ 2 250 par mois (environ 225 $ US au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster)
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

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore assez d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

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

10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins pour 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 chaque application 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
Pod GKE Autopilot, 1x vCPU / 1 Gio36 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ US si c'est votre seul cluster, sinon ~73 $ US
Totalenviron 42 $ US

Comment cela se compare​

  • AUTOsist, un outil commercial de suivi de l'entretien de flotte, facture 6 à 7 $ US par véhicule par mois, avec un minimum de 59 $ US par mois pour 5 véhicules sur son forfait de base Maintenance.
  • Le module LubeLogger de RAD coûte environ 42 $ US par mois dans votre propre projet — dans la même fourchette que le minimum de 5 véhicules d'AUTOsist, mais sans frais par véhicule et sans plafond de nombre de véhicules : un foyer qui suit deux voitures coûte exactement le même prix qu'une petite flotte qui en suit vingt.
  • Comparaison autogérée : à 1 vCPU / 1 Gio, un droplet Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go (environ 24 $ US/mois) ferait bien fonctionner LubeLogger, mais vous devriez toujours gérer le système d'exploitation, les sauvegardes et les mises à niveau vous-même.

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

Si LubeLogger s'exécute dans un projet que RAD gère pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à LubeLogger dont vous n'avez besoin qu'occasionnellement — évaluation, environnement de démonstration, charge de travail saisonnière ou intermittente — que de le faire fonctionner en continu.

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.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. 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étruit pas la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 225 $ US par mois pour le maintenir en fonctionnement. Déployez LubeLogger, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour le temps où il a été réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'évaluation conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : les sauvegardes nocturnes ne survivent pas. Les sauvegardes et autres fichiers générés sont écrits dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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é LubeLogger et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

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

L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) — 75 crédits (7,50 $ US) au total. La suppression ne permet d'économiser de l'argent que si LubeLogger reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 6 jours ou plus, à la fois dans votre propre projet (environ 1,40 $ US par jour) et dans un projet géré par RAD (75 crédits par jour).
  • La majeure partie du coût d'exécution est généralement partagée. Pour LubeLogger, il s'agit de la base de données. Ils ne s'arrêtent que si 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 la partie calcul de cette application.
  • Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant 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 les mécanismes de pause/restauration et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle ; AUTOsist. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

LubeLogger s'exécute comme un seul pod ASP.NET Core, recommandé comme un StatefulSet avec un véritable PVC de stockage par blocs. Le déploiement connecte un ensemble minimal de services Google Cloud — il n'y a pas de base de données gérée dans la configuration par défaut :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod ASP.NET Core, 1 vCPU / 1 Gio par défaut, fixé à un seul réplica
Base de donnéesAucune (par défaut)Le mode par défaut de LubeLogger utilise un fichier de base de données LiteDB intégré interne — aucune instance Cloud SQL n'est créée
Stockage d'objets / stockage par blocsCloud Storage + Persistent DiskUn PVC de blocs (recommandé, stateful_pvc_enabled = true) à /App/data, plus un petit bucket GCS de dpkeys pour les clés de protection des données ASP.NET Core (toujours sauvegardé par GCS)
Cache et file d'attenteAucunLubeLogger n'utilise pas Redis et n'a pas de worker/file d'attente en arrière-plan
SecretsAucunAucun secret n'est généré — le premier compte est créé via l'enregistrement en libre-service
IngressCloud Load BalancingLoadBalancer externe par défaut ; domaine personnalisé optionnel + certificat géré

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

  • Pas de base de données externe par défaut. database_type = "NONE" — le fichier de base de données LiteDB intégré de LubeLogger est la source de vérité. LubeLogger prend également en charge un backend Postgres externe optionnel via une seule variable d'environnement DSN POSTGRES_CONNECTION, mais ce module ne connecte pas Cloud SQL pour cela.
  • Le PVC de stockage par blocs est la disposition recommandée. stateful_pvc_enabled = true (par défaut) exécute LubeLogger en tant que StatefulSet avec un PVC par pod monté à /App/data — un véritable périphérique de blocs offre un verrouillage de fichier fiable pour la base de données LiteDB intégrée, contrairement à GCS FUSE.
  • Une seule instance. min_instance_count = 1 et max_instance_count = 1 — le mode par défaut de LubeLogger sert un fichier de base de données partagé à partir d'un seul volume ; l'exécution de plusieurs réplicas sur le même fichier le corrompt.
  • S'exécute en tant que root ; pas besoin de fsGroup. Confirmé directement sur l'image en cours d'exécution — l'image officielle de LubeLogger n'a pas de directive USER, donc stateful_fs_group est par défaut 0 (non défini).
  • Sécurisé par défaut. EnableAuth = "true" remplace la valeur par défaut appsettings.json de LubeLogger, qui est un accès entièrement ouvert. Il n'y a pas de compte administrateur pré-rempli — la première personne à remplir le formulaire d'inscription sur /Login obtient l'accès.
  • Image pré-construite, pas d'étape de build. Le module déploie directement l'image officielle ghcr.io/hargata/lubelogger (mise en miroir dans Artifact Registry par défaut) — il n'y a pas de Dockerfile ou de Cloud Build impliqué.
  • Accessible de l'extérieur par défaut. service_type = "LoadBalancer" — LubeLogger est une application web publique, pas une charge de travail interne uniquement.

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. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail LubeLogger​

LubeLogger s'exécute comme un seul pod (StatefulSet par défaut), qu'Autopilot facture en fonction du CPU/mémoire demandé.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail LubeLogger pour voir le pod, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Déploiement vs StatefulSet).

B. Stockage persistant — PVC de blocs et Cloud Storage​

La disposition par défaut (stateful_pvc_enabled = true) provisionne un PVC basé sur Persistent Disk par pod monté à /App/data — cela contient le fichier de base de données LiteDB intégré et les photos/reçus/documents téléchargés. Un petit bucket Cloud Storage séparé (dpkeys) est toujours monté via GCS FUSE au chemin fixe /root/.aspnet/DataProtection-Keys, indépendamment du PVC.

  • Console : Kubernetes Engine → Stockage (PVC) ; Cloud Storage → Buckets.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    gcloud storage buckets list --project "$PROJECT" --filter="name~lubelogger"

Voir App_GKE pour StorageClass, CMEK et les options de montage GCS Fuse.

C. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

D. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des règles d'alerte optionnels sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application LubeLogger​

  • Pas de configuration de base de données au premier déploiement. Il n'y a pas de job db-init — LubeLogger initialise son propre fichier de base de données LiteDB et sa structure de répertoires (config/, documents/, images/, temp/, themes/, translations/ sous /App/data) au premier démarrage.
  • Pas de credential admin fixe. Ouvrez le service, allez à /Login, et soumettez le formulaire Register — cela devient le compte utilisable. Complétez ceci immédiatement après le premier déploiement : EnableAuth = "true" restreint le reste de l'application, mais l'enregistrement lui-même est ouvert à quiconque peut atteindre l'URL jusqu'à ce qu'un premier compte existe.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /Login — la page publique et non authentifiée de LubeLogger. La racine de l'application / est protégée par [Authorize] et ferait échouer une sonde non authentifiée même sur un conteneur sain.
  • Postgres externe optionnel. LubeLogger prend en charge une seule variable d'environnement DSN POSTGRES_CONNECTION (Host=<host>;Port=5432;Username=<user>;Password=<pass>;Database=<db>;) pour utiliser une base de données Postgres externe au lieu du fichier LiteDB intégré. Ce module ne provisionne pas Cloud SQL pour ce chemin.
  • Instance unique, toujours. max_instance_count est fixé à 1 — le mode par défaut de LubeLogger n'a pas de support de verrouillage distribué ou de multi-écriture pour sa base de données intégrée.
  • S'exécute en tant que root. Confirmé via docker inspect/docker exec sur l'image réelle — pas de directive USER, le processus s'exécute en tant que uid 0. Pertinent si vous ajoutez un securityContext restreint — la configuration par défaut n'en a pas besoin.

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 LubeLogger sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement standard et ses valeurs par défaut.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelubeloggerNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image sur ghcr.io/hargata/lubelogger. L'image étant pré-construite (non construite sur mesure), cela sélectionne directement la version publiée.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
min_instance_count1Maintenu à 1 pour éviter les démarrages à froid.
max_instance_count1Doit rester à 1 — le mode par défaut de LubeLogger sert un fichier de base de données partagé.
cpu_limit1000mCPU par pod.
memory_limit1GiMémoire par pod.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseLe mode par défaut de LubeLogger n'a pas de Cloud SQL.
enable_image_mirroringtrueMettre en miroir l'image LubeLogger dans Artifact Registry avant le déploiement.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets, fusionnés avec les EnableAuth = "true" par défaut du module.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager. Utilisez ceci pour POSTGRES_CONNECTION si vous connectez le backend Postgres externe optionnel.
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 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerLubeLogger est une application web publique, elle est donc par défaut accessible de l'extérieur.
workload_typenull (auto → StatefulSet)Se résout automatiquement en StatefulSet lorsque stateful_pvc_enabled = true.
session_affinityNonePas de routage persistant nécessaire — réplica unique.
network_tags["nfsserver"]Tags réseau de nœud/pod ; pertinent uniquement si enable_nfs = true.
termination_grace_period_seconds60Secondes à attendre après SIGTERM avant SIGKILL (permet à LubeLogger de vider les écritures).
enable_network_segmentationfalseCréer des ressources Kubernetes NetworkPolicy.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueRecommandé pour LubeLogger — un véritable PVC de blocs offre un verrouillage de fichier fiable pour la base de données LiteDB intégrée.
stateful_pvc_size20GiTaille de stockage du PVC par pod — dimensionné pour la base de données LiteDB, les documents/reçus téléchargés et les frais généraux.
stateful_pvc_mount_path/App/dataChemin de montage du conteneur pour le PVC — doit correspondre au répertoire de données de LubeLogger.
stateful_pvc_storage_classstandard-rwoKubernetes StorageClass pour les PVC ; utilisez premium-rwo pour des IOPS plus élevées.
stateful_headless_servicenullCréer un service sans tête pour des noms DNS de pod stables.
stateful_pod_management_policynullOrdre de création des pods : OrderedReady ou Parallel.
stateful_update_strategynullStratégie de mise à jour : RollingUpdate ou OnDelete.
stateful_fs_group0Non défini — l'image officielle de LubeLogger s'exécute en tant que root et n'a pas besoin de fsGroup pour écrire sur le PVC.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalseCréer un Kubernetes ResourceQuota dans l'espace de noms de l'application.
quota_memory_requests / quota_memory_limits""Nécessite un suffixe binaire (par exemple 4Gi, 8192Mi) par convention lorsqu'il est défini.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau de nœuds.
pdb_min_available1Nombre minimal de pods disponibles pendant les interruptions volontaires.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /Login délai de 15sSonde de démarrage.
liveness_probeHTTP /Login délai de 30sSonde de vivacité.
startup_probe_configHTTP /LoginSonde d'infrastructure de niveau App_GKE.
health_check_configHTTP /LoginSonde de vivacité de niveau App_GKE.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring optionnel.
alert_policies[]Politiques d'alerte métrique optionnelles.

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

VariableValeur par défautDescription
initialization_jobs[]Le mode par défaut de LubeLogger n'a pas besoin de job d'initialisation.
cron_jobs[]Pas de tâches récurrentes planifiées par la plateforme par défaut.
additional_services[]Services sidecar ou auxiliaires déployés avec LubeLogger.

Groupe 12 — CI/CD et intégration GitHub​

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

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueCréer les buckets GCS storage et dpkeys.
storage_buckets[]Buckets supplémentaires à provisionner.
gcs_volumes[]Montages de volume GCS Fuse supplémentaires via le pilote CSI.
max_images_to_retain7Nombre maximal d'images Artifact Registry récentes à conserver.
delete_untagged_imagestrueSupprimer automatiquement les images non taguées.
image_retention_days30Jours après lesquels les images sont éligibles à la suppression.

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redistrue (valeur par défaut de la fondation)Transmis pour la compatibilité ; LubeLogger_GKE le force false — LubeLogger n'a pas besoin de Redis.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixe — le mode par défaut de LubeLogger n'a pas de base de données Cloud SQL.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôtes personnalisés + certificat géré.
application_domains[]Noms d'hôtes à servir.
reserve_static_iptrueIP externe stable sur les redéploiements.

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP interne au cluster.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre LubeLogger.
storage_bucketsBuckets Cloud Storage créés (storage, dpkeys).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobsNoms des jobs de configuration (aucun par défaut).
statefulset_nameNom du StatefulSet.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification. 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'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
max_instance_count1CritiqueLe mode par défaut de LubeLogger sert un fichier de base de données intégré partagé à partir d'un seul volume ; plus d'un réplica risque la corruption de la base de données par des écritures concurrentes. Appliqué par une garde de validation au moment de la planification.
stateful_pvc_enabledtrueÉlevéUn véritable PVC de blocs offre un verrouillage de fichier fiable ; le recours à GCS FUSE pour /App/data (en définissant ceci false) risque des conflits de verrouillage lors d'écritures concurrentes.
stateful_pvc_mount_path/App/dataCritiqueDoit correspondre au répertoire de données réel de LubeLogger — un chemin incorrect signifie que la base de données et les téléchargements sont écrits dans un stockage de pod éphémère et perdus à chaque redémarrage.
storage/dpkeys buckets, ou le PVCNe jamais supprimerCritiqueLa perte de /App/data (PVC ou bucket storage) entraîne la perte de tous les enregistrements de véhicules ; la perte de dpkeys invalide toutes les sessions de connexion existantes (récupérable — force uniquement la reconnexion).
EnableAuthtrue (par défaut)CritiqueLe définir sur false revient au mode d'accès entièrement ouvert de LubeLogger — toute personne ayant l'URL peut afficher/modifier toutes les données sans aucune connexion.
Enregistrement au premier démarrageTerminer immédiatement après le déploiementÉlevéTant qu'un premier compte n'est pas enregistré, le formulaire d'inscription est accessible à quiconque peut atteindre l'URL.
Chemin startup_probe/liveness_probe/LoginCritiquePointer les sondes vers / (ou tout chemin protégé par [Authorize]) fait échouer la sonde sur un pod par ailleurs sain — il ne devient jamais Prêt.
workload_typelaisser null (auto)ÉlevéDéfinir workload_type = "Deployment" avec stateful_pvc_enabled = true échoue au moment de la planification — un modèle de PVC nécessite un StatefulSet.
database_typeNONE (par défaut)ÉlevéLe mode par défaut de LubeLogger ignore entièrement ce paramètre ; le modifier ne connecte pas LubeLogger à une instance Cloud SQL — utilisez plutôt POSTGRES_CONNECTION pour le chemin Postgres externe optionnel.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers nus sont des octets et bloquent toute planification de pod dans l'espace de noms.
enable_pod_disruption_budgettrueMoyenLa désactivation permet à GKE d'expulser le pod pendant la maintenance sans protection.
service_typeLoadBalancer (par défaut)MoyenLe définir sur ClusterIP rend l'interface utilisateur web publique inaccessible depuis l'extérieur du cluster.

Pour le comportement de la fondation référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, 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 à LubeLogger partagée avec la variante Cloud Run est décrite dans LubeLogger_Common.

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