Aller au contenu principal

ActualBudget sur GKE Autopilot

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édezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé 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 quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD 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 GiB36,08 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion du cluster GKE0 $ 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)
Totalenviron 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 CloudNotes
CalculGKE AutopilotPods actual-server, 1 vCPU / 1 GiB par défaut, réplica unique (min = max = 1) exécuté en tant que StatefulSet
Base de donnéesAucuneLes budgets sont des fichiers SQLite sous /data — database_type = "NONE" est fixé par ActualBudget_Common ; aucune instance Cloud SQL n'est créée
Stockage persistantPVC 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'objetsCloud StorageUn 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é
SecretsSecret ManagerOptionnel — 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
IngressKubernetes Service / Gateway APIPar 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 = true résout automatiquement workload_type en StatefulSet (pas besoin de définir les deux) et monte un PVC standard-rwo de 20 Gi à /data avec fsGroup = 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_type est fixé à NONE par ActualBudget_Common ; il n'y a pas d'instance Cloud SQL, pas de job db-init, et enable_cloudsql_volume désactive par défaut false (pas de sidecar Cloud SQL Auth Proxy).
  • Redis est désactivé en dur, pas seulement désactivé par défaut. La variante main.tf transmet enable_redis = false à la fondation App_GKE inconditionnellement — elle ne transmet pas var.enable_redis — donc ActualBudget ne reçoit jamais un REDIS_HOST sur GKE, quelle que soit la façon dont cette variable est définie.
  • Réplica unique par conception. min_instance_count = 1 et max_instance_count = 1 — le serveur suppose un accès exclusif à ses fichiers SQLite sur le PVC partagé.
  • container_port est fixé à 5006 par ActualBudget_Common quelle que soit la valeur propre de la variable container_port — cette variable est inerte (son texte de description/validation fait référence à un 6333 obsolè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 = true génère un ACTUAL_TOKEN.
  • Les sondes de santé ciblent / — HTTP GET / renvoie 200 dès que le serveur Node écoute, aucune authentification requise.
  • L'exposition prête à l'emploi est interne uniquement. service_type est par défaut ClusterIP (pas LoadBalancer, contrairement à la plupart des modules d'application GKE) et enable_custom_domain est par défaut true mais application_domains est par défaut [] — donc un nouveau déploiement n'a pas de point de terminaison externe accessible tant que vous ne définissez pas service_type = LoadBalancer ou ne fournissez pas application_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 /data au premier démarrage. Des initialization_jobs personnalisé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) et ACTUAL_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égie RollingUpdate par 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_config et health_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 variables startup_probe / liveness_probe d'ActualBudget (transmises via la sortie config de ActualBudget_Common), qui ciblent toutes deux HTTP GET / non authentifié.
  • Mises à jour de version. Modifiez application_version et réappliquez — Cloud Build produit une nouvelle image et le StatefulSet déploie la nouvelle révision. latest construit le 25.7.1 épinglé via l'ARG de build ACTUALBUDGET_VERSION spécifique à l'application (pas le APP_VERSION gé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é : HTTP GET /, 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​

VariableValeur par défautDescription
application_nameactualbudgetNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag de version de l'image ; latest construit le 25.7.1 épinglé.
enable_api_keyfalseGé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​

VariableValeur par défautDescription
cpu_limit1000mactual-server est un processus Node.js léger ; 1 vCPU suffit.
memory_limit1GiUne mémoire modeste suffit pour les fichiers de budget typiques.
min_instance_count1Maintient l'instance unique chaude et évite les démarrages à froid.
max_instance_count1Maintenir à 1 — un volume SQLite partagé, un seul rédacteur.
container_port5006Inerte — ActualBudget_Common définit toujours le port du conteneur à 5006.
enable_cloudsql_volumefalsePas de Cloud SQL — laisser false.
enable_image_mirroringtrueMet en miroir actualbudget/actual-server dans Artifact Registry pour éviter les limites de débit de Docker Hub.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerAccessible 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_typenull → StatefulSetRésolution automatique car stateful_pvc_enabled = true par défaut.
session_affinityNonePas de routage persistant configuré (le réplica unique rend cela largement discutable).

Groupe 7 — Configuration du StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueActivé 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_size20GiTaille 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/dataOù actual-server persiste sa base de données SQLite, ses fichiers serveur et ses fichiers utilisateur.
stateful_pvc_storage_classstandard-rwoPD équilibré basé sur SSD ; utilise le quota SSD_TOTAL_GB — remplacez par standard (HDD) si ce quota est limité.
stateful_fs_group3000Correspond à 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é​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueActivé 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_available1Nombre minimal de pods disponibles pendant les perturbations volontaires.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /, délai initial de 15 s, 10 échecsLa sonde de démarrage effective (voir §3 "Précédence des sondes").
liveness_probeHTTP /, délai initial de 30 s, 3 échecsLa sonde de vivacité effective.
startup_probe_config / health_check_configHTTP /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_configdésactivéN'activez qu'une fois le point de terminaison accessible publiquement (LoadBalancer ou un domaine personnalisé).

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueCré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​

VariableValeur par défautDescription
enable_redistrue (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_authinerteNon applicable — ActualBudget n'a pas d'intégration Redis sur GKE.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONE (fixe)ActualBudget_Common fixe ceci à NONE ; aucune instance Cloud SQL n'est créée quelle que soit cette variable.
application_database_name / application_database_useractualbudgetdb / actualbudgetuserTransmis 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​

VariableValeur par défautDescription
enable_custom_domaintrueActivé 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_iptrueRé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.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsque service_type = LoadBalancer et qu'une IP statique est réservée).
service_urlURL pour atteindre ActualBudget.
actualbudget_api_key_secret_idID du secret Secret Manager pour la clé API. Vide lorsque enable_api_key = false.
statefulset_nameNom du StatefulSet.
storage_bucketsBuckets Cloud Storage créés (inclut le bucket storage).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobsNoms des jobs de configuration personnalisés (vide par défaut).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants 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_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique 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_enabledJournalisation 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 StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors 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ètreValeur judicieuseRisqueConséquence si erroné
max_instance_count1CritiquePlusieurs 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écutiondéfinir immédiatementCritiqueTant 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 /datane jamais supprimer manuellementCritiqueLe PVC de bloc est la seule copie des bases de données de budget ; le supprimer efface tous les budgets.
stateful_pvc_enabledtrueCritiqueLe désactiver revient à utiliser GCS FUSE à /data, qui ne tolère pas SQLite sous de fortes écritures concurrentes.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod.
service_type / application_domainsdé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_classstandard-rwo (SSD)MoyenUtilise 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_redistoute valeur — inerteFaibleTenter d'activer Redis via cette variable n'a aucun effet sur GKE ; main.tf le force toujours à s'éteindre.
container_port5006 (fixe)FaibleLa 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_configtoute valeur — inerteFaibleUtilisez startup_probe / liveness_probe à la place pour modifier le timing de la sonde ; ces deux-là sont ignorés pour ActualBudget.
enable_api_keytrue pour l'automatisation sur un point de terminaison accessibleMoyenSans ACTUAL_TOKEN, l'accès API programmatique repose uniquement sur le mot de passe du serveur.
backup_retention_days7 (augmenter pour la production)MoyenTrop 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.

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