Aller au contenu principal

ActualBudget sur Google Cloud Run

ActualBudget sur Google Cloud Run

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 le serveur Actual Budget sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

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 à toutes les applications Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte ActualBudget sur RAD et comment cela se compare​

ActualBudget sur le module Cloud Run de RAD coûte environ 19 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 40 crédits (4 US$ au prix de la recharge) dans un projet que vous possédez, et de 36 crédits (10 % de moins) dans un projet géré par RAD. Si ActualBudget doit fonctionner en continu sur plusieurs pods ou à côté d'autres charges de travail Kubernetes, consultez plutôt le guide GKE. Les chiffres sont à jour 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 19 US$ par mois deviennent presque nuls. 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 géré par RAD pour vous
Frais de module, une fois par déploiement40 crédits (4 US$ au prix de la recharge)36 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 à la minute pour le temps de buildIdem
Coût de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 19 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 17 crédits par jour, soit environ 510 par mois (environ 51 US$ au prix de la recharge)
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 de crédits achetés est conservé en réserve

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 de fonctionnement par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 GiB (chaud)13,14 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Totalenviron 19 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 il s'agit uniquement de frais de licence pour le logiciel, 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, sur 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 : Il s'agit d'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 monétaires — la différence réside dans la base de données gérée, Secret Manager et la surveillance qui sont fournis avec le module au lieu d'être votre propre travail.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin​

Si ActualBudget fonctionne dans un projet géré par RAD pour vous, vous disposez d'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 — préparation d'une certification, démonstration, besoin saisonnier — qu'à l'exécution continue d'ActualBudget.

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, sera utilisable après sa restauration. Par conséquent, la restauration ne peut pas être considérée comme un moyen fiable 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 cette période d'attente. Contrairement à la suppression d'un seul 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 restaurer 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 quoi Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude et de démonstration conviennent). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : 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 — ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée. 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) : 40 crédits (4,00 US$) dans votre propre projet, ou 36 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 de fonctionnement — environ 7 jours ou plus dans votre propre projet (0,64 US$/jour) ou 3 jours ou plus dans un projet géré par RAD (17 crédits/jour).
  • 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, 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 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 un conteneur Node.js unique sur Cloud Run v2. Comme 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
CalculCloud Run v2Service Node.js, 1 vCPU / 1 GiB par défaut, instance unique (min = max = 1)
Base de donnéesAucuneActualBudget conserve les données budgétaires dans des fichiers SQLite — database_type = "NONE", pas de Cloud SQL
Données persistantesCloud Storage (GCS FUSE)Un bucket storage dédié monté à /data contient les fichiers de budget SQLite et les fichiers utilisateur
Image de conteneurArtifact Registry + Cloud BuildBuild de type thin-wrapper de actualbudget/actual-server, mis en miroir dans votre registre
SecretsSecret ManagerUn jeton API (enable_api_key), activé par défaut et requis chaque fois que ingress_settings = "all"
IngressURL Cloud Run / Cloud Load BalancingPar défaut all (public) — nécessaire pour atteindre directement l'interface web ; passer à internal pour un accès uniquement VPC

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

  • Pas de base de données externe. ActualBudget persiste tout sous forme de fichiers SQLite sous /data ; il n'y a pas d'instance Cloud SQL, pas de job db-init, pas de Redis (enable_redis = false), et pas de sidecar Cloud SQL Auth Proxy.
  • Un bucket GCS storage est provisionné automatiquement par ActualBudget_Common et monté à /data via GCS FUSE (enable_gcs_storage_volume = true). ACTUAL_SERVER_FILES = /data/server-files et ACTUAL_USER_FILES = /data/user-files pointent les deux sous-arborescences de persistance vers ce montage afin que rien ne se retrouve sur le disque éphémère du conteneur.
  • Instance unique par conception. min_instance_count = 1 et max_instance_count = 1 — le serveur sert un ensemble partagé de fichiers SQLite à partir d'un seul volume ; l'exécution de plusieurs réplicas risque des conflits d'écriture.
  • L'ingress est par défaut all (public), associé à une clé API obligatoire. ingress_settings = "all" est la valeur par défaut du module — nécessaire pour atteindre directement l'interface web — et validation.tf applique une précondition au moment de la planification (ingress_settings != "all" || enable_api_key) qui rejette l'ingress public à moins que enable_api_key ne soit également true. Étant donné que enable_api_key est également par défaut true, les valeurs par défaut pures passent la validation et se déploient publiquement accessibles avec une protection par jeton API déjà provisionnée. Passez à ingress_settings = "internal" pour un accès uniquement VPC à la place.
  • Clé API activée par défaut. Le mot de passe du serveur est toujours défini de manière interactive sur l'écran d'intégration de la première exécution, mais enable_api_key = true (la valeur par défaut du module) provisionne en outre un jeton API de 32 caractères (ACTUAL_TOKEN) dans Secret Manager — requis par la précondition d'ingress ci-dessus chaque fois que ingress_settings = "all".
  • Épinglage de version. Le Dockerfile lit un ARG de build ACTUALBUDGET_VERSION spécifique à l'application ; application_version = "latest" épingle le build à 25.7.1.
  • Les sondes de santé ciblent / — le serveur répond à son chemin racine avec HTTP 200 dès qu'il écoute, aucune authentification requise.
  • Mieux adapté à une utilisation mono-utilisateur / légère sur Cloud Run. SQLite sur GCS FUSE ne tolère pas les écritures concurrentes lourdes ; pour un stockage de production durable, préférez la variante ActualBudget_GKE avec un PVC de bloc.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources sont indiqués dans les Sorties du déploiement.

