Aller au contenu principal

Focalboard sur Google Cloud Run

Focalboard sur Google Cloud Run

Focalboard est un serveur Kanban et de gestion de projets auto-hébergé et open source issu du projet Mattermost — un backend Go servant un frontend React construit pour gérer les tâches, les tableaux et les flux de travail. Ce module déploie Focalboard 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 utilisés par Focalboard et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toute application 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 Focalboard sur RAD, et comment cela se compare​

Dans un projet Google Cloud que vous possédez, Focalboard sur le module Cloud Run de RAD coûte environ 102 $ US par mois, plus 11 $ US une fois par déploiement et aucune licence par utilisateur. GKE Autopilot est l'alternative pour les charges de travail qui doivent rester actives en permanence ou s'exécuter à côté d'autres applications Kubernetes ; voir le guide GKE, environ 150 $ US par mois. Focalboard est un outil open source, auto-hébergé de Kanban et de gestion de projets (une alternative à Trello/Asana/Notion) de Mattermost. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si cela s'exécute dans un projet géré par RAD pour vous, il peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de rester en fonctionnement — ainsi, un déploiement à usage occasionnel coûte quelques dollars par mois, et non les 201 $ US par mois qu'il coûte pour le maintenir en fonctionnement. Voir Mettre en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11 $ US au prix de la recharge)99 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 au temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 102 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 $ 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 acheté minimum est détenu 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 ponctuelle, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (module par défaut)Par mois
Cloud Run, 2 vCPU / 4 GiB, mise à l'échelle à zéro32 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 $ US
Serveur de fichiers NFS/cache : une petite VM13 $ US
Passerelle Cloud NAT et adresse IP5 $ US
Cloud Storage pour les sauvegardes1 $ US
Totalenviron 102 $ US

Comment cela se compare​

Nous n'avons pas trouvé de plan commercial géré/SaaS spécifiquement pour Focalboard au 8 octobre 2026, donc la comparaison honnête est avec l'exécution par vous-même :

OptionPar moisQui l'exécute
Hetzner CPX22 (2 vCPU/4 Go)~24 $ USVous : OS, mises à jour, sauvegardes, correctifs de sécurité
DigitalOcean 2 vCPU/4 Go Droplet24 $ USVous : OS, mises à jour, sauvegardes, correctifs de sécurité
GCP Compute Engine e2-standard-2 (2 vCPU/8 Go)~49 $ USVous : OS, mises à jour, sauvegardes, correctifs de sécurité
RAD, Cloud Run, votre propre projet102 $ US, plus 11 $ US une foisL'automatisation de RAD, dans votre projet
RAD, GKE Autopilotenviron 150 $ US ; voir le guide GKE AutopilotRAD
  • RAD n'est généralement pas moins cher en espèces qu'un VPS nu — la différence réside dans ce qui est géré pour vous. Un prix de VPS n'inclut pas le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau du système d'exploitation ; le Cloud SQL géré par RAD (où cette application utilise une base de données), Secret Manager et la surveillance couvrent cela à la place.
  • Focalboard est un outil open source, auto-hébergé de Kanban et de gestion de projets (une alternative à Trello/Asana/Notion) de Mattermost. Cela détermine quelle colonne est importante : un fonctionnement prévisible et sans intervention est plus précieux pour la plupart des équipes utilisant ce type d'outil que de réduire de quelques dollars la facture mensuelle.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin​

Si Focalboard s'exécute dans un projet géré par RAD pour vous, vous avez une option au-delà de la mise à l'échelle : supprimer l'ensemble du projet et le restaurer dans les 30 jours pour presque rien. Cela convient bien mieux à un déploiement dont vous n'avez besoin qu'occasionnellement — pour préparer une certification, une démo, un besoin saisonnier — que de le faire fonctionner 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, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • 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. Google ne le supprime pas immédiatement : il le conserve, 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 seul module, cela ne détruit pas Cloud SQL, la VM ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 201 $ US par mois pour le maintenir en fonctionnement. Déployez Focalboard, utilisez-le pour une session, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et les heures pendant lesquelles il a été réellement actif.
  • Ce que cela nécessite. Vous devez posséder le projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo 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 nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé ce déploiement et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes, de sorte que la majeure partie de son propre coût de calcul s'arrête d'elle-même lorsque personne ne l'utilise. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 $ US). La suppression permet d'économiser de l'argent si Focalboard devait rester inutilisé pendant environ 4 jours ou plus dans votre propre projet (environ 3,40 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (67 crédits par jour).
  • Supprimez tout ce que Focalboard utilise. La majeure partie du coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée. Ils ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
  • Conservez d'abord les données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres lorsque vous dé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 de Focalboard dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite fixée par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour le mécanisme de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Focalboard s'exécute comme un conteneur Go unique sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Go sur le port 8000, 2 vCPU / 4 GiB par défaut ; autoscaling sans serveur avec mise à l'échelle à zéro
