Aller au contenu principal

Trilium sur Google Cloud Run

Trilium sur Google Cloud Run

Trilium Notes (le fork TriliumNext activement maintenu — pas le projet archivé zadam/trilium) est une application de prise de notes hiérarchique, auto-hébergée et open source avec une base de données SQLite embarquée. Ce module déploie Trilium sur Cloud Run v2 sur la base App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Trilium et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte Trilium sur RAD, et comparaison​

L'exécution de Trilium sur Cloud Run dans votre propre projet Google Cloud coûte environ 32,57 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. Trilium 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 séparée — son coût d'exécution est proche du plancher de ce que coûte tout déploiement Cloud Run avec stockage persistant. 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 au temps de build à la minuteIdentique
Coût d'exécution Google Cloud32,57 US$/mois, facturé par Google au prix catalogue~23 crédits/jour (environ 690/mois, 69 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 avec un plan mensuel.

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

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 GiB (à chaud)13,14 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$
Total32,57 US$

Comparaison​

  • Trilium (le fork TriliumNext) 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 auto-gérée, dimensionnée à la valeur par défaut de Trilium de 1 vCPU / 1 GiB : un Hetzner CPX11 ou DigitalOcean 1 vCPU/2GB 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 géré par RAD et la surveillance couvrent pour vous.
  • Parce que Trilium n'a pas besoin de base de données gérée, l'écart entre RAD et un VPS nu est principalement le volume NFS, le réseau et la possibilité de le mettre en pause gratuitement dans un projet géré par RAD (voir ci-dessous) — pas l'administration de la base de données.

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 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 logique récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démantèle 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 pour lequel 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 que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont entièrement fonctionnels dans les 36 heures suivant une restauration.

Un véritable écart : 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é Trilium 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 Trilium 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 Trilium reste inutilisé assez 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,09 US$ par jour), ou environ 2 jours ou plus dans un projet géré par RAD (23 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, 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 frais propres à 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​

Trilium s'exécute comme un seul conteneur Node.js/Express sur Cloud Run v2. Le déploiement relie un ensemble délibérément restreint de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 1 vCPU / 1 GiB par défaut, autoscaling sans serveur — mais voir les notes de mise à l'échelle ci-dessous
Base de donnéesAucune (SQLite embarquée)L'intégralité du stockage de documents de Trilium est un seul fichier SQLite, document.db, sur le volume persistant
Répertoire de donnéesCloud Filestore (NFS)/home/node/trilium-data est sur le volume NFS partagé par défaut ; un bucket GCS FUSE y est monté uniquement si NFS est désactivé
SecretsSecret ManagerAucun généré — Trilium n'a pas de credential piloté par variable d'environnement
IngressURL Cloud RunURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • Pas de moteur de base de données à gérer. database_type = "NONE" — il n'y a pas d'instance Cloud SQL, pas de chaîne de connexion, et rien à sauvegarder séparément du bucket de données.
  • Instance unique uniquement. min_instance_count = max_instance_count = 1. La base de données SQLite embarquée de Trilium ne prend pas en charge l'écriture multi-utilisateurs — l'exécution de plusieurs instances risque de corrompre la base de données en raison d'écritures concurrentes.
  • Pas de credential pré-initialisé. Contrairement aux applications avec un mot de passe sauvegardé par Secret Manager, Trilium n'a pas de démarrage d'authentification piloté par variable d'environnement. Lors de la première visite, l'application elle-même présente un écran "Définir le mot de passe" ; complétez-le avant de partager l'URL.
  • La sonde de santé est /api/health-check, pas /. Le chemin racine (/) renvoie une redirection 302 vers l'écran de configuration/connexion. Seul /api/health-check renvoie un 200 {"status":"ok"} non authentifié — confirmé en direct via des tests de conteneur locaux.
  • Le répertoire de données est tout. /home/node/trilium-data contient la base de données SQLite, toutes les pièces jointes, l'historique des révisions et les paramètres. La perte de ce volume entraîne la perte de tout. Il se trouve sur le volume NFS par défaut (enable_nfs = true, nfs_mount_path = /home/node/trilium-data). Gardez-le là : Trilium exécute SQLite en mode WAL, qui nécessite un verrouillage de mémoire partagée que GCS FUSE ne peut pas fournir, donc sur GCS FUSE les écritures récentes sont silencieusement perdues lorsque le conteneur est remplacé.
  • mount_options défini uid=1000,gid=1000 sur le fallback GCS FUSE. Le conteneur de Trilium s'exécute en tant qu'utilisateur node ; sans options de montage correspondantes, GCS FUSE monte le répertoire en tant que root et l'application ne démarre pas.

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

A. Cloud Run — le service Trilium​

Trilium s'exécute comme un seul service Cloud Run v2. Comme il doit rester à une seule instance, il n'y a pas d'autoscaling significatif à observer — le signal intéressant est la santé de la révision et le comportement au démarrage à froid.

  • 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. Le répertoire de données Trilium​

L'état complet de l'application (base de données SQLite document.db, pièces jointes, historique des révisions, paramètres) se trouve dans /home/node/trilium-data, qui est le chemin de montage NFS par défaut. Un bucket Cloud Storage dédié est également provisionné ; il est monté à ce chemin via GCS FUSE uniquement lorsque enable_nfs = false ou nfs_mount_path pointe ailleurs, de sorte que le répertoire a toujours un seul propriétaire. Évitez ce repli — GCS FUSE ne peut pas contenir une base de données SQLite en mode WAL en toute sécurité.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour les options de montage GCS Fuse et CMEK.

C. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être superposé.

  • 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)'

