Aller au contenu principal

Uptime Kuma sur Google Cloud Run

Uptime Kuma sur Google Cloud Run

Uptime Kuma est un outil de surveillance sophistiqué et auto-hébergé pour suivre 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 et plus de 90 canaux de notification. Ce module déploie Uptime Kuma sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud qu'Uptime Kuma utilise et sur la façon 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 Uptime Kuma sur RAD, et comment cela se compare​

L'exécution d'Uptime Kuma sur Cloud Run dans votre propre projet Google Cloud coûte environ 64,16 US$/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 40 crédits (4 US$) facturé une fois au moment du déploiement. Uptime Kuma conserve tout son état dans une base de données SQLite embarquée sur un volume NFS partagé, il n'a donc pas besoin de base de données gérée — mais il s'exécute alwaysOn par défaut (les moniteurs de disponibilité doivent continuer à vérifier même si personne ne regarde le tableau de bord), ce qui représente la majeure partie de son coût de fonctionnement. Dans un projet géré par RAD, les frais de module tombent à 36 crédits (10 % de moins) — voir Mettez-le en pause gratuitement ci-dessous — ou voir le guide GKE si vous préférez l'exécuter sur Kubernetes.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)40 crédits36 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 pour le temps de build à la minuteIdem
Coût de fonctionnement Google Cloud64,16 US$/mois, facturé par Google au prix catalogue~39 crédits/jour (environ 1 170/mois, 117 US$ au prix de la recharge), 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).

10 crédits coûtent 1 US$ pour une recharge unique, et moins pour un forfait mensuel.

Coût de fonctionnement par défaut dans votre propre projet

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 0,5 Gio (alwaysOn)44,72 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$
Total64,16 US$

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 pour ce projet exact.
  • Une comparaison VPS autogérée, dimensionnée aux valeurs par défaut d'Uptime Kuma de 1 vCPU / 0,5 Gio : un Hetzner CPX11 ou un DigitalOcean 1 vCPU/2 Go Droplet coûte environ 6-12 $/mois, moins cher en termes de trésorerie que les deux options RAD ici — plus votre propre temps pour les sauvegardes, la mise à jour du système d'exploitation et le renouvellement TLS, que le Secret Manager et la surveillance gérés par RAD couvrent pour vous.
  • Parce qu'Uptime Kuma n'a pas besoin de base de données gérée, presque tout son coût de fonctionnement ici est le calcul toujours actif lui-même, ce qui en fait également un bon candidat à mettre en pause lorsqu'un environnement surveillé n'est lui-même utilisé qu'occasionnellement (voir ci-dessous).

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

C'est l'avantage principal d'un projet géré par RAD, et cela 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 logique 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 invoqué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 affirme que la plupart des services sont entièrement fonctionnels à nouveau 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 logique 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 le redéployer à partir de zéro. Cela coûte environ 43-46 crédits dans votre propre projet, ou environ 39-42 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 que le coût de redéploiement soit inférieur à son propre coût de fonctionnement — environ 2 jours ou plus dans votre propre projet (environ 2,14 US$ par jour), ou environ 1 jour ou plus dans un projet géré par RAD (39 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, 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, afin que personne ne reçoive 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​