A. Cloud Run — le service ActualBudget​

ActualBudget s'exécute en tant que service Cloud Run v2 épinglé à une seule instance. Chaque déploiement crée une révision immuable ; le trafic bascule vers la nouvelle révision saine lors de la mise à jour.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION" \
    --filter="metadata.name~actualbudget"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud Storage — la couche de données persistantes​

Tout l'état d'ActualBudget — les bases de données de budget SQLite, les fichiers du serveur et les données utilisateur par fichier — réside sur un bucket Cloud Storage dédié monté dans le conteneur à /data via GCS FUSE (environnement d'exécution gen2 requis). Le bucket survit aux déploiements de révisions, aux redémarrages et aux redéploiements ; c'est le seul endroit où les données budgétaires existent, alors traitez-le comme la chose à protéger et à sauvegarder.

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

Voir App_CloudRun pour le comportement de montage GCS Fuse et CMEK.

C. Artifact Registry et Cloud Build — l'image de conteneur​

ActualBudget_Common fournit un Dockerfile thin-wrapper (FROM actualbudget/actual-server:${ACTUALBUDGET_VERSION}) que Cloud Build transforme en image dans le dépôt Artifact Registry de votre projet — ainsi les déploiements tirent de votre registre, et non de Docker Hub, et sont compatibles avec Binary Authorization.

  • Console : Artifact Registry → Dépôts ; Cloud Build → Historique.
  • CLI :
    gcloud artifacts repositories list --project "$PROJECT" --location "$REGION"
    gcloud builds list --project "$PROJECT" --region "$REGION" --limit 5

D. Secret Manager — jeton API​

enable_api_key = true est la valeur par défaut du module : 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 service en tant que variable d'environnement secrète ACTUAL_TOKEN — utile pour les automatisations qui doivent appeler le serveur avant que l'interface utilisateur ne soit configurée, et requis par validation.tf chaque fois que ingress_settings = "all" (également la valeur par défaut).

  • 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_CloudRun pour les détails d'injection et de rotation.

E. Réseau et ingress​

Le service est par défaut ingress_settings = "all", de sorte que l'URL run.app est publiquement accessible dès la sortie de la boîte (nécessaire pour atteindre directement l'interface web) — associée à la valeur par défaut obligatoire enable_api_key = true (voir §2.D). Pour un accès uniquement VPC, définissez ingress_settings = "internal" ; pour un domaine personnalisé, Cloud CDN, Cloud Armor et éventuellement IAP en amont, utilisez internal-and-cloud-load-balancing.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    # Tunnel to an internal-only service from your workstation:
    gcloud run services proxy <service-name> --region "$REGION" --port 8080

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring. Un test de disponibilité peut être activé via uptime_check_config (désactivé par défaut ; il nécessite un point de terminaison publiquement accessible — satisfait par défaut par ingress_settings = "all", mais pas si vous passez à internal).

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application 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 de la première exécution. 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 d'identifiants pré-remplis à récupérer. Faites-le immédiatement après le déploiement ; le service est publiquement accessible par défaut (ingress_settings = "all"), et 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). Les deux résident sur le montage GCS FUSE, de sorte que les données budgétaires survivent aux redémarrages et aux redéploiements.
  • 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'un seul rédacteur. Le serveur suppose un accès exclusif à ses fichiers SQLite. Conservez max_instance_count = 1 ; une validation au moment de la planification applique min_instance_count <= max_instance_count.
  • Mises à jour de version. Modifiez application_version et réappliquez — Cloud Build produit une nouvelle image et Cloud Run déploie une nouvelle révision. latest construit le 25.7.1 épinglé.
  • Point de terminaison de santé. Les sondes de démarrage et de vivacité émettent GET /, qui renvoie HTTP 200 non authentifié dès que le serveur HTTP écoute.
  • Vérification :
    SERVICE=$(gcloud run services list --project "$PROJECT" --region "$REGION" \
    --filter="metadata.name~actualbudget" --format="value(metadata.name)" --limit=1)
    SERVICE_URL=$(gcloud run services describe "$SERVICE" \
    --project "$PROJECT" --region "$REGION" --format="value(status.url)")
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/" # expect 200 with the default ingress=all (403/404 if switched to internal)

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_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails autorisés à accéder au projet et aux alertes de surveillance.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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é. Incrémenter pour déclencher un nouveau build et une nouvelle révision.
enable_api_keytrueGénère un jeton API de 32 caractères dans Secret Manager et l'injecte en tant que ACTUAL_TOKEN. Requis chaque fois que ingress_settings = "all" (la valeur par défaut du module) — validation.tf rejette l'ingress public sans cela.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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. Définissez 0 pour une mise à l'échelle à zéro si un démarrage à froid à la première requête est acceptable.
max_instance_count1Maintenir à 1 — un volume SQLite partagé, un seul rédacteur.
container_port5006Port HTTP natif d'actual-server.
execution_environmentgen2Requis pour le montage GCS FUSE /data.
enable_cloudsql_volumefalsePas de Cloud SQL — laissez false.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallPublic par défaut (nécessaire pour atteindre directement l'interface web) ; validation.tf requiert enable_api_key = true lorsque cette valeur est all. Définissez internal pour un accès uniquement VPC, ou internal-and-cloud-load-balancing derrière un équilibreur de charge HTTPS.
enable_iapfalseAjoute l'authentification Google-identity devant l'interface utilisateur (chemin de l'équilibreur de charge).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement supplémentaires en clair. ACTUAL_PORT, ACTUAL_SERVER_FILES et ACTUAL_USER_FILES sont injectées automatiquement.
secret_environment_variables{}Références Secret Manager supplémentaires. Le secret ACTUAL_TOKEN est automatiquement câblé lorsque enable_api_key = true.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupes 7-10 — Sauvegarde, CI/CD, SQL personnalisé, Domaine et CDN​

Comportement standard d'App_CloudRun — voir App_CloudRun. Notez que les entrées SQL personnalisées (groupe 9) sont inertes pour ActualBudget car il n'y a pas d'instance Cloud SQL.

Groupe 11 — Cloud Storage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueLe bucket de données storage est toujours déclaré par ActualBudget_Common.
gcs_volumes[]Montages GCS FUSE supplémentaires ; le montage de stockage /data est ajouté automatiquement.
enable_nfsfalseNon nécessaire — la persistance est sur le bucket GCS.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixé à NONE par ActualBudget_Common — ActualBudget n'a pas de base de données SQL.

Toutes les autres entrées de ce groupe sont transmises pour compatibilité mais ne sont pas référencées.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Pas de job par défaut. Fournissez le vôtre uniquement pour le chargement/la migration de données personnalisés.
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /, délai initial de 15 s, 10 échecsPasse dès que le serveur Node écoute.
liveness_probeHTTP /, délai initial de 30 s, période de 30 sChemin racine, non authentifié.
uptime_check_configdésactivéN'activez que lorsque le point de terminaison est publiquement accessible (ingress all ou un équilibreur de charge).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 23 — VPC Service Controls et journalisation d'audit​

enable_vpc_sc, vpc_cidr_ranges, vpc_sc_dry_run, organization_id, enable_audit_logging — comportement standard d'App_CloudRun ; voir App_CloudRun.


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.

SortieDescription
service_nameNom du service Cloud Run.
actualbudget_urlL'URL run.app du service. Publiquement accessible par défaut (ingress_settings = "all") ; restreinte au VPC lorsque ingress_settings = "internal".
service_locationRégion dans laquelle le service s'exécute.
stage_servicesDétails du service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés (inclut le bucket de stockage /data).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
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 / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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​

Le module intègre une validation au moment de la planification pour les erreurs de configuration les plus dommageables (par exemple min_instance_count <= max_instance_count), mais plusieurs paramètres méritent une attention particulière :

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
max_instance_count1CritiquePlusieurs instances écrivent les mêmes fichiers SQLite sur un volume partagé — risque de corruption/conflit.
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 l'URL peut s'approprier le serveur et ses données budgétaires.
Contenu du bucket de stockagene jamais supprimer manuellementCritique/data sur le bucket GCS est la seule copie des bases de données budgétaires ; la suppression du bucket efface tous les budgets.
container_port5006CritiquePort natif d'actual-server ; une non-concordance entraîne l'échec de toutes les sondes de santé.
execution_environmentgen2ÉlevéLes montages de volume GCS FUSE nécessitent la génération 2 ; la génération 1 laisse /data non monté et les données sur un disque éphémère.
ingress_settings = "all" (par défaut)définir le mot de passe du serveur immédiatement après le déploiementCritiqueLe service est publiquement accessible par défaut ; un serveur non réclamé peut être réclamé par toute personne qui atteint l'URL en premier. Définissez internal à la place si l'accès public n'est pas nécessaire.
ingress_settings = "all" avec enable_api_key = falsecombinaison non valideCritiquevalidation.tf applique ingress_settings != "all" || enable_api_key au moment de la planification — cette combinaison fait échouer le plan purement et simplement plutôt que de déployer de manière non sécurisée. Les deux valeurs par défaut satisfont déjà la précondition (all + true), de sorte que les valeurs par défaut pures se déploient proprement ; seul un remplacement explicite par enable_api_key = false tout en laissant l'ingress à all déclenche l'échec.
Charge d'écriture multi-utilisateur lourdepasser à ActualBudget_GKE (PVC de bloc)ÉlevéSQLite ne tolère pas GCS FUSE sous une charge d'écriture concurrente lourde ; Cloud Run convient à une utilisation mono-utilisateur / légère.
enable_api_keytrue (par défaut)MoyenSans ACTUAL_TOKEN, l'accès API programmatique repose uniquement sur le mot de passe du serveur. Également requis par la précondition d'ingress ci-dessus chaque fois que ingress_settings = "all".
min_instance_count1 (ou 0 pour économiser des coûts)Moyen0 ajoute un démarrage à froid à la première requête après l'inactivité ; les données sont sûres dans tous les cas (l'état est sur GCS).
uptime_check_configactiver lorsque l'ingress est publicFaibleSi ingress_settings est basculé sur internal, la vérification ne peut pas atteindre le service et échouera toujours.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à ActualBudget partagée avec la variante GKE 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.