ActualBudget sur GKE Autopilot
Actual Budget est une application de finances personnelles axée sur la confidentialité et le local-first, construite autour de la budgétisation par enveloppes à base zéro. Le composant actual-server est un serveur de synchronisation Node.js léger qui stocke chaque budget sous forme de fichier SQLite et le synchronise entre l'interface web, les clients de bureau et mobiles. Ce module déploie ActualBudget sur GKE Autopilot en tant que StatefulSet avec un PVC de bloc par pod, sur la base 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 qu'ActualBudget utilise et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.
Ce que coûte ActualBudget sur RAD, et comment cela se compare
Le module GKE Autopilot d'ActualBudget sur RAD coûte environ 42 $ US par mois dans un projet que vous possédez, sans frais de licence pour le logiciel lui-même. RAD facture des frais de module uniques de 75 crédits (7,50 $ US au prix de la recharge) dans un projet que vous possédez, et de 67,5 crédits (10 % de moins) dans un projet géré par RAD. GKE convient à ActualBudget qui doit rester opérationnel en continu ou s'adapter à travers les pods ; pour le coût le plus bas, le module Cloud Run exécute le même ActualBudget pour environ 19 $ US par mois. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.
Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, un besoin saisonnier — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les quelque 42 $ US par mois deviennent presque rien. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
Vous payez pour trois choses :
| Dans un projet Google Cloud que vous possédez | Dans un projet que RAD gère pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 75 crédits (7,50 $ US au prix de la recharge) | 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 pour le temps de build à la minute | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 42 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 75 crédits par jour, environ 2 250 par mois (environ 225 $ US au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est détenu en réserve |
Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le 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 (us-central1, prix catalogue Google) :
| Ressource (module par défaut) | Par mois |
|---|---|
| Pod GKE Autopilot, 1x vCPU / 1 GiB | 36,08 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion du cluster GKE | 0 $ US si c'est votre seul cluster Autopilot/zonal sur le compte de facturation, sinon environ 73 $ US (partagés entre toutes les applications GKE du projet) |
| Total | environ 42 $ US |
Comment cela se compare
- YNAB (You Need A Budget), l'application de budgétisation payante la plus connue dans la même catégorie, facture 14,99 $/mois (ou 109 $/an, soit environ 9,08 $/mois) par personne — et ce n'est qu'une licence logicielle, sans infrastructure propre derrière.
- RAD exécute le projet open-source lui-même, et non une location hébergée par un fournisseur. Vous obtenez le même logiciel, sous votre propre infrastructure (ou celle de RAD), au lieu d'un abonnement par siège ou par utilisation qui augmente indépendamment de ce que vous utilisez réellement.
- Par rapport à un serveur auto-géré nu : C'est une charge de travail plus petite qu'un VPS standard de 2 vCPU, donc l'exécuter vous-même sur une classe moins chère et plus petite qu'un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go Droplet (tous deux environ 24 $/mois) suffirait, pour nettement moins que cela. RAD n'est pas moins cher en termes d'argent — la différence est la base de données gérée, Secret Manager et la surveillance qui viennent avec le module au lieu d'être votre propre travail.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin
Si ActualBudget s'exécute dans un projet que RAD gère pour vous, vous avez une option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet, et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, une démo, un besoin saisonnier — que d'exécuter ActualBudget en continu.
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.
- Comment ça marche. 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. Google ne le supprime pas immédiatement : il conserve le projet, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne détruit pas la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet s'arrête simplement, et rien n'est facturé entre-temps.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, seul le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à 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 que cela nécessite. 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 qui convient à la plupart des utilisations d'étude et de 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 ne survivent pas. Tout ce qu'ActualBudget écrit dans un bucket de sauvegarde à l'intérieur du projet est très probablement perdu dès que vous supprimez le projet, même si le projet lui-même est récupérable pendant 30 jours — la suppression logicielle de Cloud Storage est explicitement désactivée pour ce bucket. Quiconque a personnalisé le déploiement et souhaite conserver ce travail doit copier 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
C'est la solution de repli pour un projet que vous possédez, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est passée : supprimez le déploiement, et redéployez-le lorsque vous en aurez à nouveau besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 $ US) dans votre propre projet, ou 67,5 crédits dans un projet géré par RAD, car RAD reconstruit les ressources à partir de zéro. La suppression permet d'économiser de l'argent une fois qu'ActualBudget resterait 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 (1,40 $ US/jour) ou 1 jour ou plus dans un projet géré par RAD (75 crédits/jour).
- Le cluster GKE lui-même est une infrastructure partagée. Si une autre application utilise le même cluster Autopilot, la suppression d'ActualBudget seule ne sauve que son propre pod ; les frais de gestion du cluster ne diminuent que lorsque rien d'autre dans le projet n'en a besoin.
- Conservez d'abord vos données. Tout ce qu'ActualBudget écrit dans un bucket de sauvegarde à l'intérieur du déploiement est supprimé avec lui — copiez la dernière sauvegarde (vers Google Drive, ou un bucket que vous conservez) avant de supprimer si vous voulez la conserver.
- RAD ne recrée pas un déploiement supprimé pour vous. Vous saisissez à nouveau les paramètres lorsque vous redéployez.
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 d'ActualBudget 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 ActualBudget 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 Google Cloud de l'API Cloud Billing Catalog ; frais de RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration ; Tarification YNAB. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
ActualBudget s'exécute comme une seule charge de travail Node.js actual-server. Parce qu'il gère son propre stockage SQLite, le déploiement relie un ensemble délibérément restreint de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pods actual-server, 1 vCPU / 1 GiB par défaut, réplica unique (min = max = 1) exécuté en tant que StatefulSet |
| Base de données | Aucune | Les budgets sont des fichiers SQLite sous /data — database_type = "NONE" est fixé par ActualBudget_Common ; aucune instance Cloud SQL n'est créée |
| Stockage persistant | PVC Kubernetes (volume de bloc par pod) | stateful_pvc_enabled = true par défaut — un PVC standard-rwo de 20 Gi monté à /data (SQLite a besoin d'un stockage de bloc, pas de GCS FUSE) |
| Stockage d'objets | Cloud Storage | Un bucket storage est toujours déclaré par ActualBudget_Common ; il ne se monte à /data (via GCS FUSE) que lorsque le PVC de bloc est désactivé |
| Secrets | Secret Manager | Optionnel — un jeton API de 32 caractères (enable_api_key, par défaut false) injecté en tant que ACTUAL_TOKEN via un Secret Kubernetes natif |
| Ingress | Kubernetes Service / Gateway API | Par défaut à service_type = ClusterIP avec enable_custom_domain = true mais aucun domaine configuré — interne uniquement jusqu'à ce que vous ajoutiez un LoadBalancer ou un domaine |
Valeurs par défaut judicieuses à connaître à l'avance :
- StatefulSet + PVC de bloc par défaut.
stateful_pvc_enabled = truerésout automatiquementworkload_typeenStatefulSet(pas besoin de définir les deux) et monte un PVCstandard-rwode 20 Gi à/dataavecfsGroup = 3000, correspondant à la convention du graphique Helm d'ActualBudget afin que le conteneur (UID 1000/GID 2000) puisse écrire sur le volume. Ceci est délibérément préféré à GCS FUSE car SQLite ne tolère pas bien un répertoire monté en FUSE. - Pas de base de données du tout.
database_typeest fixé àNONEparActualBudget_Common; il n'y a pas d'instance Cloud SQL, pas de jobdb-init, etenable_cloudsql_volumedésactive par défautfalse(pas de sidecar Cloud SQL Auth Proxy). - Redis est désactivé en dur, pas seulement désactivé par défaut. La variante
main.tftransmetenable_redis = falseà la fondation App_GKE inconditionnellement — elle ne transmet pasvar.enable_redis— donc ActualBudget ne reçoit jamais unREDIS_HOSTsur GKE, quelle que soit la façon dont cette variable est définie. - Réplica unique par conception.
min_instance_count = 1etmax_instance_count = 1— le serveur suppose un accès exclusif à ses fichiers SQLite sur le PVC partagé. container_portest fixé à5006parActualBudget_Commonquelle que soit la valeur propre de la variablecontainer_port— cette variable est inerte (son texte de description/validation fait référence à un6333obsolète, un artefact de copier-coller inoffensif d'un autre module).- Pas de génération d'administrateur/secret. Le mot de passe du serveur est défini de manière interactive sur l'écran d'intégration de la première exécution — il n'y a pas de credential pré-rempli à récupérer, sauf si
enable_api_key = truegénère unACTUAL_TOKEN. - Les sondes de santé ciblent
/— HTTPGET /renvoie 200 dès que le serveur Node écoute, aucune authentification requise. - L'exposition prête à l'emploi est interne uniquement.
service_typeest par défautClusterIP(pasLoadBalancer, contrairement à la plupart des modules d'application GKE) etenable_custom_domainest par défauttruemaisapplication_domainsest par défaut[]— donc un nouveau déploiement n'a pas de point de terminaison externe accessible tant que vous ne définissez passervice_type = LoadBalancerou ne fournissez pasapplication_domains(plus DNS).
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 — le StatefulSet ActualBudget
ActualBudget s'exécute en tant que StatefulSet à réplica unique, ce qui confère à son pod une identité stable (<statefulset-name>-0) et relie le même PVC à travers les redémarrages et les mises à jour.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail ActualBudget pour les pods, les révisions et les événements.
- CLI :
kubectl get statefulset,pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
kubectl describe pod -n "$NAMESPACE" -l app=<service-name>
Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Déploiement vs StatefulSet).
B. Volumes persistants — le PVC de bloc /data
Avec stateful_pvc_enabled = true (la valeur par défaut), un PersistentVolumeClaim par pod est provisionné et monté à /data, où actual-server écrit ses bases de données SQLite de budget, ses fichiers serveur et ses fichiers utilisateur. La StorageClass standard-rwo par défaut est basée sur SSD (Balanced PD) et utilise le quota régional SSD_TOTAL_GB (souvent limité).
- Console : Kubernetes Engine → Stockage → PersistentVolumeClaims.
- CLI :
kubectl get pvc -n "$NAMESPACE"
kubectl describe pvc -n "$NAMESPACE"
kubectl exec -n "$NAMESPACE" statefulset/<service-name> -- df -h /data
C. Cloud Storage — le bucket storage (solution de repli GCS FUSE)
ActualBudget_Common déclare toujours un bucket Cloud Storage (storage), mais il n'est monté à /data via GCS FUSE que lorsque le PVC de bloc est désactivé (stateful_pvc_enabled = false). Avec le PVC StatefulSet par défaut en place, ce bucket existe mais n'est pas monté.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~actualbudget"
Voir App_GKE pour le comportement de montage de GCS Fuse et les options CMEK.
D. Secret Manager — jeton API optionnel
Par défaut, aucun secret n'est créé. Lorsque enable_api_key = true, un jeton aléatoire de 32 caractères est généré, stocké dans Secret Manager sous le nom secret-<prefix>-<app>-api-key, et injecté dans le pod en tant que variable d'environnement ACTUAL_TOKEN via un Secret Kubernetes natif — utile pour les automatisations qui doivent appeler le serveur avant que l'interface utilisateur ne soit configurée.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~api-key"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.
E. Réseau et ingress
La charge de travail est par défaut service_type = ClusterIP — aucune IP externe n'est créée prête à l'emploi. enable_custom_domain = true provisionne une ressource Kubernetes Gateway API, mais avec application_domains = [] par défaut, il n'y a pas de noms d'hôtes à router. Définissez service_type = LoadBalancer pour une IP externe directe, ou renseignez application_domains (avec DNS pointant vers l'IP résultante) pour une passerelle de domaine personnalisé avec un certificat géré.
- Console : Kubernetes Engine → Services et Ingress ; Services réseau → Équilibrage de charge.
- CLI :
kubectl get svc,gateway -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les détails sur les domaines personnalisés, Cloud CDN et les IP statiques.
F. 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. Un test de disponibilité optionnel (uptime_check_config, désactivé par défaut) nécessite un point de terminaison accessible publiquement, ce que la valeur par défaut ClusterIP ne fournit pas.
- 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 ActualBudget
- Pas de job d'initialisation. Il n'y a pas de base de données à amorcer ; le serveur crée ses fichiers SQLite sous
/dataau premier démarrage. Desinitialization_jobspersonnalisés sont acceptés pour les tâches de chargement ou de migration de données, mais aucun n'est fourni par défaut. - Configuration initiale. Lors du premier accès, l'interface web affiche un écran d'intégration où vous définissez le mot de passe du serveur — il n'y a pas de credentials pré-remplis à récupérer. Faites-le immédiatement après avoir rendu le service accessible ; tant qu'un mot de passe n'est pas défini, toute personne pouvant atteindre l'URL peut s'approprier le serveur.
- Disposition des données.
ACTUAL_SERVER_FILES = /data/server-files(métadonnées du serveur et base de données du compte) etACTUAL_USER_FILES = /data/user-files(données de synchronisation par budget), tous deux sur le montage persistant/data(PVC par défaut). - Modèle de synchronisation local-first. Les clients (web, bureau, mobile) conservent une copie locale complète du budget et n'utilisent le serveur que pour synchroniser les modifications chiffrées entre les appareils — une brève indisponibilité du serveur ne bloque pas le travail dans un client.
- Contrainte d'écriture unique, mises à jour sécurisées de StatefulSet. Le serveur suppose un accès exclusif à ses fichiers SQLite ; maintenez
max_instance_count = 1. Étant donné que la charge de travail est un StatefulSet avec une identité stable par pod liée au même PVC, la stratégieRollingUpdatepar défaut remplace le pod unique en place plutôt que de lancer un deuxième pod contre le volume partagé — contrairement aux combinaisons Déploiement+NFS utilisées par d'autres modules de ce dépôt, il n'y a pas de risque de blocage par double montage ici. - Précédence des sondes.
startup_probe_configethealth_check_config(les variables de sonde génériques de haut niveau App_GKE) sont inertes pour ActualBudget — la configuration de sonde effective provient toujours des propres variablesstartup_probe/liveness_probed'ActualBudget (transmises via la sortieconfigdeActualBudget_Common), qui ciblent toutes deux HTTPGET /non authentifié. - Mises à jour de version. Modifiez
application_versionet réappliquez — Cloud Build produit une nouvelle image et le StatefulSet déploie la nouvelle révision.latestconstruit le25.7.1épinglé via l'ARG de buildACTUALBUDGET_VERSIONspécifique à l'application (pas leAPP_VERSIONgénérique que la fondation injecte). - Chemin de santé. Sonde de démarrage : HTTP
GET /, délai initial de 15 s, délai d'expiration de 10 s, période de 10 s, 10 échecs autorisés. Sonde de vivacité : HTTPGET /, délai initial de 30 s, délai d'expiration de 5 s, période de 30 s, 3 échecs autorisés. Les deux renvoient 200 non authentifiés dès que le serveur HTTP écoute. - Vérification :
kubectl get statefulset,pods,svc -n "$NAMESPACE"
POD=$(kubectl get pods -n "$NAMESPACE" -l app=<service-name> -o jsonpath='{.items[0].metadata.name}')
kubectl port-forward -n "$NAMESPACE" "$POD" 5006:5006 &
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5006/ # expect 200
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 ActualBudget 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 | actualbudget | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag de version de l'image ; latest construit le 25.7.1 épinglé. |
enable_api_key | false | Génère un jeton API de 32 caractères dans Secret Manager et l'injecte en tant que ACTUAL_TOKEN. Recommandé pour tout déploiement accessible en dehors du pod/namespace. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
cpu_limit | 1000m | actual-server est un processus Node.js léger ; 1 vCPU suffit. |
memory_limit | 1Gi | Une mémoire modeste suffit pour les fichiers de budget typiques. |
min_instance_count | 1 | Maintient l'instance unique chaude et évite les démarrages à froid. |
max_instance_count | 1 | Maintenir à 1 — un volume SQLite partagé, un seul rédacteur. |
container_port | 5006 | Inerte — ActualBudget_Common définit toujours le port du conteneur à 5006. |
enable_cloudsql_volume | false | Pas de Cloud SQL — laisser false. |
enable_image_mirroring | true | Met en miroir actualbudget/actual-server dans Artifact Registry pour éviter les limites de débit de Docker Hub. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Accessible de l'extérieur par défaut, conformément à tous les autres modules d'application GKE orientés navigateur. Définissez ClusterIP pour le maintenir interne uniquement. |
workload_type | null → StatefulSet | Résolution automatique car stateful_pvc_enabled = true par défaut. |
session_affinity | None | Pas de routage persistant configuré (le réplica unique rend cela largement discutable). |
Groupe 7 — Configuration du StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | true | Activé par défaut — la base de données SQLite de budget et les fichiers utilisateur de actual-server nécessitent un stockage de bloc, pas GCS FUSE. |
stateful_pvc_size | 20Gi | Taille du PVC par pod ; taille pour les bases de données et les fichiers de budget plus les frais généraux. |
stateful_pvc_mount_path | /data | Où actual-server persiste sa base de données SQLite, ses fichiers serveur et ses fichiers utilisateur. |
stateful_pvc_storage_class | standard-rwo | PD équilibré basé sur SSD ; utilise le quota SSD_TOTAL_GB — remplacez par standard (HDD) si ce quota est limité. |
stateful_fs_group | 3000 | Correspond à la convention fsGroup du graphique Helm d'ActualBudget afin que le conteneur (UID 1000/GID 2000) puisse écrire sur le PVC. |
Groupe 9 — Politiques de fiabilité
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_pod_disruption_budget | true | Activé par défaut (contrairement à la plupart des modules) — protège le réplica unique du StatefulSet pendant une perturbation volontaire du nœud. |
pdb_min_available | 1 | Nombre minimal de pods disponibles pendant les perturbations volontaires. |
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /, délai initial de 15 s, 10 échecs | La sonde de démarrage effective (voir §3 "Précédence des sondes"). |
liveness_probe | HTTP /, délai initial de 30 s, 3 échecs | La sonde de vivacité effective. |
startup_probe_config / health_check_config | HTTP / | Déclaré pour la mise en miroir des variables de fondation mais inerte pour ActualBudget — utilisez startup_probe / liveness_probe ci-dessus à la place. |
uptime_check_config | désactivé | N'activez qu'une fois le point de terminaison accessible publiquement (LoadBalancer ou un domaine personnalisé). |
Groupe 14 — Cloud Storage et Artifact Registry
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Crée toujours le bucket storage que ActualBudget_Common déclare. |
gcs_volumes | [] | Montages GCS FUSE supplémentaires ; le bucket storage ne se monte automatiquement à /data que lorsque stateful_pvc_enabled = false. |
Groupe 15 — Cache Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | true (valeur par défaut de la variable) | N'a aucun effet — main.tf code en dur enable_redis = false à la fondation quelle que soit la valeur de cette variable. |
redis_host / redis_port / redis_auth | inerte | Non applicable — ActualBudget n'a pas d'intégration Redis sur GKE. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE (fixe) | ActualBudget_Common fixe ceci à NONE ; aucune instance Cloud SQL n'est créée quelle que soit cette variable. |
application_database_name / application_database_user | actualbudgetdb / actualbudgetuser | Transmis pour la compatibilité de la fondation uniquement — non référencé (aucune base de données n'existe). |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Activé par défaut, mais avec application_domains = [] la passerelle n'a pas de noms d'hôtes à router tant que vous n'en fournissez pas un. |
application_domains | [] | Renseignez pour exposer ActualBudget via un domaine personnalisé + certificat géré. |
reserve_static_ip | true | Réserve une IP statique même si service_type est par défaut ClusterIP (aucune IP de LoadBalancer n'est allouée par défaut). |
Toutes les autres entrées suivent le comportement standard de App_GKE.
5. Sorties
Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
stage_service_cluster_ips | Carte des ClusterIP pour les services spécifiques à l'étape. |
service_external_ip | IP externe du LoadBalancer (lorsque service_type = LoadBalancer et qu'une IP statique est réservée). |
service_url | URL pour atteindre ActualBudget. |
actualbudget_api_key_secret_id | ID du secret Secret Manager pour la clé API. Vide lorsque enable_api_key = false. |
statefulset_name | Nom du StatefulSet. |
storage_buckets | Buckets Cloud Storage créés (inclut le bucket storage). |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
initialization_jobs | Noms des jobs de configuration personnalisés (vide par défaut). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / cicd_configuration | État et détails CI/CD (dépôt, déclencheur, registre). |
github_repository_url / github_repository_owner / github_repository_name | Détails GitHub CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | État VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation d'audit et état CMEK. |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un
StatefulSetforcé à côté d'un paramètre sans état, IAP sans identités autorisées,quota_memory_*donné comme des entiers bruts, uncontainer_port/backup_retention_dayshors de portée. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
max_instance_count | 1 | Critique | Plusieurs pods écrivant les mêmes fichiers SQLite sur un volume partagé risquent une corruption/des conflits d'écriture. |
| Mot de passe du serveur à la première exécution | définir immédiatement | Critique | Tant qu'un mot de passe n'est pas défini, toute personne pouvant atteindre le service peut s'approprier le serveur et ses données budgétaires. |
Contenu du PVC /data | ne jamais supprimer manuellement | Critique | Le PVC de bloc est la seule copie des bases de données de budget ; le supprimer efface tous les budgets. |
stateful_pvc_enabled | true | Critique | Le désactiver revient à utiliser GCS FUSE à /data, qui ne tolère pas SQLite sous de fortes écritures concurrentes. |
quota_memory_requests / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers bruts sont traités comme des octets et bloquent toute planification de pod. |
service_type / application_domains | définir l'un pour exposer à l'extérieur | Élevé | Avec les valeurs par défaut (ClusterIP + pas de domaines), le service n'est accessible que depuis l'intérieur du cluster. |
stateful_pvc_storage_class | standard-rwo (SSD) | Moyen | Utilise le quota SSD_TOTAL_GB limité ; remplacer par standard (HDD) sur un projet avec des contraintes de quota — SQLite n'a pas besoin d'IOPS SSD. |
enable_redis | toute valeur — inerte | Faible | Tenter d'activer Redis via cette variable n'a aucun effet sur GKE ; main.tf le force toujours à s'éteindre. |
container_port | 5006 (fixe) | Faible | La variable est inerte ; sa propre description/texte de validation fait référence à un numéro de port obsolète et sans rapport. |
startup_probe_config / health_check_config | toute valeur — inerte | Faible | Utilisez startup_probe / liveness_probe à la place pour modifier le timing de la sonde ; ces deux-là sont ignorés pour ActualBudget. |
enable_api_key | true pour l'automatisation sur un point de terminaison accessible | Moyen | Sans ACTUAL_TOKEN, l'accès API programmatique repose uniquement sur le mot de passe du serveur. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
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 à ActualBudget partagée avec la variante Cloud Run est décrite dans ActualBudget_Common.
Guides connexes
- Lab pratique : ActualBudget sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- ActualBudget sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- ActualBudget 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.