Aller au contenu principal

Passbolt sur Google Cloud Run

Passbolt sur Google Cloud Run

Passbolt (Community Edition) est un gestionnaire de mots de passe gratuit, open source et orienté équipe, avec chiffrement basé sur GPG et partage de credentials par utilisateur/groupe — sous licence AGPL-3.0, ~6k étoiles GitHub. Il occupe une niche différente du module Vaultwarden de ce catalogue : Vaultwarden est un coffre-fort personnel/compatible Bitwarden, tandis que Passbolt est construit autour du partage de credentials chiffrés par GPG à l'échelle de l'organisation entre utilisateurs et groupes. Ce module déploie l'image officielle passbolt/passbolt 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 Passbolt et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, scaling 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 Passbolt sur RAD, et comment cela se compare​

Pour une équipe de dix personnes, Passbolt sur le module Cloud Run de RAD coûte environ 84 $ US par mois, sans licence par utilisateur. L'édition Pro de Passbolt est une licence auto-hébergée à partir de 4,90 $ US/utilisateur/mois (minimum 10 utilisateurs) en plus de votre propre hébergement ; RAD déploie l'édition communautaire gratuite, donc les frais de licence ci-dessous concernent des fonctionnalités supplémentaires, et non une alternative hébergée. Les chiffres sont ceux du 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, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 84 $ US deviennent quelques dollars par mois. Voir Mettez-le 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éploiement75 crédits (7,50 $ US au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation (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 minimum acheté est maintenu 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 avec 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, donc 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 (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 2 Gio (scaleToZero)13,16 $ US
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 84 $ US
  • Cloud SQL et Cloud Run coûtent la même chose en africa-south1 (Johannesburg) ; la VM coûte environ 10 % de plus.
  • Le scale-to-zero est la valeur par défaut. La ligne Cloud Run ci-dessus reflète déjà ce coût ; le réglage min_instance_count = 1 maintient une instance chaude et augmente cette ligne, en échange de l'absence de démarrages à froid.
  • Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 $ US par mois à elle seule.

Comment cela se compare​

  • Passbolt vend sa propre édition Pro sous forme de licence auto-hébergée : 4,90 $ US par utilisateur et par mois, facturée annuellement, avec un minimum de 10 utilisateurs (passbolt.com/pricing, 8 octobre 2026) — environ 49 $ US/mois pour une équipe de 10 personnes. Il s'agit de frais de licence en plus de l'hébergement, ajoutant le SSO, le provisionnement LDAP et la gestion des tags à l'édition communautaire gratuite que RAD déploie — ce n'est pas une alternative hébergée aux chiffres RAD ci-dessus.
  • Un VPS nu exécutant l'édition communautaire gratuite — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $ US/mois — est moins cher que le chiffre du projet propre à RAD ci-dessus, au prix de l'exécution de MySQL, des sauvegardes et de la gestion des clés GPG par vous-même. Passbolt n'a besoin que de 1 vCPU / 2 Gio, donc un niveau de VPS plus petit/moins cher ferait probablement l'affaire.
  • Pour un gestionnaire de mots de passe spécifiquement, qui peut lire les sauvegardes est aussi important que le prix : RAD conserve la base de données et les secrets dans Cloud SQL et Secret Manager plutôt que sur un serveur que vous administrez à la main.
  • Si Passbolt doit rester actif sans mise à l'échelle à zéro, ou fonctionner aux côtés d'autres charges de travail Kubernetes, consultez plutôt le guide GKE — environ 110 $ US par mois dans votre propre projet, ou 2 970 crédits (environ 238-297 $ US) par mois dans un projet géré par RAD.

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

Si Passbolt s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, un environnement de démonstration, une activité saisonnière — que de faire fonctionner Passbolt en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration. La restauration ne peut donc 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. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune 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 récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • 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 Passbolt, utilisez-le un certain temps, 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 le temps pendant lequel Passbolt a été réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du 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 palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : le bucket de sauvegarde ne survit pas. Les sauvegardes de Passbolt sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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 apporté des modifications à Passbolt que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer, comme pour le workflow de redéploiement ci-dessous. 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​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes. 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) : 75 crédits (7,50 $ US), car RAD recrée le projet et les services partagés avant Passbolt. La suppression ne permet d'économiser de l'argent que si Passbolt devait rester inutilisé pendant environ 3 jours ou plus, à la fois dans votre propre projet (environ 2,79 $ US par jour) et dans un projet géré par RAD (67 crédits par jour).
  • La majeure partie du coût d'exécution est généralement la base de données et la VM de fichier/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de Passbolt alors que quelque chose d'autre partage le projet n'économise que la partie calcul de Passbolt.
  • Conservez d'abord les données. Les sauvegardes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres lors du déploiement.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant obtient l'application 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 retournent 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 ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle ; Tarification Passbolt.


1. Vue d'ensemble​

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

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur Apache/PHP, port 80, 1 vCPU / 2 Gio par défaut, min_instance_count = 0 (scale-to-zero)
Base de donnéesCloud SQL pour MySQL (MYSQL_8_0)Requis — Passbolt est une application CakePHP MySQL-only ; variables d'environnement DATASOURCES_DEFAULT_* discrètes, pas un seul DSN
État cryptographiqueDeux buckets GCS dédiés (storage, jwt)Contiennent la paire de clés de serveur GPG et la paire de clés JWT auto-générées par le fournisseur — pas des secrets générés par Terraform
SecretsSecret ManagerSeul le mot de passe de la base de données est généré par la fondation — Passbolt lui-même ne contribue à aucun secret (la sortie Passbolt_Common de secret_ids est toujours vide)
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 :

  • MySQL est obligatoire. database_type = "MYSQL_8_0" est fixé par Passbolt_Common ; Passbolt est construit sur CakePHP avec un schéma MySQL-only.
  • Pas de secret d'application côté serveur. Contrairement à WordPress (plusieurs sels) ou aux applications de la famille Laravel (APP_KEY), Passbolt n'a aucune clé de chiffrement générée par Terraform. Son modèle de sécurité est entièrement côté client : l'extension de navigateur génère une paire de clés GPG et un mot de passe maître localement lors de la configuration. La propre paire de clés GPG du serveur (pour chiffrer les données vers Passbolt) et sa paire de clés JWT (jetons d'authentification API) sont toutes deux auto-générées par le point d'entrée du fournisseur au premier démarrage et persistées sur des volumes GCS dédiés — non créées ou renouvelées par Terraform.
  • Deux volumes GCS dédiés, pas un seul, et pas tout le répertoire /etc/passbolt. storage se monte précisément à /etc/passbolt/gpg ; jwt se monte précisément à /etc/passbolt/jwt. Monter un seul volume sur tout /etc/passbolt masquerait les fichiers de configuration/PHP intégrés (app.php, bootstrap.php, routes.php) qui résident directement dans ce répertoire dans l'image — le même type de bug que ce catalogue a précédemment rencontré avec Cloudreve.
  • HTTPS = "on" est toujours injecté. Le bootstrap.php de Passbolt a $trustProxy = false codé en dur, il ne respecte donc pas X-Forwarded-Proto par défaut — mais il vérifie directement la valeur littérale env('HTTPS'). Étant donné que Cloud Run termine TLS en périphérie et transmet du HTTP simple au conteneur, cette surcharge statique permet à Passbolt de générer correctement les URL https:// dans les e-mails et les liens absolus.
  • enable_cloudsql_volume est par défaut false au niveau de la variable de ce module — asymétrique avec Passbolt_GKE, où il est par défaut true (les deux correspondent à la valeur par défaut de Passbolt_Common qui est true). Définissez-le explicitement sur true pour les connexions MySQL basées sur socket sur Cloud Run.
  • Pas d'assistant de configuration web à la première visite. Le seul moyen d'avoir un compte administrateur est via le job d'initialisation admin-bootstrap, qui imprime une URL de configuration unique dans Cloud Logging pour que l'opérateur l'ouvre dans une extension de navigateur compatible Passbolt.
  • Pas de Redis. enable_redis = false par défaut — Passbolt n'a pas d'intégration Redis utilisée par ce module.

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 Passbolt​

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    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 MySQL​

Passbolt stocke toutes les données de l'application — utilisateurs, groupes, dossiers, ressources de mots de passe chiffrées, permissions de partage — dans une instance MySQL 8.0 gérée de Cloud SQL. La connexion à la base de données utilise les noms de variables d'environnement discrets de Passbolt (DATASOURCES_DEFAULT_HOST/_USERNAME/_PASSWORD/_DATABASE, confirmés par rapport au /passbolt/env.sh du fournisseur), aliasés à partir des valeurs standard DB_* de la Fondation par le module d'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les drapeaux, 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"

Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Cloud Storage — les volumes de paires de clés GPG et JWT​

Deux buckets GCS sont provisionnés par Passbolt_Common et montés via GCS Fuse : storage à /etc/passbolt/gpg, jwt à /etc/passbolt/jwt. Ce ne sont pas des buckets génériques d'upload/média — ils contiennent la paire de clés GPG du serveur et la paire de clés JWT auto-générées par le fournisseur, toutes deux générées une fois au premier démarrage et réutilisées à chaque démarrage ultérieur. La perte de l'un ou l'autre bucket invalide chaque credential que Passbolt a chiffré côté serveur et chaque session JWT émise.

  • Console : Cloud Storage → trouvez les deux buckets (les noms incluent les suffixes storage et jwt).
  • CLI :
    gsutil ls -p "$PROJECT" | grep passbolt
    gsutil ls gs://<storage-bucket-name>/ # expect serverkey.asc, serverkey_private.asc

D. Secret Manager​

Passbolt lui-même ne contribue à aucun secret — la seule entrée Secret Manager liée à ce déploiement est le mot de passe de la base de données, géré par la Fondation.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~passbolt"

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 peuvent être ajoutés ; les paramètres d'ingress et de contrôle d'egress VPC gèrent 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)'

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les logs des conteneurs sont envoyés à Cloud Logging — y compris la sortie de l'URL de configuration unique du job d'initialisation admin-bootstrap. Les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte optionnels.

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