Uptime Kuma s'exécute comme un conteneur Node.js sur Cloud Run v2. C'est l'un des modules les plus simples du catalogue — il n'y a pas de base de données externe, pas de cache et pas de secret d'application. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 1 vCPU / 512 Mio par défaut, CPU toujours alloué
État persistantFilestore (NFS)Base de données SQLite embarquée et téléchargements sous /app/data (gen2 requis)
Image de conteneurArtifact RegistryCloud Build personnalisé (container_image_source = "custom") — une fine couche FROM louislam/uptime-kuma qui corrige le mode journal SQLite pour la sécurité NFS (voir ci-dessous)
Base de données—Aucune — Uptime Kuma v1 utilise SQLite embarqué ; database_type = "NONE"
Cache—Aucun — Redis n'est pas requis (enable_redis = false)
SecretsSecret ManagerPas de secrets d'application (secret_ids = {}) ; les identifiants d'administration résident dans SQLite
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • cpu_always_allocated = true est la valeur par défaut et est délibérée — la boucle de surveillance EST le produit. Uptime Kuma interroge ses moniteurs à partir d'un planificateur intégré sans aucune requête entrante. Avec la facturation basée sur les requêtes de Cloud Run, le CPU est limité à près de zéro entre les requêtes, de sorte que les vérifications seraient bloquées ou déclenchées en retard. Le CPU basé sur l'instance (toujours alloué) maintient le planificateur en fonctionnement à pleine vitesse tant qu'une instance est active. Ne le définissez pas sur false.
  • min_instance_count est par défaut 1, pas 0 — à 0, Cloud Run récupère l'instance environ 15 minutes après la dernière requête, et la surveillance s'arrête lorsqu'elle est mise à l'échelle à zéro. cpu_always_allocated ne couvre pas cela : il régit le CPU tant qu'une instance est active, pas si elle existe. Gardez 1 pour une véritable surveillance 24h/24 et 7j/7.
  • Pas de base de données externe. database_type = "NONE", enable_cloudsql_volume = false, et il n'y a pas de job db-init. Uptime Kuma crée son schéma SQLite embarqué automatiquement au premier démarrage.
  • La persistance NFS est obligatoire. enable_nfs = true avec nfs_mount_path = "/app/data" monte un volume Filestore (NFS) contenant la base de données SQLite et les téléchargements, de sorte que les moniteurs et l'historique survivent aux redémarrages et aux révisions. Nécessite l'environnement d'exécution gen2.
  • SQLite à écrivain unique. SQLite sur NFS repose sur le verrouillage de fichiers ; exécutez une seule instance en production (max_instance_count = 1). La valeur par défaut du module est max_instance_count = 3 pour la marge de manœuvre du tableau de bord — réduisez-la pour la production.
  • La build personnalisée corrige SQLite pour la sécurité NFS. container_image_source = "custom" est la valeur par défaut — ne la changez pas en "prebuilt". 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 de plage d'octets de mémoire partagée entre le fichier DB et son fichier auxiliaire -wal, ce que le volume /app/data basé sur NFS ne fournit pas de manière fiable et a produit des erreurs SQLITE_CORRUPT observées. L'étape Cloud Build (UptimeKuma_Common/scripts/Dockerfile) corrige cette PRAGMA en mode DELETE, qui ne nécessite qu'un verrouillage de fichier entier standard que NFS gère correctement. enable_image_mirroring = true pousse en outre l'image construite via Artifact Registry pour éviter les limites de débit de Docker Hub.
  • Pas de secrets d'application — il n'y a rien à injecter depuis Secret Manager. Le compte administrateur est créé de manière interactive lors du premier accès.

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

A. Cloud Run — le service Uptime Kuma​

Uptime Kuma s'exécute en tant que service Cloud Run v2 avec le CPU toujours alloué afin que son planificateur de vérification en arrière-plan continue d'interroger entre les requêtes. 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. Filestore (NFS) — le volume de données persistant​

Tout l'état d'Uptime Kuma — la base de données SQLite embarquée, l'historique des moniteurs, les téléchargements et les paramètres (y compris l'utilisateur administrateur) — réside sous /app/data, que le module monte à partir d'un partage Filestore (NFS). Sans cela, tout est perdu au redémarrage. L'environnement d'exécution gen2 est requis pour les montages NFS.

  • Console : Filestore → Instances.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION" \
    --format="yaml(spec.template.spec.volumes)"

Voir App_CloudRun pour le modèle de montage NFS et CMEK.

C. Artifact Registry — l'image mise en miroir​