Voir App_CloudRun.

D. Cloud Logging et Monitoring​

Les journaux de conteneur sont acheminés vers Cloud Logging ; les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte optionnels.

  • 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 Trilium​

  • Pas de job de configuration de base de données au premier déploiement. Trilium crée et migre son propre schéma SQLite lors de la première visite web, via son propre assistant de configuration — il n'y a pas de job db-init géré par Terraform à inspecter.
  • Écran "Définir le mot de passe" lors de la première exécution. La navigation vers l'URL racine pour la première fois présente un formulaire de configuration de mot de passe (pas d'administrateur/nom d'utilisateur par défaut — Trilium est une application mono-utilisateur). Il n'y a pas de credential pré-initialisé dans Secret Manager à rechercher.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /api/health-check, qui renvoie 200 {"status":"ok"} une fois que le serveur HTTP écoute — indépendamment du fait que la base de données SQLite ait été initialisée (cela ne se produit qu'après que l'opérateur ait terminé l'étape "Définir le mot de passe").
  • Contrainte d'écriture unique. Ne jamais augmenter max_instance_count au-dessus de 1 — la base de données SQLite embarquée n'est pas sûre pour les écritures concurrentes de plusieurs instances.
  • Inspecter la révision en cours d'exécution :
    gcloud run services describe <service-name> \
    --region "$REGION" --project "$PROJECT" \
    --format='value(status.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 Trilium sont listés ; toute autre entrée est héritée 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.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nametriliumNom de base pour les ressources. Ne pas modifier après le premier déploiement.
application_display_nameTrilium NotesNom lisible par l'homme affiché dans la console.
application_versionlatestTag de version de l'image Docker ; mappé en interne à un ARG de build épinglé (TRILIUM_VERSION), non transmis en tant que latest au Dockerfile.
enable_passwordfalseRéservé pour la parité avec d'autres modules d'éditeur mono-utilisateur. Aucun effet — Trilium n'a pas de démarrage de mot de passe piloté par variable d'environnement.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance.
memory_limit1GiMémoire par instance ; Trilium est léger, n'augmentez que pour de très grandes collections de notes.
min_instance_count / max_instance_count1 / 1Maintenez les deux à 1 — pas de support multi-écriture sur la base de données SQLite embarquée.
container_port8080Port HTTP par défaut de Trilium.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
enable_image_mirroringtrueMettre en miroir l'image Trilium dans Artifact Registry.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallPublic par défaut ; restreindre à internal pour un déploiement privé.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google devant Trilium.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer le bucket de données Trilium.
gcs_volumes[]Volumes GCS Fuse supplémentaires au-delà du bucket de données auto-monté.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONENon référencé — Trilium n'a pas de base de données SQL (SQLite embarquée uniquement).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/health-check, délai de 15sSonde de démarrage.
liveness_probeHTTP /api/health-check, délai de 30sSonde de vivacité.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring optionnel sur /api/health-check.

5. Sorties​

SortieDescription
service_nameNom du service Cloud Run.
trilium_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés.
container_image / container_registryImage déployée et dépôt Artifact Registry.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.

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 en cas d'erreur
max_instance_count1CritiqueL'augmenter risque de corrompre la base de données SQLite embarquée par des écritures concurrentes — il n'y a pas de protection au niveau de la couche de requête contre cela.
enable_nfs / nfs_mount_pathtrue / /home/node/trilium-data (les valeurs par défaut)CritiqueDésactiver NFS ou déplacer le montage place document.db sur GCS FUSE, où les écritures WAL sont silencieusement perdues lors du remplacement du conteneur.
Bucket de données / gcs_volumes mount_options (fallback GCS FUSE uniquement)uid=1000,gid=1000CritiqueUn uid/gid incorrect monte le répertoire de données en tant que root ; le processus Trilium non-root ne démarre pas avec une erreur de permission.
Étape "Définir le mot de passe" lors de la première visiteTerminer immédiatementCritiqueUne instance Trilium sans mot de passe laissée sur une URL publique est accessible par n'importe qui tant que le mot de passe n'est pas défini.
startup_probe / liveness_probe chemin/api/health-checkÉlevéPointer les sondes vers / entraîne une redirection 302, que la plupart des vérifications de santé HTTP traitent comme un échec, empêchant la révision de devenir prête.
ingress_settingsinternal pour usage privéMoyenall (par défaut) rend l'instance (initialement non authentifiée, avant la définition du mot de passe) accessible depuis l'internet public.
memory_limit1GiFaibleTrilium est léger ; n'augmentez que pour de très grandes collections de notes/pièces jointes.

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 à Trilium partagée avec la variante GKE est décrite dans Trilium_Common.

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