Aller au contenu principal

Focalboard sur GKE Autopilot

Focalboard sur GKE Autopilot

Focalboard est un outil open source et auto-hébergé de gestion de projet et de tableau Kanban de Mattermost — une alternative à Trello/Asana/Notion-boards avec plusieurs vues de tableau (kanban, tableau, galerie, calendrier) pour organiser les tâches avec des tableaux et des cartes. Ce module déploie Focalboard sur GKE Autopilot 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 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 à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE 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, le module GKE Autopilot de Focalboard sur RAD coûte environ 150 $ US par mois, plus 17,50 $ US une fois par déploiement et sans licence par utilisateur. Pour le coût le plus bas, le module Cloud Run exécute le même Focalboard pour environ 102 $ US par mois. Focalboard est un outil open source et auto-hébergé de tableau Kanban et de gestion de projet (une alternative à Trello/Asana/Notion) de Mattermost. Les chiffres sont valables 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 cours d'exécution — ainsi, un déploiement à usage occasionnel coûte quelques dollars par mois, et non les 423 $ US par mois qu'il en 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éploiement175 crédits (17,50 $ US au prix de la recharge)157,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 à la minute pour le temps de buildIdentique
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 150 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 141 crédits par jour, environ 4 230 par mois (environ 423 $ 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 acheté minimum est conservé en réserve

10 crédits coûtent 1 $ US pour une recharge unique, 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
Pod GKE Autopilot, 2 vCPU / 4 Gio, fonctionnant en permanence79 $ 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 et adresse IP Cloud NAT5 $ US
Cloud Storage pour les sauvegardes1 $ US
Totalenviron 150 $ US

Le niveau gratuit de GKE couvre les frais de gestion d'un cluster Autopilot ou zonal par compte de facturation, donc le total ci-dessus suppose qu'il s'agit de ce cluster ; sinon, ajoutez environ 73 $ US par mois.

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, GKE Autopilot, votre propre projet150 $ US, plus 17,50 $ US une foisL'automatisation de RAD, dans votre projet
RAD, Cloud Runenviron 102 $ US ; voir le guide Cloud RunRAD
  • 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. Le prix d'un 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 et auto-hébergé de tableau Kanban et de gestion de projet (une alternative à Trello/Asana/Notion) de Mattermost. Cela détermine la colonne qui compte : une opération prévisible et sans intervention est plus précieuse 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 module, cela ne détruit pas Cloud SQL, la VM ou GKE Autopilot 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 récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update 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 423 $ 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 Update, 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 que RAD gère uniquement pour 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 de 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 que vous l'utilisez, l'autre méthode : supprimer et redéployer​

GKE maintient au moins un pod en cours d'exécution, de sorte que Focalboard ne se met jamais à l'échelle zéro de lui-même. 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 redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 175 crédits (17,50 $ US). La suppression permet d'économiser de l'argent si Focalboard resterait inutilisé pendant environ 4 jours ou plus dans votre propre projet (environ 5 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (141 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. Elles ne s'arrêtent que lorsque 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 sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de 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 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 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 quotidienne des crédits 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 une seule charge de travail web Go/React. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPar défaut, un StatefulSet (voir ci-dessous), serveur Focalboard sur le port 8000, 2 vCPU / 4 Gio par défaut
Base de donnéesCloud SQL pour PostgreSQL 15Requis — moteur verrouillé sur PostgreSQL 13/14/15 (ou NONE) ; MySQL est rejeté au moment de la planification
Stockage par blocsPersistent Disk (PVC par pod)10Gi standard-rwo (SSD) PVC monté à /data, supportant le stockage des pièces jointes de Focalboard (FOCALBOARD_FILESPATH)
Persistance de fichiersCloud Filestore (NFS)Provisionné par défaut (enable_nfs = true) à /opt/focalboard/storage, mais pas le chemin où Focalboard écrit réellement les pièces jointes — voir les pièges
Stockage d'objetsCloud StorageUn bucket suffixé storage est toujours provisionné ; monté via gcsfuse uniquement dans le répertoire de données lorsque le PVC par blocs est désactivé
SecretsSecret ManagerAuto-généré FOCALBOARD_ADMIN_PASSWORD ; mot de passe de la base de données
IngressCloud Load BalancingÉquilibreur de charge externe avec une IP statique réservée ; routage de domaine personnalisé activé par défaut

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

  • PostgreSQL uniquement. database_type par défaut à POSTGRES_15 ; une précondition au moment de la planification dans validation.tf rejette tout sauf POSTGRES_13, POSTGRES_14, POSTGRES_15 ou NONE — MySQL n'est pas pris en charge.
  • Cloud SQL est atteint via le sidecar Auth Proxy sur loopback. Sur GKE, DB_HOST se résout en 127.0.0.1 (le sidecar cloud-sql-proxy), et le point d'entrée construit un DSN libpq en texte clair (sslmode=disable) pour ce cas.
  • La charge de travail est par défaut un StatefulSet, pas un déploiement. stateful_pvc_enabled = true par défaut, ce qui résout automatiquement workload_type en StatefulSet (selon la convention à l'échelle du dépôt — voir App_GKE Groupe 7). Chaque réplica de pod obtient son propre PVC 10Gi standard-rwo isolé monté à /data — les pièces jointes ne sont pas partagées entre les réplicas.
  • min_instance_count = 1, max_instance_count = 5 par défaut — mais parce que le stockage est un PVC par pod (pas un système de fichiers partagé), la mise à l'échelle à plus d'un réplica divise les pièces jointes de tableau téléchargées sur des volumes isolés ; voir le tableau des pièges avant d'augmenter max_instance_count.
  • NFS est provisionné par défaut mais n'est pas utilisé par le propre chemin de stockage de Focalboard. enable_nfs = true monte Filestore à nfs_mount_path (/opt/focalboard/storage), un chemin différent du chemin FOCALBOARD_FILESPATH (/data) supporté par le PVC par blocs que le point d'entrée configure réellement.
  • L'affinité de session est ClientIP afin que les requêtes d'un client atteignent le même pod.
  • Pas de job de migration séparé. Focalboard exécute ses propres migrations de schéma au démarrage en tant qu'utilisateur de la base de données de l'application (voir Focalboard_Common/main.tf) ; le job db-init ne fait que créer la base de données, le rôle et les autorisations.
  • FOCALBOARD_ADMIN_PASSWORD est généré automatiquement et stocké dans Secret Manager, injecté en tant que variable d'environnement secrète du conteneur — voir la mise en garde dans la Section 3 concernant la consommation par le serveur Focalboard lui-même.
  • L'URL du service est remplie automatiquement. Le serverRoot du point d'entrée utilise FOCALBOARD_SERVER_ROOT → CLOUDRUN_SERVICE_URL → GKE_SERVICE_URL → http://localhost:8000 ; App_GKE injecte GKE_SERVICE_URL pour chaque charge de travail GKE, de sorte qu'aucune étape manuelle d'URL post-déploiement n'est requise.

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

A. GKE Autopilot — la charge de travail Focalboard​

Par défaut, Focalboard s'exécute en tant que StatefulSet (car stateful_pvc_enabled = true est la valeur par défaut du module), donnant au pod unique une identité stable et son propre PVC. Si vous désactivez le PVC par blocs, la charge de travail se résout en un Deployment à la place.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Focalboard pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl get statefulset -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" -l app=focalboard --tail=100

Voir App_GKE Groupe 6 (Configuration du backend) et Groupe 7 (StatefulSet/PVC) pour la résolution du type de charge de travail et de la mise à l'échelle Autopilot.

B. Cloud SQL pour PostgreSQL 15​

Focalboard stocke toutes les données de l'application (tableaux, cartes, blocs, utilisateurs) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les pods l'atteignent via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1:5432 ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init (postgres:15-alpine) crée de manière idempotente la base de données de l'application, le rôle et les autorisations — le binaire de Focalboard exécute ensuite les migrations de schéma au démarrage.

  • 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 Secret Manager contenant le mot de passe se trouvent tous dans les Sorties. Voir App_GKE pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe.

C. Stockage par blocs (PVC) et Cloud Storage​

Les pièces jointes de tableau téléchargées persistent sous FOCALBOARD_FILESPATH (par défaut /data), supportées par un PVC 10Gi standard-rwo (Persistent Disk équilibré de classe SSD) créé par pod par le StatefulSet. Un bucket Cloud Storage séparé est toujours provisionné mais n'est monté via gcsfuse dans le répertoire de données que lorsque le PVC par blocs est désactivé (évitant un double montage, car gcsfuse peut corrompre les fichiers d'index/média de Focalboard).

  • Console : Kubernetes Engine → Stockage → PersistentVolumeClaims ; Cloud Storage → Buckets.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    kubectl describe pvc -n "$NAMESPACE" <pvc-name>
    gcloud storage buckets list --project "$PROJECT" --filter="name~focalboard"
    gcloud filestore instances list --project "$PROJECT"

Voir App_GKE Groupe 7 (StatefulSet/PVC), Groupe 13 (NFS) et Groupe 14 (Cloud Storage/GCS Fuse) pour les mécanismes généraux et les options CMEK.

D. Secret Manager​

Un secret spécifique à Focalboard est généré automatiquement et stocké dans Secret Manager : FOCALBOARD_ADMIN_PASSWORD (un mot de passe aléatoire de 24 caractères). Le mot de passe de la base de données est géré séparément par la fondation. Sur GKE, les secrets sont projetés dans les pods via le pilote CSI du Secret Store.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~focalboard"
    gcloud secrets versions access latest --secret=<admin-password-secret-name> --project "$PROJECT"

Voir App_GKE pour l'intégration et la rotation du Secret Store CSI.

E. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing (service_type = LoadBalancer, reserve_static_ip = true afin que l'adresse survive aux redéploiements) avec un Ingress Kubernetes pour le routage de domaine personnalisé activé (enable_custom_domain = true).

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc,ingress -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

F. Cloud Logging et Monitoring​

Les sorties standard et d'erreur des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles (uptime_check_config.enabled par défaut à false).

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

  • Configuration de la base de données au premier déploiement. Le job db-init exécute db-init.sh en utilisant postgres:15-alpine. Il attend que Cloud SQL accepte les connexions, crée de manière idempotente le rôle de l'application (privilège CREATEDB) et la base de données, accorde tous les privilèges sur la base de données, accorde/réaffecte le schéma public à l'utilisateur de l'application (la réaffectation du propriétaire du schéma n'est pas fatale si elle échoue), puis signale au sidecar Cloud SQL Auth Proxy de s'arrêter (quitquitquit) afin que le pod du job se termine. Le job peut être réexécuté en toute sécurité (execute_on_apply = true).
  • Pas de job de migration séparé — Focalboard se migre lui-même au démarrage. Le commentaire du module Focalboard_Common l'indique explicitement : "Focalboard exécute ses propres migrations de schéma au démarrage ; aucune extension Postgres n'est requise." L'utilisateur de l'application a besoin de la pleine propriété du schéma public pour que cela fonctionne, ce que db-init.sh accorde.
  • Compte administrateur — À FAIRE : pas entièrement confirmé par la source. Un secret FOCALBOARD_ADMIN_ PASSWORD est généré et injecté en tant que variable d'environnement secrète du conteneur, mais le script entrypoint.sh ne le référence pas lors de l'écriture de config.json (authMode est défini sur "native"). Il n'a pas pu être confirmé à partir de la source de ce module si le binaire Focalboard en amont consomme FOCALBOARD_ADMIN_PASSWORD pour amorcer un compte administrateur, ou si (comme c'est courant pour l'authentification native de Focalboard) le premier utilisateur à s'inscrire via l'interface utilisateur devient simplement l'administrateur de l'espace de travail. Récupérez le secret et essayez-le lors de la première connexion ; s'il ne s'applique pas, enregistrez le premier compte via l'interface utilisateur.
  • Câblage des variables d'environnement de la base de données. entrypoint.sh construit un seul DSN de mot-clé libpq (dbconfig dans config.json) à partir des variables DB_HOST/DB_IP/ DB_PORT/DB_NAME/DB_USER/DB_PASSWORD injectées par la fondation, en se basant sur l'hôte résolu : un répertoire de socket Unix Cloud Run préfère DB_IP avec sslmode=require ; un hôte loopback (le sidecar proxy GKE, 127.0.0.1) utilise sslmode=disable ; toute autre IP réelle utilise sslmode=require. Sur GKE, cela se résout toujours au cas du loopback, en texte clair vers le sidecar.
  • Le DB_PASSWORD que ce DSN contient 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 Go postgres de Focalboard — sa porte de 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 séparé (secret-<resource_prefix>-focalboard-safe-db-password), remplace le DB_PASSWORD du SERVICE par celui-ci, et le transmet à db-init en tant que FOCALBOARD_SAFE_DB_PASSWORD, qui est le mot de passe réellement défini pour le rôle Postgres. C'est identique au comportement de Cloud Run puisque db-init.sh est partagé via Focalboard_Common. La sortie database_password_secret (§5) signale le nom du secret à l'échelle de la flotte, qui ne s'authentifie pas contre ce rôle.
  • Chemin de stockage des pièces jointes. FOCALBOARD_FILESPATH est défini sur data_dir, ce que la variante GKE relie à stateful_pvc_mount_path (par défaut /data) — le même chemin où le PVC par blocs par pod est monté. Le Dockerfile pré-crée /data avec chmod 0777 afin qu'un nouveau montage de PVC soit inscriptible au démarrage, quel que soit le pod exécuté en tant qu'UID non root.
  • Sondes de santé. Sonde de démarrage : HTTP GET /, initial_delay_seconds=60, timeout_seconds=10, period_seconds=15, failure_threshold=30 (jusqu'à ~8,5 minutes de grâce au démarrage). Sonde de vivacité : HTTP GET /, initial_delay_seconds=60, timeout_seconds=5, period_seconds=30, failure_threshold=3. Une sonde de disponibilité (HTTP GET /, initial_delay=30s, period=10s, failure_threshold=3) est également codée en dur dans Focalboard_Common et n'est pas exposée en tant que variable.
  • L'URL du service se résout automatiquement. serverRoot dans config.json utilise GKE_SERVICE_URL, que App_GKE injecte pour chaque charge de travail GKE — contrairement à certains autres modules, aucun patch manuel environment_variables n'est requis après le déploiement, sauf si vous souhaitez une URL de domaine personnalisé spécifique.
  • Inspecter le job d'initialisation et la configuration en cours d'exécution :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
    kubectl exec -n "$NAMESPACE" statefulset/<service-name> -- cat /opt/focalboard/config.json

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_GKE avec son comportement et ses valeurs par défaut 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.4Tag d'image mattermost/focalboard utilisé comme base de build personnalisé. Incrémenter pour déclencher un rebuild ; latest est épinglé à 7.11.4 au moment du build (pas un tag upstream publié).

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

VariableValeur par défautDescription
container_port8000Port d'écoute natif de Focalboard.
container_resources2000m CPU / 4Gi mémoireLimites par défaut ; aucune requête explicite définie.
enable_cloudsql_volumetrueSidecar Auth Proxy (loopback 127.0.0.1:5432) — requis sur GKE.
container_image_sourcecustomFROM mattermost/focalboard construit comme un mince wrapper ajoutant le point d'entrée cloud.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour l'interface utilisateur de Focalboard.
workload_typenull → StatefulSetSe résout automatiquement en StatefulSet car stateful_pvc_enabled = true par défaut.
session_affinityClientIPRoutage persistant pour qu'un client atteigne le même pod.

Groupe 7 — StatefulSet / PVC​

VariableValeur par défautDescription
stateful_pvc_enabledtrueDonne à chaque pod son propre PVC par blocs pour /data (pièces jointes), évitant la corruption des fichiers d'index/média par gcsfuse. Résout automatiquement workload_type en StatefulSet.
stateful_pvc_size10GiTaille du PVC par pod.
stateful_pvc_mount_path/dataDoit correspondre à filespath de Focalboard ; également passé comme data_dir à Focalboard_Common, qui définit FOCALBOARD_FILESPATH.
stateful_pvc_storage_classstandard-rwoPD équilibré supporté par SSD ; utilise le quota plus strict SSD_TOTAL_GB (voir App_GKE / conventions de dépôt sur le passage au HDD).

Groupe 10 — Observabilité​

VariableValeur par défautDescription
startup_probeHTTP /, délai de 60s, 30 tentatives @ 15sGère la sonde de démarrage réelle du conteneur (câblée via Focalboard_Common, pas le générique startup_probe_config).
liveness_probeHTTP /, délai de 60s, 3 tentatives @ 30sGère la sonde de vivacité réelle du conteneur.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfstrueProvisionne Filestore, mais le propre chemin de pièce jointe de Focalboard (FOCALBOARD_FILESPATH) est le PVC par blocs à stateful_pvc_mount_path, pas le montage NFS — voir Section 1.
nfs_mount_path/opt/focalboard/storageOù le volume NFS (actuellement inutilisé par Focalboard) est monté.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Verrouillé sur PostgreSQL 13/14/15 (ou NONE) par une précondition au moment de la planification — MySQL est rejeté.
application_database_namefocalboardNom de la base de données. Effectivement immuable après le premier déploiement (le renommage orpheline les données existantes).
application_database_userfocalboardUtilisateur de la base de données de l'application ; mot de passe auto-généré dans Secret Manager.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueL'Ingress pour le routage de domaine personnalisé est activé par défaut (diffère de nombreux autres modules, qui le désactivent par défaut).
reserve_static_iptrueIP externe stable à travers les redéploiements.

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 de l'équilibreur de charge externe (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Focalboard.
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 de base de données standard à 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 de la base de données (127.0.0.1 via l'Auth Proxy) / port.
storage_bucketsBuckets Cloud Storage créés.
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_jobs / db_import_jobNoms des jobs de configuration (db-init) et d'importation (facultatif).
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 via le 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 échoue la planification 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 en cas d'erreur
database_typePOSTGRES_15 (ou 13/14)CritiqueUne précondition validation.tf rejette MySQL et les autres moteurs non-Postgres au moment de la planification.
application_database_name / application_database_userDéfinir une foisCritiqueEffectivement immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et orpheline tous les tableaux/cartes.
max_instance_count1 sauf si vous ré-architecturez le stockageCritiqueAvec le stateful_pvc_enabled = true par défaut, chaque réplica obtient son propre PVC isolé — les pièces jointes téléchargées sur un pod sont invisibles depuis un autre. La mise à l'échelle au-delà de 1 divise silencieusement les données, elle ne génère pas d'erreur.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy sur 127.0.0.1:5432 est requis pour la connectivité de la base de données sur GKE.
stateful_pvc_enabledtrueÉlevéLe désactiver (et s'appuyer sur gcsfuse à la place) risque de corrompre les fichiers d'index/média de Focalboard lors d'écritures concurrentes — c'est exactement pourquoi le module Common ignore le montage gcsfuse lorsque le PVC par blocs est activé.
stateful_pvc_mount_path/data (doit être égal à filespath de Focalboard)ÉlevéLe modifier sans également mettre à jour le câblage FOCALBOARD_FILESPATH monte le PVC à un endroit où Focalboard n'écrit jamais, le rendant effectivement éphémère.
session_affinityClientIPMoyenSans persistance, les requêtes rebondissent entre les pods, ce qui est plus important une fois que plusieurs réplicas existent.
enable_nfstrue (mais considérez false)MoyenProvisionne une instance Filestore que le propre chemin de pièce jointe de Focalboard n'utilise pas — un coût évitable à moins que quelque chose d'autre dans votre déploiement n'en ait besoin.
stateful_pvc_storage_classstandard-rwo (SSD)MoyenUtilise le quota strict SSD_TOTAL_GB (Qwiklabs ≈ 500 Go) ; une campagne de modules stateful peut l'épuiser. Remplacer par standard (HDD pd-standard) si les IOPS ne sont pas nécessaires.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
FOCALBOARD_ADMIN_PASSWORD (auto-généré)Récupérer avant la première connexionMoyenNon confirmé pour amorcer une connexion par lui-même (voir Section 3) — l'étape pratique de première exécution peut plutôt être l'enregistrement du premier utilisateur via l'interface utilisateur.
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 contre le rôle Postgres de Focalboard. Récupérer secret-<resource_prefix>-focalboard-safe-db-password pour un identifiant fonctionnel.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer lors des redéploiements, rompant le DNS et toute URL mise en signet.
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 à Focalboard partagée avec la variante Cloud Run 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.