Avec container_image_source = "custom" (la valeur par défaut), une étape Cloud Build construit une image personnalisée légère FROM louislam/uptime-kuma, appliquant un correctif source qui modifie le journal_mode SQLite codé en dur de WAL à DELETE — le verrouillage de mémoire partagée de WAL est dangereux sur le volume /app/data basé sur NFS (voir Vue d'ensemble). Avec enable_image_mirroring = true (la valeur par défaut), l'image construite est ensuite poussée vers l'Artifact Registry du projet, isolant les déploiements des limites de débit et des pannes de Docker Hub.

  • Console : Artifact Registry → Dépôts.
  • CLI :
    gcloud artifacts repositories list --project "$PROJECT" --location "$REGION"
    gcloud artifacts docker images list <region>-docker.pkg.dev/$PROJECT/<repo>

D. Réseau et ingress​

Le service est accessible à 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 de sortie VPC contrôlent la connectivité. Notez qu'Uptime Kuma établit également des connexions sortantes — chaque vérification de moniteur est un appel de sortie du conteneur.

  • 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 envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des stratégies d'alerte facultatifs. Oui — vous pouvez pointer un test de disponibilité Google Cloud vers votre instance Uptime Kuma pour surveiller le moniteur.

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

  • Pas de jobs d'initialisation. Uptime Kuma crée son schéma SQLite embarqué automatiquement au premier démarrage ; il n'y a pas de job db-init ou de migration, et initialization_jobs est par défaut [].
  • Configuration initiale. Lors du premier accès, Uptime Kuma présente une page de configuration vous demandant de créer le compte administrateur — il n'y a pas d'identifiants par défaut intégrés à l'image. Le compte est stocké dans SQLite sur le volume NFS, il persiste donc entre les révisions.
  • Le planificateur de vérification s'exécute en interne. L'interrogation des moniteurs, les tentatives et l'envoi des notifications s'exécutent tous dans le processus Node.js, pilotés par des temporisateurs — et non par des requêtes HTTP entrantes. C'est pourquoi cpu_always_allocated = true est la valeur par défaut et pourquoi la surveillance continue nécessite en outre qu'une instance soit en cours d'exécution (min_instance_count = 1).
  • La mise à l'échelle à zéro interrompt la surveillance. Si vous réduisez min_instance_count à 0, Cloud Run arrête la dernière instance lorsqu'elle devient inactive. Lorsqu'elle est mise à l'échelle à zéro, aucune vérification ne s'exécute et aucune alerte ne se déclenche ; l'interrogation reprend lorsque la prochaine requête (par exemple, l'ouverture du tableau de bord) démarre à froid une instance. C'est sûr pour une utilisation occasionnelle/en laboratoire mais incorrect pour la surveillance en production.
  • SQLite à écrivain unique. SQLite est une base de données à écrivain unique. Plusieurs instances concurrentes écrivant le même fichier SQLite sur NFS risquent des conflits de verrouillage ou une corruption — maintenez max_instance_count = 1 en production.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent / sur le port 3001, qui renvoie HTTP 200 une fois l'application démarrée. La sonde de démarrage autorise jusqu'à 30 s de délai initial plus 30 échecs à intervalles de 10 s.
  • Vérification :
    SERVICE=$(gcloud run services list --project "$PROJECT" --region "$REGION" \
    --filter="metadata.name~uptimekuma" --format="value(metadata.name)" --limit=1)
    SERVICE_URL=$(gcloud run services describe "$SERVICE" \
    --project "$PROJECT" --region "$REGION" --format="value(status.url)")
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/"

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_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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 autorisés à accéder au projet et aux alertes de surveillance.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameuptimekumaNom de base des ressources. Ne pas modifier après le premier déploiement.
application_version1Tag de l'image Uptime Kuma — la ligne stable v1 (SQLite embarqué).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 4 — 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_imagelouislam/uptime-kumaImage officielle en amont, mise en miroir dans Artifact Registry.
enable_image_mirroringtrueCopiez l'image dans Artifact Registry pour éviter les limites de débit de Docker Hub.
cpu_limit / memory_limit1000m / 512MiAmplement suffisant pour des dizaines de moniteurs ; augmentez la mémoire pour un très grand nombre de moniteurs.
min_instance_count1Conservez 1 pour une surveillance 24h/24 et 7j/7 — lorsqu'il est mis à l'échelle à zéro, aucune vérification ne s'exécute.
max_instance_count1Conservez à 1 — SQLite est à écrivain unique, donc une deuxième instance corrompt la base de données (voir Pièges).
cpu_always_allocatedtrueConservez true. Le planificateur de vérification intégré a besoin de CPU entre les requêtes ; la facturation basée sur les requêtes le limite à ~0 et les vérifications sont bloquées.
container_port3001Port natif d'Uptime Kuma.
execution_environmentgen2Requis pour le montage NFS.
enable_cloudsql_volumefalseInutilisé — pas de base de données externe.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallLes pages de statut publiques nécessitent un ingress public ; utilisez IAP/internal pour les tableaux de bord privés.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer le trafic de plage privée via le VPC (nécessaire pour surveiller les cibles internes). Définissez ALL_TRAFFIC pour acheminer toutes les sondes de moniteur via le VPC (par exemple pour une IP de sortie NAT stable ou si les sondes publiques échouent).
enable_iapfalsePlacez le tableau de bord derrière l'identité Google s'il ne doit pas être public.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueRequis. Provisionne le partage Filestore contenant tout l'état d'Uptime Kuma.
nfs_mount_path/app/dataDoit rester /app/data — le répertoire de données inscriptible d'Uptime Kuma.
storage_buckets / gcs_volumes[]Non nécessaire — aucun stockage GCS n'est utilisé.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixé par conception — Uptime Kuma v1 utilise SQLite embarqué ; aucun Cloud SQL n'est provisionné.
application_database_name / application_database_useruptimekumaDéclaré pour la mise en miroir de convention ; inutilisé.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

VariableValeur par défautDescription
initialization_jobs[]Aucun nécessaire — le schéma SQLite est créé au premier démarrage.
cron_jobs[]Jobs Cloud Run récurrents déclenchés par Cloud Scheduler.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /, 30 s de délai, 30 échecsTransmis via UptimeKuma_Common.
liveness_probeHTTP /, 30 s de délai, 3 échecsTransmis via UptimeKuma_Common.
uptime_check_configenabled = falseTest de disponibilité Cloud Monitoring facultatif contre / — surveillance du moniteur.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 16 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseUptime Kuma n'utilise pas Redis ; laissez désactivé.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

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

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.


5. Sorties​

Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_name / database_name / database_user / database_password_secret / database_host / database_portVide/non défini — aucun Cloud SQL n'est provisionné (database_type = "NONE").
storage_bucketsBuckets Cloud Storage créés (aucun par défaut).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (vide par défaut).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / cicd_configuration / cloudbuild_trigger_name / cloudbuild_trigger_id / artifact_registry_repositoryStatut CI/CD, déclencheur de build et détails du registre.
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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
cpu_always_allocatedtrue (par défaut)CritiqueLa facturation basée sur les requêtes limite le CPU à ~0 entre les requêtes — le planificateur de vérification intégré se bloque, les vérifications se déclenchent en retard ou pas du tout, et les alertes sont manquées. La boucle de surveillance EST le produit.
enable_nfstrue (par défaut)CritiqueSans le volume NFS, la base de données SQLite (moniteurs, historique, compte administrateur) réside sur un disque éphémère et est effacée à chaque redémarrage ou nouvelle révision.
nfs_mount_path/app/data (par défaut)CritiqueTout autre chemin laisse Uptime Kuma écrire sur un stockage éphémère — perte totale et silencieuse de données au redémarrage.
min_instance_count1 (par défaut)CritiqueÀ 0, le service se met à l'échelle à zéro lorsqu'il est inactif et aucune vérification ne s'exécute pendant qu'il est arrêté — les pannes des systèmes surveillés passent inaperçues.
max_instance_count1 pour la productionÉlevéSQLite est à écrivain unique ; plusieurs instances écrivant sur NFS risquent des conflits de verrouillage ou une corruption de la base de données.
container_port3001 (par défaut)CritiqueUn port natif d'Uptime Kuma non concordant fait échouer toutes les sondes de santé et la révision ne devient jamais prête.
database_typeNONE (par défaut)ÉlevéLe provisionnement de Cloud SQL gaspille de l'argent — Uptime Kuma v1 ne peut pas l'utiliser.
execution_environmentgen2 (par défaut)ÉlevéLes montages NFS nécessitent gen2 ; gen1 ne peut pas monter Filestore.
vpc_egress_settingpar portée cibleMoyenPRIVATE_RANGES_ONLY achemine uniquement les sondes de plage privée via le VPC ; définissez ALL_TRAFFIC si les sondes de moniteur vers des cibles externes nécessitent une sortie VPC/NAT.
enable_iap / ingress_settingsIAP ou internal pour les tableaux de bord privésMoyenLe tableau de bord (et la page de configuration, lors du premier déploiement) est autrement accessible publiquement à l'URL run.app. Terminez la configuration d'administration initiale immédiatement après le déploiement.
enable_image_mirroringtrue (par défaut)FaibleLes extractions directes de Docker Hub peuvent atteindre les limites de débit et interrompre les déploiements.
container_image_sourcecustom (par défaut)CritiqueLa définition de "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 — 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 à Uptime Kuma partagée avec la variante GKE 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.