Ghostfolio sur GKE Autopilot
Ghostfolio est une application open source de gestion de patrimoine, sous licence AGPL, permettant de suivre la valeur nette, les portefeuilles d'investissement et l'allocation d'actifs sur plusieurs comptes de courtage et plateformes — une alternative axée sur la confidentialité aux trackers de portefeuille commerciaux. Ce module déploie Ghostfolio 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 Ghostfolio et sur la manière de les explorer et de les opérer depuis la Google Cloud Console et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_GKE plutôt que de les répéter ici.
Ce que coûte Ghostfolio sur RAD, et comment cela se compare
L'exécution de Ghostfolio dans votre propre projet Google Cloud coûte environ 106,53 $ US/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 110 crédits (99 crédits — 10 % de moins — dans un projet géré par RAD). Ghostfolio est une application open source de gestion de patrimoine pour le suivi de la valeur nette, des portefeuilles d'investissement et de l'allocation d'actifs sur plusieurs comptes et plateformes. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et le reprendre plus tard — voir "Mettre en pause gratuitement" ci-dessous.
Ghostfolio est également disponible sur Cloud Run — voir le guide Cloud Run pour l'option à moindre coût ; ce guide couvre la variante GKE.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 110 crédits (une seule fois) | 99 crédits (une seule fois, 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 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 | Identique |
| Coût d'exécution Google Cloud | ~106,53 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue | ~122 crédits/jour (~12,20 $ US/jour), mesuré à l'heure 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).
Coût d'exécution par défaut dans votre propre projet
| Ressource | $ US/mois (prix catalogue Google, us-central1) |
|---|---|
| Pod GKE Autopilot, 1x vCPU / 1 GiB | 36,08 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion de cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 |
| Total | 106,53 $ US |
Comment cela se compare
- Il n'existe pas de version officielle hébergée/cloud de Ghostfolio à comparer, la comparaison honnête se fait donc avec une infrastructure autogérée, et non avec un SaaS concurrent.
- Un VPS nu dimensionné à environ 1 vCPU / 1 GiB — un Hetzner CPX22 (2 vCPU/4 Go, ~24 $ US/mois), un DigitalOcean 2 vCPU/4 Go Droplet (24 $ US/mois), ou le propre Compute Engine e2-standard-2 de GCP (2 vCPU/8 Go, ~49 $ US/mois) — est généralement moins cher que le prix affiché par RAD ; un VPS d'une ou deux tailles inférieures le serait encore plus.
- Ce prix inférieur n'inclut pas le temps de l'administrateur : patcher l'OS, faire tourner les sauvegardes de base de données, renouveler les certificats TLS et surveiller les temps d'arrêt. Cloud SQL géré par RAD, Secret Manager et la surveillance le font pour vous, ce qui est le véritable compromis, et non le prix affiché.
- RAD ne prétend pas être moins cher qu'un VPS nu en termes d'argent — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin
Si Ghostfolio est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la propre suppression logicielle récupérable de Google pendant 30 jours. Contrairement à la suppression du module Ghostfolio seul, cela ne supprime 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 utilisée comme 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. Les frais de module de 99 crédits ne sont pas facturés à nouveau.
Ce qu'il faut pour cela : 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, 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 qui convient à la plupart des utilisations d'étude/démo). 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é Ghostfolio 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
Si Ghostfolio se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.
Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 110 crédits (11,00 $ US) dans votre propre projet, ou 99 crédits sur un projet géré par RAD.
La suppression ne permet d'économiser de l'argent que si Ghostfolio 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 d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 106,53 $ US/mois), ou environ 2 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~122 crédits/jour).
La majeure partie du coût d'exécution de Ghostfolio est la base de données et la VM de fichier/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la part de calcul propre à cette application du total ci-dessus.
Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, 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 dispose de 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 mécanismes de pause/restauration.
1. Vue d'ensemble
Ghostfolio s'exécute comme une charge de travail web NestJS (Prisma ORM). Le déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | API NestJS + frontend Angular, 1 vCPU / 1 GiB par défaut, autoscalé horizontalement |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — l'ORM Prisma de Ghostfolio ne prend pas en charge MySQL |
| Cache et file d'attente | Redis (requis, non optionnel) | Mise en cache des données de marché, sessions et gestion des files d'attente/jobs Bull |
| Secrets | Secret Manager | ACCESS_TOKEN_SALT et JWT_SECRET_KEY auto-générés ; mot de passe de la base de données |
| Ingress | Cloud Load Balancing | Service LoadBalancer externe par défaut ; domaine personnalisé optionnel + certificat géré |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; l'ORM Prisma de Ghostfolio ne prend pas en charge d'autres moteurs.
- Redis est obligatoire, non optionnel. Le point de terminaison de santé de Ghostfolio vérifie directement la connectivité Redis, de sorte que l'application ne signale jamais un état sain sans elle.
ACCESS_TOKEN_SALTetJWT_SECRET_KEYsont générés automatiquement et stockés dans Secret Manager. Les deux bloquent le démarrage. La rotation deACCESS_TOKEN_SALTaprès le premier démarrage invalide chaque jeton de sécurité anonyme précédemment émis.- Pas de compte administrateur pré-rempli. Le premier visiteur de l'URL déployée clique sur "Get Started" et l'application crée un jeton de sécurité aléatoire en tant que propriétaire du compte — il n'y a pas de formulaire email/mot de passe ou d'assistant de première exécution à compléter.
service_type = "LoadBalancer"par défaut. Ghostfolio est une interface utilisateur web orientée navigateur, donc contrairement aux applications internes uniquement (bases de données, outils d'administration), elle a besoin d'un service accessible publiquement.- Aucun stockage de fichiers/médias en masse n'est provisionné.
enable_nfspar défautfalseetstorage_bucketsest toujours vide. DATABASE_URLest composé à l'exécution. La chaîne de connexion Prisma de Ghostfolio est un DSN d'autorité d'URL ; sur GKE, le point d'entrée cloud utilise la boucle de rappel127.0.0.1du sidecar cloud-sql-proxy avecsslmode=disablelorsqueenable_cloudsql_volume = true(par défaut).
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. Les noms de ressources sont
rapportés dans les Sorties du déploiement.
A. GKE Autopilot — la charge de travail Ghostfolio
Ghostfolio s'exécute comme un déploiement Kubernetes derrière un service. Autopilot gère automatiquement le provisionnement des nœuds et le bin-packing.
- Console : Kubernetes Engine → Workloads → sélectionnez le déploiement.
- CLI :
kubectl get deployment -n "$NAMESPACE"
kubectl get pods -n "$NAMESPACE" -o wide
kubectl describe deployment <deployment-name> -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" -l app=<app-label> --tail=100
Voir App_GKE pour la mise à l'échelle, la stratégie de déploiement et les budgets d'interruption de pod.
B. Cloud SQL pour PostgreSQL 15
Ghostfolio stocke toutes les données d'application dans une instance Cloud SQL
gérée pour PostgreSQL 15, accessible via un sidecar cloud-sql-proxy écoutant sur
127.0.0.1. Lors du premier déploiement, un job d'initialisation crée la base de
données et le rôle de l'application.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les flags, les métriques.
- CLI :
gcloud sql instances list --project "$PROJECT"
gcloud sql instances describe <instance-name> --project "$PROJECT"
gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"
C. Redis (requis)
Redis prend en charge la mise en cache des données de marché, les sessions et la gestion des files d'attente/jobs Bull.
- CLI :
kubectl exec -it -n "$NAMESPACE" <pod-name> -- sh -c 'echo -e "PING\r" | nc $REDIS_HOST $REDIS_PORT'
# Confirm the pod's injected Redis env vars:
kubectl exec -n "$NAMESPACE" <pod-name> -- env | grep REDIS
D. Secret Manager
Deux secrets cryptographiques sont générés automatiquement : ACCESS_TOKEN_SALT et
JWT_SECRET_KEY. Le mot de passe de la base de données est géré séparément par la
fondation et synchronisé dans le cluster via SecretSync.
- Console : Security → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
E. Réseau et ingress
Le service LoadBalancer par défaut expose une IP externe. Un Ingress Kubernetes
avec un domaine personnalisé et un certificat géré peut être superposé via
enable_custom_domain.
- CLI :
kubectl get svc -n "$NAMESPACE"
kubectl get ingress -n "$NAMESPACE"
F. Cloud Logging et Monitoring
Les logs des conteneurs sont automatiquement acheminés vers Cloud Logging via l'agent de logging GKE ; les métriques sont acheminées vers Cloud Monitoring.
- CLI :
gcloud logging read 'resource.type="k8s_container" resource.labels.namespace_name="'"$NAMESPACE"'"' --project "$PROJECT" --limit 50
3. Comportement de l'application Ghostfolio
- Configuration de la base de données au premier déploiement. Un job
d'initialisation exécute
db-init.shen utilisantpostgres:15-alpine, créant de manière idempotente le rôle d'application, la base de données et les autorisations. - Les migrations et le seeding s'exécutent à CHAQUE démarrage du conteneur,
dans le même processus que le serveur. Le
docker/entrypoint.shamont exécuteprisma migrate deploy, puisprisma db seed, puis démarre le serveur — une migration échouée fait planter le conteneur bruyamment au lieu de livrer un pod sain contre une base de données vide. ACCESS_TOKEN_SALTetJWT_SECRET_KEYsont immuables après le premier démarrage. La rotation deACCESS_TOKEN_SALTinvalide chaque jeton de sécurité précédemment émis. La rotation deJWT_SECRET_KEYdéconnecte tout le monde.- Pas de formulaire de première exécution à remplir. Le premier visiteur crée son propre jeton de sécurité via "Get Started" — aucune étape de bootstrap administrateur n'est requise.
- Chemin de santé. Les sondes de démarrage et de vivacité ciblent
GET /api/v1/health, qui vérifie À LA FOIS la base de données ET les connexions Redis et renvoie503jusqu'à ce que les deux soient sains. - Inspecter l'exécution du job :
kubectl get jobs -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" job/<job-name>
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 Ghostfolio sont listés ; toutes les autres entrées sont héritées de App_GKE avec leur comportement standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | ghostfolio | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Le ghostfolio/ghostfolio de Docker Hub publie une vraie balise latest — épingler pour des builds reproductibles. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_resources | { cpu_limit="1000m", memory_limit="1Gi" } | 1 vCPU / 1 GiB est suffisant pour une utilisation typique. |
container_port | 3333 | Le DEFAULT_PORT de Ghostfolio. |
enable_cloudsql_volume | true | Exécute le sidecar cloud-sql-proxy ; DB_IP se résout en 127.0.0.1 et le point d'entrée cloud utilise sslmode=disable. |
container_image_source | custom | Cloud Build enveloppe l'image pré-construite ghostfolio/ghostfolio avec un point d'entrée cloud léger. |
Groupe 6 — Placement et réseau Kubernetes
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Ghostfolio est une interface utilisateur web orientée navigateur — ne pas passer à ClusterIP sans un chemin d'ingress séparé. |
namespace_name | (auto-généré) | Espace de noms Kubernetes. |
Groupe 15 — Base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
application_database_name | ghostfolio | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
application_database_user | ghostfolio | Utilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager. |
Groupe 13 — Jobs et NFS
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laisser vide pour utiliser le job db-init intégré. Pas de job de migration séparé — les migrations s'exécutent à l'intérieur du conteneur de l'application à chaque démarrage. |
enable_nfs | false | Non requis — Ghostfolio n'a pas de stockage de fichiers/médias en masse. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe_config | HTTP /api/v1/health, délai de 30s, seuil de 12 échecs | Vérifie À LA FOIS la connectivité de la base de données ET de Redis. |
health_check_config | HTTP /api/v1/health, délai de 30s, seuil de 3 échecs | Même point de terminaison que la sonde de démarrage. |
Groupe 21 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | true | REQUIS — toujours transférer inconditionnellement, ne jamais conditionner à redis_host != "". |
redis_host | "" | Point de terminaison Redis. Laisser vide pour utiliser l'IP du serveur NFS. |
redis_auth | "" | Mot de passe d'authentification Redis (sensible). Aliasé à l'exécution sur la variable d'environnement REDIS_PASSWORD de Ghostfolio. |
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.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
service_url | URL de l'application déployée (IP du LoadBalancer, domaine personnalisé ou DNS interne). |
namespace | Espace de noms Kubernetes. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Manager secret contenant le mot de passe de la base de données. |
storage_buckets | Toujours vide — Ghostfolio n'a pas besoin de stockage de fichiers/médias en masse. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
initialization_jobs | Noms des jobs de configuration. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
ACCESS_TOKEN_SALT (auto-généré) | Ne jamais faire tourner après le premier démarrage | Critique | Le faire tourner invalide chaque jeton de sécurité précédemment émis. |
JWT_SECRET_KEY (auto-généré) | Ne faire tourner que pendant une fenêtre de maintenance | Critique | Le faire tourner invalide toutes les sessions actives. |
application_database_name / application_database_user | Définir une seule fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données. |
enable_redis | true, toujours transféré inconditionnellement | Critique | Sans cela, le point de terminaison de santé de Ghostfolio ne signale jamais un état sain. |
service_type | LoadBalancer | Élevé | Passer à ClusterIP sans un chemin d'ingress séparé rend l'application inaccessible depuis l'extérieur du cluster. |
enable_cloudsql_volume | true | Élevé | Le désactiver supprime le sidecar proxy, de sorte que DB_IP revient à l'IP privée brute et que le branchement sslmode du point d'entrée cloud ne correspond plus à une connexion en boucle. |
enable_backup_import | false sauf en cas de restauration | Critique | L'activation sans un backup_uri valide fait échouer le job d'importation. |
Pour le comportement de la fondation référencé tout au long — Workload Identity, ingress, autoscaling, 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 à Ghostfolio partagée avec la variante Cloud Run est décrite dans Ghostfolio_Common.
Guides associés
- Lab pratique : Ghostfolio sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Ghostfolio sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- Ghostfolio 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.