Aller au contenu principal

Vaultwarden sur GKE Autopilot

Vaultwarden sur GKE Autopilot

Vaultwarden est un gestionnaire de mots de passe léger, auto-hébergé et compatible Bitwarden, écrit en Rust. Ce module déploie Vaultwarden sur GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par Vaultwarden 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 Vaultwarden sur RAD, et comment cela se compare​

L'exécution de Vaultwarden sur GKE Autopilot dans votre propre projet Google Cloud coûte environ 75,06 $ US/mois en frais Google Cloud (environ 148,06 $ US si ce n'est pas votre seul cluster Autopilot), en plus d'un frais de module RAD unique de 110 crédits (11 $ US) — plus élevé que le frais du module Cloud Run car cette variante n'a pas de volume NFS partagé (ses données résident sur le pod et la base de données). GKE Autopilot convient à Vaultwarden qui doit s'exécuter à côté d'autres charges de travail Kubernetes ; pour le coût le plus bas, consultez plutôt le guide Cloud Run. Dans un projet géré par RAD, le frais de module tombe à 99 crédits (10 % de moins) — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)110 crédits99 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 Cloud75,06 $ US/mois, facturé par Google au prix catalogue~108 crédits/jour (environ 3 240/mois, 324 $ US au prix de la recharge), mesuré au prix catalogue plus la marge de RAD

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le frais : 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 lors d'une recharge unique, et moins avec un plan mensuel.

Coût d'exécution par défaut dans votre propre projet

Ressource (module par défaut)Par mois
Pod GKE Autopilot, 0,5 vCPU / 0,5 GiB18,04 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total75,06 $ US

Les frais de gestion du cluster GKE sont exclus du total ci-dessus car ils sont partagés entre toutes les applications GKE du projet — 0 $ si c'est la seule, sinon environ 73 $ US/mois répartis entre le nombre d'applications que vous exécutez.

Comment cela se compare​

  • Le service hébergé de Bitwarden, avec lequel Vaultwarden est compatible, facture par utilisateur : Teams est à 4 $ US/utilisateur/mois et Enterprise à 6 $ US/utilisateur/mois (facturé annuellement) — vérifié sur la page de prix de Bitwarden, le 8 octobre 2026. Le coût d'exécution de RAD dans votre propre projet est un forfait d'environ 75 $ US/mois, quel que soit le nombre d'utilisateurs.
  • Une comparaison avec un VPS auto-géré, dimensionné pour le petit pod de Vaultwarden de 0,5 vCPU / 0,5 GiB : un Hetzner CPX11 ou un DigitalOcean 1 vCPU/2 Go Droplet coûte environ 6-12 $ US/mois — plus votre propre temps pour les sauvegardes et les correctifs de Postgres, et aucun plan de contrôle Kubernetes à exécuter.
  • Comme pour la variante Cloud Run, le coût d'exécution de Vaultwarden croise le prix par siège de Bitwarden Teams à environ 19 utilisateurs ; en dessous, l'hébergement de Bitwarden est moins cher en termes monétaires, et le cas de RAD est le contrôle total des données.

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

C'est l'avantage principal d'un projet géré par RAD, et cela ne coûte rien pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, aucune VM, ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte qu'une restauration ne peut pas être invoquée comme 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.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter la mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce qu'il faut : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc 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 affirme que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logique 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é Vaultwarden 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​

Dans votre propre projet, ou une fois que 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources définitivement, et le retour de Vaultwarden signifie un redéploiement à partir de zéro. Cela coûte environ 113-116 crédits dans votre propre projet, ou environ 102-105 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Vaultwarden reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 5 jours ou plus dans votre projet (environ 2,50 $ US par jour), ou environ 1 jour ou plus dans un projet géré par RAD (108 crédits par jour).

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

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 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration ; tarification Bitwarden.

1. Vue d'ensemble​

