Aller au contenu principal

Uptime Kuma sur GKE Autopilot

Uptime Kuma sur GKE Autopilot

Uptime Kuma est un outil d'auto-hébergement pour la surveillance de la disponibilité des sites web, des API, des ports TCP, des enregistrements DNS, et plus encore, avec un tableau de bord clair, des pages de statut publiques et plus de 90 canaux de notification. Ce module déploie Uptime Kuma sur GKE Autopilot en s'appuyant sur la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Uptime Kuma v1 est inhabituel parmi les applications de ce dépôt : il stocke tout l'état dans une base de données SQLite embarquée sous /app/data — il n'y a pas de base de données externe, pas de cache Redis, et pas de secret d'application à gérer.

Ce guide se concentre sur les services cloud qu'Uptime Kuma utilise et sur la façon de les explorer et de les opérer 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 — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


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

L'exécution d'Uptime Kuma sur GKE Autopilot dans votre propre projet Google Cloud coûte environ 53,72 US$/mois en frais Google Cloud (environ 126,72 US$ si ce n'est pas votre seul cluster Autopilot), en plus d'un frais de module RAD unique de 75 crédits (7,50 US$) — plus élevé que le frais du module Cloud Run car cette variante n'exécute pas de volume NFS partagé en plus du pod GKE lui-même. GKE Autopilot convient à Uptime Kuma qui doit fonctionner aux côtés d'autres charges de travail Kubernetes ; pour le coût le plus bas, consultez plutôt le guide Cloud Run. Dans un projet géré par RAD, le frais de module tombe à 67,5 crédits (10 % de moins) — voir Mettez-le en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)75 crédits67,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 buildIdentique
Coût d'exécution Google Cloud53,72 US$/mois, facturé par Google au prix catalogue~77 crédits/jour (environ 2 310/mois, 231 US$ au prix de la recharge), mesuré au prix catalogue plus la marge de RAD

Pourquoi les deux colonnes diffèrent. Le chiffre du projet 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 projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment 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 frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 US$ en recharge unique, et moins sur un plan mensuel.

Coût d'exécution par défaut dans votre propre projet

Ressource (valeur par défaut du module)Par mois
Pod GKE Autopilot, 1x vCPU / 0,5 GiB34,29 US$
Serveur de fichiers NFS/cache (petite VM)13,43 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Total53,72 US$

Les frais de gestion du 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​

  • Uptime Kuma n'a pas de version cloud hébergée officielle — il est distribué uniquement en tant que logiciel auto-hébergé, il n'y a donc pas de plan SaaS de fournisseur à comparer.
  • Une comparaison avec un VPS autogéré, dimensionné pour la configuration par défaut d'Uptime Kuma de 1 vCPU / 0,5 GiB : un Hetzner CPX11 ou un DigitalOcean 1 vCPU/2GB Droplet coûte environ 6-12 $/mois — plus votre propre temps pour les sauvegardes et les correctifs, et aucun plan de contrôle Kubernetes à exécuter.
  • La majeure partie du coût de ce module est le pod GKE Autopilot et sa part des frais de gestion du cluster ; la variante Cloud Run exécute la même charge de travail toujours active pour moins cher.

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 pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la 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, 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 repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce qu'il faut : vous devez être propriétaire du projet (pas 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, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). Google affirme que la plupart des services sont entièrement 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é Uptime Kuma 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 Uptime Kuma signifie redéployer à partir de zéro. Cela coûte environ 78-81 crédits dans votre propre projet, ou environ 70,5-73,5 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Uptime Kuma reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 4 jours ou plus dans votre propre projet (environ 1,79 US$ par jour), ou environ 1 jour ou plus dans un projet géré par RAD (77 crédits par jour).

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, alors copiez la dernière sauvegarde avant de la supprimer si vous souhaitez 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 cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de 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 revendications de pause/restauration.

1. Vue d'ensemble​