3. Comportement de l'application Passbolt​

  • La chaîne de jobs d'initialisation en 2 étapes, et pourquoi le second job est réellement non trivial. Passbolt_Common définit deux jobs Cloud Run ordonnés, tous deux avec execute_on_apply = true :

    1. db-init (mysql:8.0-debian) — crée le rôle et la base de données MySQL (le db-init.sh partagé à l'échelle du catalogue, caching_sha2_password-safe).

    2. admin-bootstrap (passbolt/passbolt:<version>, depends_on_jobs = ["db-init"]) — enregistre le compte administrateur initial.

      Les jobs Cloud Run invoquent directement le command/args d'un conteneur, contournant entièrement la chaîne /docker-entrypoint.sh du fournisseur — ainsi un cake passbolt register_user nu sur un conteneur fraîchement provisionné échoue avec une erreur interne 500, car la paire de clés de serveur GPG (normalement générée pendant la séquence de démarrage du point d'entrée du fournisseur) n'existe pas encore, et le schéma n'a pas non plus été installé. Le job source plutôt les propres fonctions de point d'entrée du fournisseur (/passbolt/entrypoint.sh, /passbolt/env.sh, /passbolt/deprecated_paths.sh), génère/importe la paire de clés de serveur GPG si manquante, génère un certificat SSL auto-signé si manquant, exécute la propre fonction install() du fournisseur (qui gère également la génération de la paire de clés JWT et l'installation/migration du schéma de la base de données), et seulement ensuite exécute cake passbolt register_user -u <admin_email> -f <admin_first_name> -l <admin_last_name> -r admin — sans le drapeau -q/quiet, de sorte que l'URL de configuration unique est imprimée et atterrit dans Cloud Logging. Confirmé par rapport à la vraie source /passbolt/entrypoint.sh du fournisseur. Idempotent : gpg_gen_key/install() ne fait rien une fois que les clés et le schéma existent déjà à partir d'une exécution précédente.

  • Pas d'assistant de configuration à la première visite, et un modèle de démarrage réellement différent de la plupart des applications de ce catalogue. Passbolt exige que le client (une extension de navigateur) génère sa propre paire de clés GPG et son mot de passe maître — il n'y a pas de mot de passe côté serveur à initialiser et rien à récupérer de Secret Manager. Récupérez plutôt l'URL de configuration unique :

    gcloud logging read \
    'resource.type="cloud_run_job" AND resource.labels.job_name~admin-bootstrap' \
    --project "$PROJECT" --limit 20 --format='value(textPayload)' | grep '/setup/start/'
  • Point de terminaison de santé. GET /healthcheck/status.json renvoie un 200 non authentifié avec {"header":{"status":"success",...},"body":"OK"} une fois prêt — confirmé par des tests de conteneur locaux et un déploiement en direct. Les sondes de démarrage et de vivacité ciblent ce chemin par défaut.

  • Inspecter l'exécution du job :

    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 Passbolt sont listés ; toute autre entrée est héritée 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.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement. Utilisez une valeur distincte (par exemple cr) de tout Passbolt_GKE (gke) co-déployé pour éviter une collision de noms.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namepassboltNom de base des ressources. Ne pas modifier après le premier déploiement.