Vaultwarden s'exécute comme un binaire Rust compilé dans un StatefulSet. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods binaires Rust, 500 m CPU / 512 Mi par défaut, mise à l'échelle horizontale automatique
Base de donnéesCloud SQL pour PostgreSQL 15 (par défaut) ou MySQL 8.0Moteur configurable ; le job d'initialisation s'adapte automatiquement
Stockage par podKubernetes PersistentVolumeClaim10 Gi à /data pour les données du coffre, les clés RSA et les pièces jointes
Stockage d'objetsCloud StorageUn bucket vaultwarden-attachments dédié
SecretsSecret ManagerMot de passe de la base de données ; Vaultwarden gère son propre jeton d'administration en interne
IngressCloud Load BalancingÉquilibreur de charge externe, domaine personnalisé facultatif + certificat géré

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

  • StatefulSet avec un PVC de 10 Gi est la valeur par défaut. Les données du coffre (/data) persistent lors des redémarrages et des mises à niveau des pods. Ne pas passer à un déploiement tant que stateful_pvc_enabled = true.
  • Les inscriptions sont fermées par défaut. signups_allowed = false empêche la création de comptes anonymes. N'activez que pendant la configuration initiale de l'administration, puis désactivez.
  • Aucun jeton d'administration n'est généré automatiquement. Le panneau /admin est désactivé sauf si vous fournissez ADMIN_TOKEN dans environment_variables. C'est la valeur par défaut sécurisée.
  • domain doit être défini pour WebAuthn et TOTP. Sans l'URL publique complète, les codes QR 2FA renvoient à localhost et les e-mails d'invitation d'organisation contiennent des liens brisés.
  • Les sondes de santé ciblent /alive, le point de terminaison de santé léger dédié de Vaultwarden. Vaultwarden démarre rapidement en tant que binaire Rust ; la sonde de démarrage utilise un délai initial de 30 s.
  • L'affinité de session est ClientIP par défaut pour acheminer un client Bitwarden donné de manière cohérente vers le même pod.

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

Les pods Vaultwarden sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. Un StatefulSet avec un PersistentVolumeClaim sauvegarde le répertoire /data afin que les données du coffre survivent aux redémarrages et aux mises à niveau des pods. L'autoscaling horizontal des pods dimensionne la charge de travail entre le nombre minimal et maximal de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Vaultwarden pour voir les pods, les révisions et les événements. Kubernetes Engine → Services & Ingress affiche l'adresse IP externe.
  • CLI :
    kubectl get pods,svc,hpa,pvc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation
    kubectl describe pvc -n "$NAMESPACE" # per-pod storage status

Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail StatefulSet sont gérés.

B. Cloud SQL — PostgreSQL 15 ou MySQL 8.0​

Vaultwarden stocke toutes les données du coffre dans une instance Cloud SQL gérée. Le moteur par défaut est PostgreSQL 15 ; définissez database_type = "MYSQL_8_0" pour utiliser MySQL à la place. Les pods se connectent en privé via le sidecar Cloud SQL Auth Proxy via un socket Unix, de sorte qu'aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs et les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    # Open an interactive shell to inspect schema/data:
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.

C. PersistentVolumeClaim et Cloud Storage​

