Trilium sur GKE Autopilot
Trilium Notes (le fork TriliumNext activement maintenu — pas le
zadam/trilium archivé) est une application de prise de notes open source,
hiérarchique et auto-hébergée avec une base de données SQLite intégrée. Ce
module déploie Trilium 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 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 à 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.
Coût de Trilium sur RAD et comparaison
L'exécution de Trilium sur GKE Autopilot dans votre propre projet Google Cloud coûte environ 42,08 US$/mois en frais Google Cloud (environ 115,08 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$) facturé une fois au moment du déploiement — plus élevé que les frais du module Cloud Run car cette variante n'exécute pas de volume NFS partagé et repose plutôt sur le stockage propre au pod. GKE Autopilot convient à Trilium qui doit rester actif ou 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, les frais de module tombent à 67,5 crédits (10 % de moins) — voir Mettre en pause gratuitement ci-dessous.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module (unique) | 75 crédits | 67,5 crédits (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | 42,08 US$/mois, facturé par Google au prix catalogue | ~75 crédits/jour (environ 2 250/mois, 225 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 propre projet 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 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 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 / 1 Gio | 36,08 US$ |
| Cloud NAT et réseau | 5 US$ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 US$ |
| Total | 42,08 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.
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 selon les valeurs par défaut de Trilium (1 vCPU / 1 Gio) : un Hetzner CPX11 ou un DigitalOcean Droplet 1 vCPU/2 Go 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.
- La majeure partie du coût de ce module est le pod GKE Autopilot lui-même et sa part des frais de gestion du cluster ; la variante Cloud Run plus légère évite les deux.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin
C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien lorsqu'il est en pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la propre suppression logicielle récupérable de Google pendant 30 jours. 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 — il s'agit d'une vérification, pas d'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 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 de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé 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.
Payer uniquement pendant l'utilisation, 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 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 Trilium 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 dans votre propre projet (environ 1,40 US$ par jour), ou environ 1 jour ou plus dans un projet géré par RAD (75 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 supprimer si vous voulez la conserver.
Sessions de lab et environnements gérés
Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.
Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration.
1. Vue d'ensemble
Trilium s'exécute en tant que pod Node.js/Express unique sur GKE Autopilot. Le déploiement relie un ensemble délibérément restreint de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod Node.js, 1 vCPU / 1 Gio par défaut — mais voir les notes de mise à l'échelle ci-dessous |
| Base de données | Aucune (SQLite intégré) | L'intégralité du magasin de documents de Trilium est un seul fichier SQLite, document.db, sur le volume persistant |
| Stockage persistant | PVC de bloc (par défaut) | PVC StatefulSet à /home/node/trilium-data ; définissez stateful_pvc_enabled = false pour revenir à un volume GCS FUSE |
| Secrets | Secret Manager | Aucun généré — Trilium n'a pas de credential piloté par variable d'environnement |
| Ingress | Cloud Load Balancing | LoadBalancer externe par défaut (Trilium est une interface utilisateur web accessible par navigateur) |
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 volume de données. - Réplica unique uniquement.
min_instance_count = max_instance_count = 1. La base de données SQLite intégrée de Trilium ne prend pas en charge l'écriture multi-utilisateurs — l'exécution de plusieurs pods risque de corrompre la base de données en raison d'écritures concurrentes. service_type = "LoadBalancer"par défaut. Trilium est une interface utilisateur web accessible par navigateur, il est donc exposé en externe dès le départ (contrairement aux charges de travail de type base de données, qui sont par défautClusterIP).- Pas de credential pré-rempli. Trilium n'a pas de bootstrap 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-checkrenvoie un200 {"status":"ok"}non authentifié — confirmé en direct via des tests de conteneur locaux. - PVC de bloc par défaut.
stateful_pvc_enabled = true(la valeur par défaut) maintient le fichier SQLite intégré, qui s'exécute en mode WAL, hors de GCS FUSE — SQLite ne prend pas en charge WAL sur un système de fichiers réseau. La valeur par défautstateful_pvc_storage_classest"standard"(HDDpd-standard) — Trilium n'a pas besoin d'IOPS SSD, et le HDD utilise le quotaDISKS_TOTAL_GBbeaucoup plus important au lieu du quotaSSD_TOTAL_GBrestreint. fsGroup/mount_optionsdéfini à 1000. Le conteneur de Trilium s'exécute en tant qu'utilisateurnode, uid/gid 1000 (confirmé viadocker run ... id node) ; sans correspondance de propriété, le volume est monté en tant que root et l'application ne démarre pas.
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 Trilium
Trilium s'exécute en tant que pod unique (un StatefulSet par défaut, car
stateful_pvc_enabled = true ; un déploiement si vous désactivez le PVC). Comme il doit rester à
exactement un réplica, il n'y a pas d'autoscaling horizontal significatif à
observer.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Trilium pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'adresse IP externe.
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
Voir App_GKE pour la mise à l'échelle d'Autopilot et le type de charge de travail (Déploiement vs StatefulSet).
B. Cloud Storage / PVC de bloc — le répertoire de données Trilium
L'état complet de l'application (SQLite document.db, pièces jointes, historique des
révisions, paramètres) se trouve sous /home/node/trilium-data, sur un PVC de bloc StatefulSet
par défaut (stateful_pvc_enabled = true), ou sur un volume GCS FUSE si le PVC est désactivé.
- Console : Cloud Storage → Buckets (mode GCS FUSE) ; Kubernetes Engine → Stockage (mode PVC).
- CLI :
gcloud storage buckets list --project "$PROJECT" # GCS FUSE mode
kubectl get pvc -n "$NAMESPACE" # PVC mode
Voir App_GKE pour les options CMEK et les montages GCS Fuse.
C. Réseau et ingress
Par défaut, la charge de travail est exposée via une adresse IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une adresse 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 détails sur les domaines personnalisés et les adresses IP statiques.
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 facultatifs 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 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-initgéré par Terraform à inspecter. - Écran "Définir le mot de passe" lors de la première exécution. Naviguer 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é-rempli dans Secret Manager à rechercher.
- Chemin de santé. Les sondes de démarrage et de vivacité ciblent
/api/health-check, qui renvoie200 {"status":"ok"}une fois que le serveur HTTP écoute. - Contrainte d'écriture unique. Ne jamais augmenter
max_instance_countau-dessus de1— la base de données SQLite intégrée n'est pas sûre pour les écritures concurrentes de plusieurs pods. - Compromis PVC vs GCS FUSE. Le PVC de bloc (par défaut) offre un véritable verrouillage de fichiers POSIX et le mappage de mémoire partagée dont le mode WAL de SQLite a besoin, au prix de la consommation de quota de disque régional (atténué ici en utilisant par défaut le HDD, pas le SSD). GCS FUSE n'a pas besoin de quota de disque mais n'est pas un système de fichiers pris en charge pour SQLite WAL.
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 ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | trilium | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag de version de l'image Docker ; mappé en interne à un ARG de build épinglé (TRILIUM_VERSION). |
enable_password | false | Réservé pour la parité avec d'autres modules d'éditeur mono-utilisateur. Aucun effet — Trilium n'a pas de bootstrap de mot de passe piloté par variable d'environnement. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
cpu_limit | 1000m | CPU par pod. |
memory_limit | 1Gi | Mémoire par pod ; Trilium est léger, n'augmentez que pour de très grandes collections de notes. |
min_instance_count / max_instance_count | 1 / 1 | Maintenez les deux à 1 — pas de support multi-écriture sur la base de données SQLite intégrée. |
enable_image_mirroring | true | Mettre en miroir l'image Trilium dans Artifact Registry avant le déploiement. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Trilium est une interface utilisateur web accessible par navigateur, exposée en externe par défaut. |
workload_type | null | Se résout automatiquement en StatefulSet lorsque stateful_pvc_enabled = true, sinon Deployment. |
Groupe 7 — StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | true | Conservez true — véritable verrouillage de fichiers POSIX et prise en charge WAL pour le document SQLite.db. |
stateful_pvc_size | 20Gi | Taille du PVC par pod. |
stateful_pvc_mount_path | /home/node/trilium-data | Chemin de montage du conteneur. |
stateful_pvc_storage_class | standard | HDD par défaut — pas besoin d'IOPS SSD ; maintient les déploiements hors du quota SSD_TOTAL_GB restreint. |
stateful_fs_group | 1000 | Correspond à l'uid/gid de Trilium (l'utilisateur node). |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Non référencé — Trilium n'a pas de base de données SQL (SQLite intégré uniquement). |
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /api/health-check, délai de 15s | Sonde de démarrage. |
liveness_probe | HTTP /api/health-check, délai de 30s | Sonde de vivacité. |
uptime_check_config | désactivé | Test de disponibilité Cloud Monitoring facultatif sur /api/health-check. |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
reserve_static_ip | true | IP externe stable sur les redéploiements. |
5. Sorties
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre Trilium. |
storage_buckets | Buckets Cloud Storage créés. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. |
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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
max_instance_count | 1 | Critique | L'augmenter risque de corrompre la base de données SQLite intégrée par des écritures concurrentes. |
stateful_fs_group / GCS mount_options | 1000 | Critique | Un uid/gid incorrect monte le répertoire de données en tant que root ; le processus Trilium non-root ne démarre pas. |
| Étape "Définir le mot de passe" à la première visite | Compléter immédiatement | Critique | Une instance Trilium sans mot de passe défini sur une IP de LoadBalancer publique est accessible par n'importe qui tant que le mot de passe n'est pas défini. |
startup_probe / chemin liveness_probe | /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 le pod de devenir jamais Prêt. |
stateful_pvc_storage_class | standard (HDD) | Moyen | standard-rwo (SSD) utilise inutilement le quota SSD_TOTAL_GB restreint pour une charge de travail sans besoin d'IOPS. |
service_type | LoadBalancer pour une utilisation normale | Moyen | Définir ClusterIP rend l'interface utilisateur de prise de notes inaccessible depuis un navigateur sans un port-forward. |
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 à Trilium partagée avec la variante Cloud Run est décrite dans Trilium_Common.
Guides associés
- Lab pratique : Trilium sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Trilium sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- Trilium Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.