Base de donnéesCloud SQL pour PostgreSQL 15Requis — le moteur est fixe (database_type = POSTGRES_15)
Stockage des pièces jointesCloud Storage (GCS FUSE)Un bucket dédié monté à /data via gcsfuse afin que les pièces jointes téléchargées survivent aux redémarrages
SecretsSecret ManagerFOCALBOARD_ADMIN_PASSWORD auto-généré ; mot de passe de la base de données géré par la fondation
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; Focalboard n'a pas de chemin MySQL ou SQLite dans ce module.
  • Focalboard lit config.json, pas les variables d'environnement, pour la connexion à la base de données. Un point d'entrée personnalisé régénère /opt/focalboard/config.json à partir des valeurs DB_* injectées par la Fondation à chaque démarrage, de sorte qu'aucun DSN n'est intégré à l'image.
  • Les pièces jointes résident sur un bucket GCS monté avec gcsfuse à /data. Cloud Run n'a pas d'option PVC de bloc, donc enable_gcs_storage_volume = true monte le bucket de stockage à l'emplacement filespath de Focalboard. Les données du tableau (cartes, tableaux, utilisateurs) résident dans PostgreSQL ; seuls les fichiers téléchargés atterrissent sur le bucket.
  • Aucun Redis n'est utilisé. enable_redis = false — Focalboard conserve tout l'état du tableau dans PostgreSQL et n'a pas besoin de cache ou de file d'attente externe.
  • La mise à l'échelle à zéro est activée (min_instance_count = 0, max_instance_count = 5). Les démarrages à froid ajoutent quelques secondes de latence à la première requête après l'inactivité ; définissez min_instance_count = 1 pour maintenir une instance chaude.
  • L'image est un build personnalisé mis en miroir. L'image officielle mattermost/focalboard est encapsulée et mise en miroir dans Artifact Registry ; application_version par défaut à 7.11.4, et latest mappe à cette balise épinglée au moment du build (latest n'est pas une balise Focalboard publiée).
  • Authentification native, le premier utilisateur est le propriétaire. authMode = native et les tableaux partagés publics sont activés ; le premier compte enregistré via l'interface utilisateur devient le propriétaire de l'espace de travail. Il n'y a pas d'administrateur pré-initialisé.

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 rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Focalboard​

Focalboard s'exécute comme un service Cloud Run v2 écoutant sur le port 8000, s'adaptant automatiquement à la charge de requêtes entre le nombre minimal et maximal d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • 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~focalboard"
    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 SQL pour PostgreSQL 15​

Focalboard stocke toutes les données du tableau (tableaux, cartes, blocs, utilisateurs, sessions) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé — sur Cloud Run via l'IP privée du VPC avec sslmode=require, ou via le socket Unix du Cloud SQL Auth Proxy lorsque enable_cloudsql_volume = true ; aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation crée la base de données et le rôle de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Cloud Storage — bucket de pièces jointes​

Un bucket Cloud Storage dédié (le suffixe storage) est provisionné automatiquement et monté à /data via gcsfuse afin que les pièces jointes téléchargées persistent lors des redémarrages d'instance et de la mise à l'échelle à zéro. Des buckets supplémentaires peuvent être déclarés via storage_buckets.

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

Voir App_CloudRun pour GCS Fuse et les options CMEK.

D. Secret Manager​

Un secret d'application est généré automatiquement et stocké dans Secret Manager : FOCALBOARD_ADMIN_PASSWORD (une chaîne aléatoire de 24 caractères, injectée comme variable d'environnement de SERVICE). Un second secret dédié — secret-<resource_prefix>-focalboard-safe-db-password (alphanumérique uniquement, sans caractères spéciaux) — remplace le DB_PASSWORD du SERVICE et est ce que db-init définit réellement le mot de passe du rôle Postgres (comme FOCALBOARD_SAFE_DB_PASSWORD) ; la sortie database_password_secret à l'échelle de la flotte ne s'authentifie pas auprès du rôle. Voir Section 3.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~focalboard"
    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 accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être superposé ; les paramètres d'ingress et le contrôle d'égression VPC contrôlent la connectivité.

  • 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)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte optionnelles. Le point d'entrée affiche l'hôte de la base de données résolu, le nom, l'utilisateur et sslmode au démarrage — utile pour confirmer le câblage de la connexion.

  • 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 Focalboard​

  • Configuration de la base de données lors du premier déploiement. Un job d'initialisation exécute db-init.sh en utilisant postgres:15-alpine. Il crée de manière idempotente le rôle d'application (LOGIN CREATEDB) et la base de données, accorde les privilèges et réaffecte le propriétaire du schéma public au rôle d'application afin que Focalboard puisse exécuter ses migrations. Aucune extension Postgres n'est installée. Le job peut être réexécuté en toute sécurité.
  • Le vrai mot de passe du rôle est un secret dédié alphanumérique uniquement, pas database_password_secret. Le mot de passe de base de données standard de la flotte de la Fondation (jeu de caractères _%@) peut contenir un % qui fait planter le pilote postgres Go de Focalboard — sa validation DSN basée sur url.Parse et son connecteur lib/pq réel ne sont pas d'accord sur le décodage en pourcentage, de sorte qu'aucun encodage unique de ce mot de passe ne satisfait les deux. Focalboard_Common génère un mot de passe distinct (secret-<resource_prefix>-focalboard-safe-db-password), remplace le DB_PASSWORD du SERVICE par celui-ci, et le transmet à db-init comme FOCALBOARD_SAFE_DB_PASSWORD, ce qui est le mot de passe du rôle réellement défini. La sortie database_password_secret (§5) indique le nom du secret à l'échelle de la flotte, qui ne s'authentifie pas auprès de ce rôle.
  • Les migrations s'exécutent au démarrage. Focalboard applique ses propres migrations de schéma à chaque démarrage en tant qu'utilisateur de l'application, de sorte que la mise à niveau de application_version applique les modifications de schéma sans étape de migration distincte.
  • config.json est généré à l'exécution. Focalboard n'a pas de remplacement de variable d'environnement pour la connexion à la base de données ; le point d'entrée écrit /opt/focalboard/config.json à partir des variables DB_* injectées à chaque démarrage. Sur Cloud Run, il se connecte via l'IP privée avec sslmode=require (préférant DB_IP, car le socket Cloud SQL ne se matérialise pas toujours).
  • Chemin de santé. Les sondes de démarrage, de vivacité et de disponibilité ciblent / — l'interface utilisateur web, qui renvoie 200 une fois que le serveur lie son port et termine les migrations. Prévoyez jusqu'à ~7-8 minutes au premier démarrage (délai initial de démarrage de 60 secondes + une fenêtre de nouvelle tentative de 15s×30).
  • Configuration initiale. Focalboard s'exécute en authMode = native ; ouvrez l'URL du service et enregistrez le premier compte, qui devient le propriétaire de l'espace de travail. enablePublicSharedBoards est activé, de sorte que les tableaux peuvent être partagés via des liens publics.
  • Pièces jointes vs données. Le contenu du tableau réside dans PostgreSQL ; seuls les fichiers téléchargés sont écrits dans le bucket monté avec gcsfuse à /data. Si le montage du bucket est manquant, les téléchargements échouent mais l'édition du tableau fonctionne toujours.
  • Inspecter la configuration et les jobs en cours d'exécution :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

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 Focalboard sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namefocalboardNom de base des ressources. Ne pas modifier après le premier déploiement.
application_version7.11.4Balise d'image Focalboard ; latest correspond à la balise épinglée 7.11.4 au moment du build.
display_nameFocalboardNom lisible par l'homme affiché dans la console.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
cpu_limit2000mCPU par instance.
memory_limit4GiMémoire par instance.
min_instance_count00 active la mise à l'échelle à zéro ; définissez 1 pour éviter les démarrages à froid.
max_instance_count5Nombre maximal d'instances. Peut être augmenté en toute sécurité — l'état du tableau est dans PostgreSQL, pas par instance.
container_port8000Focalboard écoute sur le port 8000.
enable_cloudsql_volumetrueSocket du Cloud SQL Auth Proxy ; le point d'entrée utilise également le TCP IP privée en cas de repli.
enable_image_mirroringtrueMettre en miroir l'image mattermost/focalboard dans Artifact Registry.
cpu_always_allocatedfalseFacturation basée sur les requêtes (démarrage à froid). Focalboard n'a pas de workers en arrière-plan ni de serveur WebSocket, donc la mise à l'échelle à zéro est sûre.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — Focalboard nécessite PostgreSQL 15.
application_database_namecrappdbNom de la base de données Cloud SQL, injecté comme DB_NAME. Immuable après le premier déploiement.
application_database_usercrappuserUtilisateur de la base de données de l'application, injecté comme DB_USER. Mot de passe auto-généré dans Secret Manager.
enable_auto_password_rotationfalseRotation optionnelle du mot de passe de la base de données.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /, délai de 60s, timeout de 10s, période de 15s, 30 tentativesSonde de démarrage. Prévoyez ~7-8 minutes au premier démarrage pour les migrations.
liveness_probeHTTP /, délai de 60s, timeout de 5s, période de 30s, 3 tentativesSonde de vivacité.
uptime_check_config{ enabled=false, path="/" }Vérification de disponibilité Cloud Monitoring ; désactivée par défaut.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redisfalseFocalboard ne nécessite pas Redis ; laissez désactivé.