Les données du coffre (l'état de secours SQLite de Vaultwarden, les clés de signature RSA, les métadonnées des pièces jointes et la configuration 2FA) sont écrites dans un PersistentVolumeClaim par pod à /data. Un bucket Cloud Storage dédié (vaultwarden-attachments) est également provisionné pour les fichiers joints ; le compte de service de la charge de travail se voit accorder l'accès automatiquement.

  • Console : Kubernetes Engine → Stockage → PersistentVolumeClaims ; Cloud Storage → Buckets pour le bucket des pièces jointes.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    kubectl describe pvc -n "$NAMESPACE" <pvc-name>
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<attachments-bucket>/ # bucket name is in the Outputs

Voir App_GKE pour les options GCS Fuse et CMEK.

D. Secret Manager​

Le mot de passe de la base de données est stocké en tant que secret Secret Manager et injecté dans les pods au moment de l'exécution. Vaultwarden gère son propre jeton d'administration interne et ses clés de signature RSA dans le volume /data — ceux-ci ne sont pas stockés dans Secret Manager.

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

Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.

E. Réseau et ingress​

Par défaut, la charge de travail est exposée via une adresse IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une adresse IP statique peut être réservée afin que l'adresse survive aux redéploiements. Cloud Armor est fortement recommandé pour protéger les points de terminaison de connexion de Vaultwarden contre les attaques par force brute.

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

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

F. Cloud Logging et Monitoring​

Les flux stdout/stderr des pods vers Cloud Logging ; les métriques GKE et Cloud SQL vers Cloud Monitoring. Un test de disponibilité ciblant /alive peut être activé.

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

  • Configuration de la base de données au premier déploiement. Un job d'initialisation crée la base de données et l'utilisateur Vaultwarden et accorde les privilèges avant le démarrage de l'application. Il est idempotent et peut être réexécuté en toute sécurité. L'image de job correcte est sélectionnée automatiquement : postgres:15-alpine pour PostgreSQL, mysql:8.0-debian pour MySQL.
  • Pas de migrations de schéma au démarrage. Vaultwarden gère automatiquement sa propre évolution de schéma interne. Le job d'initialisation ne fait que créer la base de données et l'utilisateur ; aucune commande de migration n'est nécessaire.
  • Aucune tâche planifiée requise. Contrairement à de nombreuses applications web, Vaultwarden n'a pas de jobs cron obligatoires. Toutes les opérations de coffre sont pilotées par des requêtes.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux /alive, qui renvoie OK lorsque le serveur est prêt. Le délai initial est de 30 s, ce qui correspond au démarrage rapide de Vaultwarden en Rust.
  • Panneau d'administration. Le panneau /admin est désactivé sauf si ADMIN_TOKEN est fourni via environment_variables. Générez un jeton sécurisé et transmettez-le en tant que variable d'environnement non secrète (ou référencez-le depuis Secret Manager via secret_environment_variables).
  • SMTP pour les notifications. Vaultwarden utilise SMTP pour la vérification de compte, les codes de récupération 2FA et les e-mails d'accès d'urgence. Configurez SMTP_HOST, SMTP_PORT, SMTP_FROM, SMTP_USERNAME et SMTP_PASSWORD (via secret_environment_variables) comme un ensemble complet — une configuration SMTP partielle entraîne des échecs de livraison silencieux.

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 Vaultwarden sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement standard et ses valeurs par défaut.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail 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.
support_users[]E-mails auxquels sont accordés l'accès au projet et les alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application et paramètres Vaultwarden​

VariableValeur par défautDescription
application_namevaultwardenNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameVaultwarden Password ManagerNom convivial affiché dans la console.
application_description(défini)Annotation de description de la charge de travail.
application_version1.32.7Tag de version de l'image Vaultwarden ; incrémenter pour déployer une nouvelle version.
domain""URL publique complète (par exemple https://vault.example.com). Requise pour WebAuthn, les codes QR TOTP, les invitations d'organisation et les liens de pièces jointes.
signups_allowedfalseAutoriser l'auto-inscription de nouveaux utilisateurs. N'activer que pendant la configuration initiale ; désactiver immédiatement après la création des comptes administrateur.
web_vault_enabledtrueServir l'interface utilisateur web de Vaultwarden. Désactiver pour un accès API uniquement via des clients natifs.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomcustom construit à partir du Dockerfile ; prebuilt utilise un URI d'image existant.
cpu_limit500mCPU par pod. Vaultwarden est un binaire Rust léger.
memory_limit512MiMémoire par pod.
min_instance_count1Réplicas minimum. Garder ≥ 1 pour éviter l'indisponibilité du coffre au démarrage à froid.
max_instance_count3Réplicas maximum (plafond de l'autoscaler).
container_port80Port HTTP Rocket de Vaultwarden. Doit correspondre à ROCKET_PORT.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions de socket Unix. Requis.
enable_vertical_pod_autoscalingfalseLaisser Autopilot ajuster automatiquement les demandes de ressources.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables(valeurs par défaut SMTP/log)Paramètres en texte clair. Les variables ROCKET_PORT, SIGNUPS_ALLOWED, WEB_VAULT_ENABLED, DATA_FOLDER et éventuellement DOMAIN sont injectées automatiquement. La valeur par défaut inclut LOG_LEVEL=warn, SHOW_PASSWORD_HINT=false et des valeurs de stub SMTP.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager (par exemple { SMTP_PASSWORD = "vaultwarden-smtp-pass" }).
secret_rotation_period2592000sCadence de notification de rotation de Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service est exposé.
workload_typeStatefulSetUtiliser StatefulSet pour le stockage persistant /data (par défaut et recommandé).
session_affinityClientIPAcheminer un client donné de manière cohérente vers le même pod.
network_tags["nfsserver"]Tags réseau de nœud/pod pour les règles de pare-feu.
gke_cluster_name""Nom du cluster GKE ; laisser vide pour la découverte automatique.
namespace_name""Espace de noms Kubernetes ; laisser vide pour générer automatiquement.

Groupe 7 — Stockage persistant StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueProvisionner un PVC pour le répertoire /data de Vaultwarden.
stateful_pvc_size10GiTaille du PVC. Augmenter pour les grands coffres avec de nombreuses pièces jointes.
stateful_pvc_mount_path/dataChemin de montage, correspondant à la variable d'environnement DATA_FOLDER.
stateful_pvc_storage_classstandard-rwoStorageClass Kubernetes.
stateful_headless_servicenullCréer un service sans tête pour le DNS StatefulSet.
stateful_pod_management_policynullOrdre de création des pods : OrderedReady ou Parallel.
stateful_update_strategynullStratégie de mise à jour : RollingUpdate ou OnDelete.
stateful_fs_group0GID du groupe de fichiers défini dans le contexte de sécurité du pod.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalseLimiter les comptes CPU/mémoire/objets de l'espace de noms.
quota_memory_requests / quota_memory_limits""Doit utiliser des unités binaires (4Gi, 8192Mi) — les entiers bruts sont lus comme des octets et bloquent la planification.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité lors des mises à niveau de nœuds.
pdb_min_available1Augmenter min_instance_count au-dessus de 1 si vous avez besoin d'une marge d'éviction.
enable_topology_spreadfalseRépartir les pods sur plusieurs zones.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configHTTP /alive, délai de 30 s, 6 échecsChemin de santé dédié de Vaultwarden ; 30 s correspond au démarrage rapide de Rust.
health_check_configHTTP /alive, délai de 30 s, 3 échecsSonde de vivacité.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring facultatif ciblant /alive.
alert_policies[]Politiques d'alerte métrique facultatives.

Groupe 11 — Automatisation de la charge de travail (jobs et tâches planifiées)​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job de configuration de base de données intégré (sélectionne automatiquement l'image correcte pour PostgreSQL ou MySQL).
cron_jobs[]Vaultwarden n'a pas de tâches planifiées requises ; ajouter des CronJobs personnalisés ici si nécessaire.

Groupe 12 — CI/CD et intégration GitHub​

Intégration standard App_GKE Cloud Build / Cloud Deploy — voir App_GKE. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy.

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

VariableValeur par défautDescription
enable_nfsfalseVolume NFS Filestore facultatif. Non requis pour Vaultwarden à réplica unique (le PVC couvre /data). Activer pour un stockage supplémentaire partagé entre les réplicas.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner le bucket des pièces jointes.
storage_buckets[{ name_suffix = "data" }]Buckets supplémentaires.
gcs_volumes[]Montages de volume GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15POSTGRES_15 (par défaut) ou MYSQL_8_0. L'image du job d'initialisation est sélectionnée automatiquement.
application_database_namevaultwardenNom de la base de données. Immuable après le premier déploiement.
application_database_uservaultwardenUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.

Groupe 17 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days30Rétention ; la valeur par défaut de 30 jours reflète l'importance de la récupération du coffre.
enable_backup_import / backup_source / backup_urioptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 18 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécuter du SQL à partir d'un bucket GCS après le provisionnement. Voir App_GKE.

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

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôtes personnalisés + certificat géré. Ne prend effet que lorsque application_domains n'est pas vide.
application_domains[]Noms d'hôtes à servir. Définir également domain sur l'URL complète https://.
reserve_static_iptrueIP externe stable sur les redéploiements ; recommandé pour la stabilité DNS.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google. Remarque : IAP devant Vaultwarden peut empêcher les clients natifs Bitwarden de se connecter.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder.
iap_oauth_client_id / iap_oauth_client_secret""Requis lorsque IAP est activé (sensible).
iap_support_email""Affiché sur l'écran de consentement OAuth.

Groupe 21 — Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseRecommandé pour Vaultwarden. Attacher une politique WAF Cloud Armor pour protéger le point de terminaison de connexion contre la force brute.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
cloud_armor_policy_namedefault-waf-policyNom de la politique.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

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_ipsMappage des ClusterIP pour les services spécifiques à l'étape (Cloud Deploy).
service_external_ipIP de l'équilibreur de charge externe (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Vaultwarden.
database_instance_nameNom de l'instance Cloud SQL.
database_nameNom de la base de données de l'application.
database_userUtilisateur 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 de la base de données (127.0.0.1 via le proxy d'authentification) / 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 et d'importation (facultatif).
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.
kubernetes_readyIndique si le cluster/la charge de travail est prêt(e).
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).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
signups_allowedfalseCritiqueTout utilisateur d'Internet peut s'auto-enregistrer sur le coffre tant que true. Désactiver immédiatement après la création des comptes administrateur.
enable_cloudsql_volumetrueCritiqueVaultwarden se connecte à Cloud SQL via un socket Unix ; la désactivation provoque un CrashLoopBackOff immédiat.
application_database_name / _userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et Vaultwarden voit un coffre vide.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide échoue le job d'importation.
quota_memory_requests / _limitsunités binairesCritiqueLes entiers bruts sont des octets et bloquent toute planification.
workload_type + stateful_pvc_enabledStatefulSet / trueCritiqueLa définition de workload_type = "Deployment" avec stateful_pvc_enabled = true échoue au moment de la planification.
domainURL complète https://ÉlevéSans cela, les codes QR TOTP renvoient à localhost, les e-mails d'invitation d'organisation contiennent des liens brisés et les URL des pièces jointes sont invalides.
database_typedéfini une foisÉlevéLa modification après le premier déploiement entraîne la connexion de Vaultwarden à une base de données vide ; toutes les informations d'identification semblent perdues.
container_port80ÉlevéDoit correspondre à ROCKET_PORT ; une non-concordance signifie que la sonde de disponibilité échoue et que le pod ne devient jamais prêt.
min_instance_count1Élevé0 se met à l'échelle à zéro ; un gestionnaire de mots de passe devient indisponible pendant plusieurs secondes au démarrage à froid — les clients Bitwarden affichent des erreurs de connexion.
stateful_pvc_size10GiÉlevéTrop petit, il se remplit lorsque les utilisateurs stockent des pièces jointes, ce qui provoque des erreurs d'écriture. Augmenter avant de remplir.
session_affinityClientIPMoyenSans persistance, les opérations de synchronisation de coffre en cours peuvent être acheminées vers différents pods et rencontrer un état obsolète.
enable_cloud_armoractiver pour la productionMoyenSans Cloud Armor, le point de terminaison de connexion de Vaultwarden est ouvert aux attaques par force brute depuis Internet.
backup_retention_days30 (par défaut, augmenter pour la production)MoyenUn gestionnaire de mots de passe sans rétention de sauvegarde adéquate signifie une perte d'informations d'identification en cas de défaillance de la base de données.
pdb_min_available vs min_instance_countlaisser une margeMoyen1/1 peut bloquer les mises à niveau de nœuds (un seul pod ne peut pas être évincé).
enable_iap avec des clients natifsutiliser avec prudenceMoyenIAP nécessite un OAuth basé sur un navigateur ; les clients natifs Bitwarden ne peuvent pas terminer le flux IAP.
smtp_* variables d'environnementconfigurer comme un ensemble completÉlevéUne configuration SMTP partielle entraîne des échecs de livraison d'e-mails silencieux — les codes de récupération 2FA et les e-mails d'invitation ne sont jamais envoyés.

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 à Vaultwarden partagée avec la variante Cloud Run est décrite dans Vaultwarden_Common.

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