display_namePassboltNom lisible par l'homme affiché dans la console.
application_versionlatestTag d'image passbolt/passbolt.
admin_emailadmin@example.comE-mail du compte administrateur enregistré par admin-bootstrap.
admin_first_name / admin_last_nameAdmin / UserChamps de nom pour le compte administrateur initial.
enable_gcs_storage_volumetrueMonte les volumes GCS storage (GPG) et jwt. Garder activé.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltDéploie directement l'image officielle ; Passbolt ne prend en charge que l'image pré-construite.
cpu_limit1000m1 vCPU.
memory_limit2GiLimite de mémoire — PHP 8.x + Apache.
min_instance_count0Mise à l'échelle à zéro par défaut.
max_instance_count1Instance unique par défaut.
container_port80Passbolt (Apache) écoute ici.
execution_environmentgen2Environnement d'exécution requis.
enable_cloudsql_volumetrueAsymétrique avec la valeur par défaut de Passbolt_GKE qui est true. Définissez true pour les connexions MySQL basées sur socket — le DATASOURCES_DEFAULT_HOST de Passbolt accepte directement le répertoire du socket.
cloudsql_volume_mount_path/cloudsqlChemin du conteneur pour le socket du proxy d'authentification.
container_protocolhttp1"http1" ou "h2c".
enable_image_mirroringtrueMet en miroir l'image Passbolt dans Artifact Registry.

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallContrôle d'entrée du trafic.
vpc_egress_settingPRIVATE_RANGES_ONLYContrôle de sortie VPC.
enable_iapfalseProxy conscient de l'identité (IAP).

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. HTTPS = "on" et (lorsqu'il est connu) APP_FULL_BASE_URL sont définis automatiquement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager. Passbolt lui-même n'en contribue aucun.

Groupe 11 — Cloud Storage​

VariableValeur par défautDescription
gcs_volumes[]Buckets GCS supplémentaires à monter, en plus des deux que Passbolt provisionne automatiquement (storage, jwt).
enable_nfstrueProvisionne un volume Filestore. Non utilisé par le propre modèle de persistance de Passbolt — les paires de clés GPG/JWT résident sur des volumes GCS dédiés et tout le reste est dans MySQL. Valeur par défaut générique inoffensive.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Moteur Cloud SQL. Passbolt nécessite MySQL.
db_namepassboltNom de la base de données MySQL.
db_userpassboltUtilisateur de l'application MySQL.
database_password_length32Longueur du mot de passe généré (16–64).
db_host_env_var_name / db_user_env_var_name / db_name_env_var_name / db_password_env_var_nameDATASOURCES_DEFAULT_HOST / _USERNAME / _DATABASE / _PASSWORDDéfinis par passbolt.tf, non visibles par l'utilisateur — Passbolt lit des noms de variables d'environnement CakePHP/PDO discrets, pas les noms standard DB_* de la Fondation.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour la chaîne de 2 jobs par défaut de Passbolt_Common (db-init → admin-bootstrap). Une liste non vide la remplace entièrement.
cron_jobs[]Passbolt n'a pas de tâches récurrentes planifiées par la plateforme par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /healthcheck/status.json, délai de 20s, 20 tentativesPoint de terminaison de statut non authentifié de Passbolt.
liveness_probeHTTP /healthcheck/status.json, délai de 60sMême point de terminaison.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redisfalseNon utilisé par Passbolt. Présent pour la compatibilité de la plateforme.

Groupe 22 — VPC Service Controls et Audit Logging​

Intégration standard App_CloudRun VPC-SC — 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.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
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 la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsLes buckets GCS storage (GPG) et jwt.
container_imageImage déployée.
initialization_jobsNoms des jobs d'initialisation créés (db-init, admin-bootstrap).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_urlStatut CI/CD.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.

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 invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource.

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typeMYSQL_8_0CritiqueLe schéma CakePHP de Passbolt est MySQL-only — tout autre moteur bloque complètement le démarrage.
enable_gcs_storage_volumetrueCritiqueLa désactivation entraîne la perte des volumes persistants pour la paire de clés de serveur GPG et la paire de clés JWT auto-générées — chaque credential que Passbolt a chiffré côté serveur, et chaque session JWT émise, devient irrécupérable au prochain redémarrage du conteneur.
Ordre initialization_jobs (db-init → admin-bootstrap)Laissez [] à moins de comprendre parfaitement la dépendanceCritiqueLa réplication par le job admin-bootstrap de la séquence de génération de clés GPG/installation de schéma du fournisseur est essentielle — un job de remplacement naïf qui exécute simplement cake passbolt register_user directement échoue avec une erreur interne car la paire de clés de serveur GPG et le schéma n'existent pas encore.
enable_cloudsql_volumetrue (note : par défaut false sur cette variante)MoyenLe DATASOURCES_DEFAULT_HOST de Passbolt fonctionne directement sur le socket Unix du proxy d'authentification Cloud SQL ; le laisser à sa valeur par défaut côté Cloud Run de false utilise le TCP direct à la place, ce qui fonctionne toujours mais renonce à la terminaison TLS du socket et ne correspond ni à la valeur par défaut de Passbolt_Common ni à la variante GKE.
admin_email / admin_first_name / admin_last_nameDéfinir intentionnellement avant le premier déploiementMoyenCeux-ci amorcent le seul et unique compte administrateur que le job admin-bootstrap crée ; il n'y a aucun moyen intégré à l'application de les modifier après coup, sauf via l'interface utilisateur d'administration de Passbolt une fois connecté.
Pas de mot de passe administrateur à perdre——Contrairement à la plupart des applications de ce catalogue, il n'y a pas de credential administrateur détenu par Secret Manager à récupérer. Si l'URL de configuration unique est manquée et expire, la solution consiste à supprimer et à réexécuter le job admin-bootstrap (il est idempotent pour les étapes GPG/JWT/schéma, mais register_user lui-même peut nécessiter une nouvelle invocation pour une nouvelle URL — vérifiez la documentation CLI de Passbolt pour réémettre un lien de configuration).

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

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