Toutes les autres entrées suivent le comportement et les valeurs par défaut standard de App_CloudRun.


5. Sorties​

Retourné 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.
service_urlURL run.app par défaut du service.
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é).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe standard de la base de données à l'échelle de la flotte — pas l'identifiant avec lequel le rôle Postgres de Focalboard s'authentifie (voir Section 3) ; utilisez secret-<resource_prefix>-focalboard-safe-db-password à la place.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés (le bucket de pièces jointes).
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, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
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​

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 la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — une configuration IAP sans identités autorisées, un runtime gen1 avec des montages GCS, un database_type qui ne correspond pas à une extension activée, un 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.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
application_database_name / application_database_userDéfinir une foisCritiqueInjecté comme DB_NAME/DB_USER et immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et orpheline toutes les données du tableau.
Bucket de pièces jointes / enable_gcs_storage_volumeConserver le montage gcsfuse à /dataCritiqueSans un montage persistant à filespath, les pièces jointes téléchargées sont écrites sur un disque d'instance éphémère et perdues lors du redémarrage / de la mise à l'échelle à zéro.
database_typePOSTGRES_15CritiqueTout autre moteur empêche le démarrage de Focalboard — il n'y a pas de chemin MySQL/SQLite ici.
application_versionÉpingler une vraie balise (7.11.4)Élevémattermost/focalboard:latest n'est pas une balise publiée ; le build mappe latest à la balise épinglée FOCALBOARD_VERSION, mais l'épinglage explicite évite les surprises.
container_port8000ÉlevéFocalboard se lie au port 8000 ; un port non concordant fait que la sonde de démarrage ne passe jamais.
enable_redisfalseMoyenFocalboard n'a pas besoin de Redis ; l'activer connecte une dépendance inutilisée.
min_instance_count1 pour une utilisation sensible à la latenceMoyenLa mise à l'échelle à zéro (0) ajoute une latence de démarrage à froid à la première requête après l'inactivité.
enable_cloudsql_volumetrueMoyenLe point d'entrée utilise le TCP IP privée avec sslmode=require en cas de repli, mais le socket Auth Proxy est le chemin principal.
Sortie database_password_secretNe pas l'utiliser pour se connecterÉlevéRapporte le secret DB_PASSWORD à l'échelle de la flotte, qui ne s'authentifie pas auprès du rôle Postgres de Focalboard. Récupérez secret-<resource_prefix>-focalboard-safe-db-password pour un identifiant fonctionnel.

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 à Focalboard partagée avec la variante GKE est décrite dans Focalboard_Common.

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