Uptime Kuma s'exécute comme une seule charge de travail web Node.js tirée directement de l'image officielle de Docker Hub. Le déploiement relie un ensemble délibérément restreint de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods personnalisés basés sur louislam/uptime-kuma sur le port 3001, 1 vCPU / 512 Mio par défaut
Base de donnéesAucune (SQLite embarquée)database_type = "NONE" — aucune instance Cloud SQL n'est provisionnée
Persistance de fichiersCloud Filestore (NFS)La base de données SQLite et les téléchargements persistent sous /app/data, partagés entre les pods
Stockage d'objetsCloud StorageAucun provisionné par défaut — storage_buckets = []
SecretsSecret ManagerAucun — Uptime Kuma n'a pas de secret d'application ; les identifiants d'administration résident dans sa propre base de données SQLite
IngressCloud Load BalancingLoadBalancer externe avec une IP statique réservée ; domaine personnalisé optionnel + certificat géré

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

  • Pas de base de données externe. database_type = "NONE" est fixé par UptimeKuma_Common ; enable_cloudsql_volume = false et aucun job db-init ne s'exécute. Uptime Kuma crée son schéma SQLite au premier démarrage.
  • NFS est obligatoire pour la persistance. enable_nfs = true, monté à /app/data (le chemin du conteneur est fixe — ne le modifiez pas). Sans le volume NFS, la base de données SQLite et tout l'historique des moniteurs sont éphémères et perdus lors de la recréation du pod. Alternativement, stateful_pvc_enabled = true (désactivé par défaut) déplace le même chemin /app/data sur un PVC de bloc par pod, le support plus solide pour SQLite ; le montage NFS est alors abandonné, car un chemin ne peut pas avoir deux montages de volume.
  • Pas de Redis, pas de secrets d'application. UptimeKuma_Common produit secret_ids = {} ; il n'y a rien à injecter depuis Secret Manager.
  • La build personnalisée corrige SQLite pour la sécurité NFS. container_image_source = "custom" construit une image légère FROM louislam/uptime-kuma:<application_version> (tag par défaut 1, la ligne stable v1/SQLite) via Cloud Build. Uptime Kuma définit inconditionnellement PRAGMA journal_mode = WAL à chaque démarrage (codé en dur dans server/database.js, non configurable via une variable d'environnement) ; WAL repose sur le verrouillage par plage d'octets en mémoire partagée entre le fichier DB et son sidecar -wal, ce que le volume /app/data soutenu par NFS ne fournit pas de manière fiable et a produit des erreurs SQLITE_CORRUPT observées. La build corrige ce PRAGMA en mode DELETE, qui n'a besoin que d'un verrouillage de fichier entier standard que NFS gère correctement. L'image construite est ensuite mise en miroir dans Artifact Registry par défaut (enable_image_mirroring = true) pour éviter les limites de débit de Docker Hub.
  • container_port = 3001 — le port natif d'Uptime Kuma.
  • Réplica unique par défaut et requis. min_instance_count = 1, max_instance_count = 1. SQLite est une base de données à un seul rédacteur ; ne pas dépasser 1 réplica partageant le même fichier de base de données monté sur NFS.
  • tenant_id obtient un suffixe -gke lorsque la variante appelle UptimeKuma_Common, de sorte qu'une variante CloudRun et GKE sur le même tenant_id ne se heurtent pas sur la dénomination commune.
  • La configuration initiale est entièrement intégrée à l'application. Il n'y a pas de compte administrateur par défaut — Uptime Kuma vous invite à en créer un lors du premier accès.

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 Uptime Kuma​

Les pods Uptime Kuma sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. La charge de travail est déployée en tant que Deployment (workload_type par défaut à Deployment ; un StatefulSet fonctionne également avec le volume NFS si sélectionné).

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Uptime Kuma pour les pods, 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" deploy/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

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

B. Cloud Filestore (NFS) — la seule couche de persistance​

Parce qu'Uptime Kuma n'a pas de base de données externe, tout l'état durable — moniteurs, historique des vérifications, configuration des notifications, pages de statut et compte administrateur — réside dans un seul fichier SQLite sur le volume NFS monté à /app/data. Cela fait du montage NFS la ressource la plus importante à protéger pour ce module : le perdre, c'est tout perdre.

  • Console : Filestore → Instances.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    kubectl get pvc -n "$NAMESPACE"
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- ls -la /app/data

Voir App_GKE pour le provisionnement, la découverte et le modèle de VM NFS partagé ou intégré.

C. Cloud Storage​

Aucun bucket GCS n'est provisionné pour Uptime Kuma par défaut (storage_buckets = [] dans UptimeKuma_Common) ; toute la persistance est sur NFS. Définissez create_cloud_storage/storage_buckets explicitement si vous avez besoin d'un bucket pour les sauvegardes exportées ou l'automatisation.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~uptimekuma"

D. Secret Manager​

Uptime Kuma ne nécessite aucun secret d'application — secret_ids = {}. Le mot de passe de la base de données affiché par la Fondation est inutilisé (il n'y a pas d'instance Cloud SQL). Seuls les secrets de niveau Fondation que vous ajoutez explicitement via secret_environment_variables apparaîtront ici.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~uptimekuma"

E. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing (service_type = LoadBalancer, reserve_static_ip = true afin que l'adresse survive aux redéploiements). Un domaine personnalisé avec un certificat géré par Google peut être activé via enable_custom_domain/application_domains.

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

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails des IP statiques. Confirmez également que le chemin de sortie GKE permet au pod d'atteindre tous les points de terminaison externes que vous configurez Uptime Kuma pour surveiller.

F. Cloud Logging et Monitoring​

Les flux stdout/stderr des pods vers Cloud Logging. Des tests de disponibilité Cloud Monitoring optionnels et des politiques d'alerte sont disponibles (uptime_check_config.enabled = false par défaut) — notez qu'il s'agit d'un test de disponibilité Google Cloud sur le service Uptime Kuma lui-même, distinct des moniteurs que vous configurez dans Uptime Kuma.

  • 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 Uptime Kuma​

  • Pas de job d'initialisation. initialization_jobs est vide par défaut — Uptime Kuma crée son schéma SQLite lui-même au premier démarrage sur le volume /app/data vide. Les jobs fournis par l'utilisateur sont toujours honorés s'ils sont fournis.
  • La configuration initiale est manuelle et intégrée à l'application. Lors du premier accès à l'URL du service, Uptime Kuma affiche son assistant de configuration pour créer le compte administrateur initial — il n'y a pas d'identifiants par défaut ou auto-générés à récupérer depuis Secret Manager.
  • Chemin de santé. Les sondes de démarrage et de vivacité par défaut sont toutes deux HTTP GET /api/entry-page sur le port 3001 — / est toujours un 302, que la vérification de santé de la passerelle traite comme non saine (démarrage : délai initial de 30 s, période de 10 s, seuil d'échec 30 ; vivacité : délai initial de 30 s, période de 30 s, seuil d'échec 3). Le test de disponibilité Cloud Monitoring optionnel cible également GET /.
  • SQLite à un seul rédacteur sur NFS. L'exécution de plusieurs réplicas sur le même fichier SQLite /app/data risque une contention ou une corruption du verrouillage de la base de données ; conservez min_instance_count = max_instance_count = 1 sauf si le comportement de verrouillage de fichier du serveur NFS sous des rédacteurs SQLite concurrents a été vérifié séparément.
  • Inspecter la configuration en cours d'exécution et le volume de données :
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -i uptime
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- ls -la /app/data

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

Groupe 2 — Application et identité de la base de données​

VariableValeur par défautDescription
application_nameuptimekumaNom de base des ressources. Ne pas modifier après le premier déploiement.
application_version1Tag d'image louislam/uptime-kuma ; "1" est la ligne stable v1 (SQLite embarquée).

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

VariableValeur par défautDescription
container_image_sourcecustomConstruit une image personnalisée légère via Cloud Build qui corrige le journal_mode codé en dur de SQLite de WAL à DELETE pour la sécurité NFS (voir Vue d'ensemble). Conservez custom.
container_port3001Port natif d'Uptime Kuma.
enable_cloudsql_volumefalseInutilisé — Uptime Kuma n'a pas de base de données externe.
min_instance_count / max_instance_count1 / 1Conservez les deux à 1 — rédacteur SQLite unique.
container_resources{ cpu_limit="1000m", memory_limit="512Mi" }Limites CPU/mémoire par pod.

Groupe 6 — Cluster GKE​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour le tableau de bord Uptime Kuma.
workload_typenull → DeploymentDéploiement ; StatefulSet fonctionne également avec le volume NFS si explicitement sélectionné.
session_affinity(Valeur par défaut de la fondation)Pas de surcharge spécifique à l'application ; Uptime Kuma n'a pas d'état de serveur par session au-delà de la base de données SQLite.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_config{ enabled=true, path="/api/entry-page" } (HTTP, port 3001)Sonde de démarrage.
health_check_config{ enabled=true, path="/api/entry-page" } (HTTP, port 3001)Sonde de vivacité. Doit renvoyer un 200 littéral — elle est mise en miroir dans la vérification de santé de la passerelle.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring sur le service lui-même (pas un moniteur Uptime Kuma).

Groupe 13 — NFS​

VariableValeur par défautDescription
enable_nfstrueObligatoire. Le seul mécanisme de persistance pour la base de données SQLite embarquée.
nfs_mount_path/app/dataFixé par la disposition de stockage de l'application — ne pas modifier.

Groupe 16 — Base de données​

VariableValeur par défautDescription
database_type"NONE"Fixé par UptimeKuma_Common. Aucune instance Cloud SQL n'est provisionnée.

Toutes les autres entrées suivent le comportement standard de App_GKE.


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 intra-cluster.
stage_service_cluster_ipsCarte des ClusterIPs pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Uptime Kuma.
database_instance_name / database_name / database_user / database_password_secret / database_host / database_portPrésent pour la parité de sortie avec d'autres modules ; non significatif pour Uptime Kuma — aucune instance Cloud SQL n'est provisionnée (database_type = "NONE").
storage_bucketsBuckets Cloud Storage créés (vides par défaut).
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_channelsStatut et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs d'initialisation créés (vides par défaut) et job d'importation optionnel.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationStatut et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

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 fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. Une configuration invalide échoue la planification avec une erreur claire et nommée avant que toute ressource ne soit créée, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'au moment de l'application ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence si incorrect
enable_nfstrueCritiqueLe désactiver supprime la seule couche de persistance — la base de données SQLite embarquée (tous les moniteurs, l'historique et le compte administrateur) est éphémère et perdue à chaque recréation de pod.
nfs_mount_path/app/dataCritiqueLe modifier éloigne le chemin de données codé en dur d'Uptime Kuma du volume persistant ; l'application écrit SQLite vers un chemin qui n'est pas réellement le partage NFS monté.
max_instance_count1ÉlevéSQLite est à un seul rédacteur ; l'exécution de plus d'un réplica sur le même fichier de base de données monté sur NFS risque une contention ou une corruption du verrouillage.
database_type"NONE"FaibleUptime Kuma l'ignore — il ne se connecte jamais à Cloud SQL — mais le modifier provisionnera toujours une instance Cloud SQL inutilisée et facturée via la Fondation.
container_port3001ÉlevéUptime Kuma écoute sur le port 3001 ; pointer le service/les sondes vers un autre port rend la charge de travail inaccessible et les sondes échouent.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer lors des redéploiements, ce qui rompt le DNS, les signets et tout intégration de page de statut externe.
Configuration admin initialeTerminer immédiatement après le déploiementMoyenL'assistant de configuration est accessible à quiconque trouve l'URL avant la création d'un compte admin — ne laissez pas une instance fraîchement déployée avec une IP publique non configurée trop longtemps.
backup_retention_days7 (augmenter pour la production)MoyenS'applique aux sauvegardes gérées par la Fondation ; puisque l'état réel d'Uptime Kuma est le fichier SQLite hébergé sur NFS, vérifiez séparément la couverture de sauvegarde NFS/Filestore plutôt que de vous fier uniquement à ce paramètre.
container_image_sourcecustom (par défaut)CritiqueDéfinir "prebuilt" ignore l'étape Cloud Build et déploie l'image amont non corrigée — Uptime Kuma écrit alors SQLite en mode WAL sur NFS, ce qui a produit une corruption de base de données SQLITE_CORRUPT observée.

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 à Uptime Kuma partagée avec la variante Cloud Run est décrite dans UptimeKuma_Common.

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