Aller au contenu principal

Module Stalwart GKE — Guide de configuration

Ce guide décrit les variables de configuration disponibles dans le module Stalwart_GKE. Stalwart_GKE est un module wrapper qui combine le module d'infrastructure générique App_GKE avec la configuration d'application partagée Stalwart_Common pour déployer Stalwart Mail Server — un serveur de messagerie open source qui sert SMTP, IMAP, POP3, JMAP et ManageSieve à partir d'un seul binaire Rust — sur Google Kubernetes Engine (GKE) Autopilot.

La plupart des options de configuration de Stalwart GKE correspondent directement aux mêmes options de App GKE. Lorsqu'une variable a un comportement identique, ce guide fait référence au guide App GKE plutôt que de répéter la même documentation. Seules les variables et les valeurs par défaut spécifiques à Stalwart sont décrites en détail ici.

Note : Les variables marquées comme gérées par la plateforme sont définies et maintenues par la plateforme. Vous n'avez normalement pas besoin de les modifier.

GKE uniquement : Il n'y a pas de variante Cloud Run. Les protocoles de messagerie sont des protocoles ligne que Cloud Run ne peut pas transférer, et Stalwart sert normalement sur le port 443 tandis que son port 8080 ne s'ouvre que lorsqu'il n'est pas configuré ou n'a pas réussi à démarrer — le contrat $PORT de Cloud Run serait donc satisfait précisément lorsque le serveur est en panne.


Ce que Stalwart coûte sur RAD, et comparaison​

Stalwart sur le module GKE Autopilot de RAD coûte environ 110,13 $ US par mois dans un projet Google Cloud que vous possédez, avec les frais de module facturés une fois en crédits RAD. Il n'y a pas de variante Cloud Run — les protocoles de messagerie nécessitent les ports TCP de longue durée que Cloud Run ne peut pas transférer — donc GKE Autopilot est la seule façon dont RAD déploie Stalwart. Si vous n'avez besoin d'un serveur de messagerie qu'occasionnellement — pour des tests, un cours, un projet de courte durée — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de payer pour qu'il reste inactif. Voir Mettez-le en pause gratuitement, ci-dessous. Les chiffres sont ceux du 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11 $ US au prix de la recharge)99 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 110,13 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 129 crédits par jour, environ 3 870 par mois (environ 387 $ 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 minimum acheté est conservé en réserve

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 assez d'historique GKE géré par RAD pour le mesurer, donc 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 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 lors d'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 chaque application du projet, de sorte qu'une deuxième application n'ajoute pas un deuxième ensemble de ces éléments.

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
Pod GKE Autopilot, 1x vCPU / 2 Gio39,68 $ 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,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total110,13 $ US

Comparaison​

  • Le niveau payant de Stalwart est une licence Enterprise pour le même binaire auto-hébergé (prix par boîte aux lettres, facturé annuellement ou mensuellement) — pas un service de messagerie hébergé que quelqu'un d'autre gère pour vous, ce n'est donc pas une alternative comparable à RAD gérant l'infrastructure.
  • Une comparaison auto-gérée pour un serveur de messagerie, qui nécessite une base de données et un serveur de fichiers ainsi que le processus de messagerie lui-même : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte le même prix de 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — plus le temps de l'administrateur pour la configuration DKIM/SPF/DMARC, les sauvegardes, les correctifs de sécurité et le renouvellement TLS, que Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent pour vous.
  • L'exécution de votre propre serveur de messagerie — sur RAD ou ailleurs — échange les frais par siège d'un fournisseur de boîtes aux lettres hébergées contre l'infrastructure plus le travail continu de délivrabilité (DNS inverse, réputation IP) qu'un fournisseur comme Google Workspace ou Fastmail prend en charge pour vous.

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

Si Stalwart s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, la VM NFS 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 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.

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 posséder le 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 palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont de 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 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é la configuration de messagerie de Stalwart ou conservé des données de boîte aux lettres que vous souhaitez conserver, 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.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Dans votre propre projet, ou une fois que la fenêtre de restauration de 30 jours est passée, l'alternative est de supprimer Stalwart purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits (11,00 $ US) dans votre propre projet, ou 99 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Stalwart resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet propre ci-dessus (environ 3,67 $ US par jour), cela représente environ 4 jours ou plus, ou environ 1 jour ou plus dans un projet géré par RAD (129 crédits par jour). La majeure partie du coût d'exécution ici est la base de données et le serveur de fichiers NFS ; ils ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de Stalwart pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de 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 ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration. Aucun SaaS de messagerie hébergé commercial actuellement vérifié exécutant Stalwart lui-même n'existe, donc aucun prix concurrent n'est mentionné.

Référence de configuration standard​

Les zones de configuration suivantes sont fournies par le module sous-jacent App_GKE. Consultez les sections liées du Guide de configuration App_GKE pour une documentation complète.

Zone de configurationSection App GKE.mdNotes spécifiques à Stalwart
Projet et identité§2 IAM et contrôle d'accèsIdentique.
Identité de l'application§3.A Compute (GKE Autopilot)Modifiez le nom d'affichage restant Wiki.js ; voir Groupe 3.
Exécution et mise à l'échelle§3.A Compute (GKE Autopilot)container_port = 443 ; conservez un réplica ; voir Groupe 4.
Variables d'environnement et secrets§3 Configuration du service principalSTALWART_RECOVERY_ADMIN appartient à secret_environment_variables ; voir Groupe 5.
Service Kubernetes et ports§5 Trafic et IngressL4 LoadBalancer transportant 443 plus six ports de messagerie ; voir Groupe 6 et la carte des ports.
Charges de travail avec état§3.A Compute (GKE Autopilot)StatefulSet avec un PVC à /var/lib/stalwart ; voir Groupe 7.
Budgets d'interruption de pod§7.A Budgets d'interruption de podCréé uniquement lorsque max_instance_count > 1.
Observabilité et vérifications de santé§3.A Compute (GKE Autopilot)Sondes TCP sur 443 ; voir Groupe 10.
Jobs d'initialisation et CronJobs§3.E Jobs d'initialisation et CronJobsPas de job d'initialisation — Stalwart crée son propre schéma.
CI/CD, autorisation binaire§6 CI/CD et livraison, §4.CIdentique.
Stockage — NFS / GCS§3.C Stockage (NFS / GCS / GCS Fuse)Non utilisé par Stalwart ; voir Groupes 13–14.
Redis§8.A Redis / MemorystoreDésactiver ; voir Groupe 15.
Configuration de la base de données§3.B Base de données (Cloud SQL)MySQL 8.0, fixé par Stalwart_Common ; voir Groupe 16.
Planification de sauvegarde, importation et SQL personnalisé§3.B, §8.B, §3.EIdentique.
Domaine personnalisé et IP statique§5.C Réservation d'IP statiqueIP statique sur le LoadBalancer ; pas de passerelle ; voir Groupe 19.
IAP, Cloud Armor, CDN§4.A, §4.B, §5.BFonctionnalités de passerelle (HTTP) — elles ne couvrent pas les ports de messagerie.
Contrôles de service VPC§4.D Contrôles de service VPCIdentique.

Comment Stalwart GKE est lié à App GKE​

Stalwart GKE transmet ses variables à App GKE et ajoute un sous-module Stalwart Common qui fournit la configuration d'application spécifique à Stalwart. Les principaux effets sont les suivants :

  1. Une image wrapper écrit config.json. Stalwart lit un seul fichier --config /etc/stalwart/config.json qui ne contient que sa définition DataStore, et le fichier n'est pas livré dans l'image. App_GKE ne peut pas monter une ConfigMap dans le conteneur de l'application, donc Stalwart_Common construit FROM stalwartlabs/stalwart:<version> avec un point d'entrée qui rend le fichier à partir des variables DB_IP, DB_PORT, DB_NAME et DB_USER de la fondation à chaque démarrage. Le mot de passe n'est pas écrit dans le fichier — son authSecret est { "@type": "EnvironmentVariable", "variableName": "DB_PASSWORD" }.
  2. La base de données est MySQL 8.0, accessible via l'IP privée. Stalwart_Common définit database_type = "MYSQL_8_0" et enable_cloudsql_volume = false ; le host DataStore est l'IP privée brute de Cloud SQL. Ces valeurs proviennent de Stalwart_Common et remplacent les propres entrées database_type et enable_cloudsql_volume du wrapper, tout comme le port du conteneur (443).
  3. Il n'y a pas de job d'initialisation. L'étape db-create de la fondation provisionne la base de données et l'utilisateur, et Stalwart crée ses propres tables (27 lors d'une nouvelle installation) lors de la première connexion.
  4. Le conteneur sert sur le port 443, jamais sur le port 8080. L'écouteur HTTPS normal de Stalwart (interface d'administration, JMAP, /healthz/live) est le port 443. Le port 8080 ne s'ouvre que dans ses états de démarrage ("aucun fichier de configuration n'a été trouvé") et de récupération ("le démarrage a échoué").
  5. Les sondes sont TCP sur le port 443. Le HEALTHCHECK de l'image est curl https://127.0.0.1:443/healthz/live || curl http://127.0.0.1:8080/healthz/live, qui signale un serveur défectueux comme sain via le repli 8080. Une sonde HTTP n'est pas non plus possible : la sonde HTTP de App_GKE n'a pas de champ scheme, elle ne peut donc pas vérifier un port HTTPS.
  6. Le service est un équilibreur de charge TCP L4 avec les ports de messagerie ajoutés. service_port = 443 plus extra_service_ports (25, 465, 587, 993, 995, 4190).
  7. Réplica unique par conception. Un deuxième réplica nécessite le coordinateur de Stalwart, qui nécessite Redis ; le module évite Redis. Notez que la valeur par défaut max_instance_count du wrapper est 3 — définissez-la sur 1.
  8. Les domaines, les écouteurs et TLS ne sont pas configurés. Tous les paramètres de Stalwart autres que le DataStore résident dans la base de données et sont appliqués avec stalwart-cli (une image distincte). Le module ne câble pas cette étape.

Groupe 1 : Projet et identité​

Identique à App_GKE. Voir App_GKE. Entrées : project_id (obligatoire), tenant_id ("demo"), region ("us-central1").


Groupe 2 : Environnement de déploiement​

Identique à App_GKE : support_users ([]) et resource_labels ({}).


Groupe 3 : Identité de l'application​

VariableValeur par défaut Stalwart GKENotes
application_name"stalwart"Nom de base pour toutes les ressources GCP et Kubernetes. Ne pas modifier après le déploiement.
application_display_name"Wiki.js"Un reste du module à partir duquel le wrapper a été copié. C'est ce que la console GCP, la description de l'IP statique et les tableaux de bord affichent — définissez-le sur "Stalwart Mail Server" ou similaire.
application_description"Wiki.js - The most powerful and extensible open source Wiki software"Également un reste, mais non utilisé — la description de la charge de travail provient de Stalwart_Common ("Stalwart — serveur de messagerie et de collaboration open source…").
application_version"v0.16.22"Tag stalwartlabs/stalwart, passé au build comme STALWART_VERSION. Épinglez une version exacte — cette valeur remplace la valeur par défaut _Common. Une reconstruction sous un tag inchangé ne produit pas de diff Terraform.

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

VariableValeur par défaut Stalwart GKENotes
container_port443Sans effet — App_GKE prend le port du conteneur de Stalwart_Common, qui le fixe à 443, l'écouteur HTTPS normal de Stalwart (jamais 8080, le port de démarrage/récupération). Les sondes TCP vérifient ce port.
container_resources{ cpu_limit = "1000m", memory_limit = "2Gi" }Également passé à Stalwart_Common comme limites du conteneur.
min_instance_count1Gardez au moins un réplica — le courrier doit être reçu en continu.
max_instance_count3Définir sur 1. Toute valeur supérieure à 1 crée un HorizontalPodAutoscaler (min min_instance_count, max cette valeur, mise à l'échelle sur l'utilisation du CPU et de la mémoire) et un PodDisruptionBudget. Un deuxième réplica nécessite le coordinateur de Stalwart, qui nécessite Redis, que ce module ne configure pas.
container_image_source"custom"Construit l'image du wrapper. "prebuilt" déploierait une image sans le générateur config.json ; Stalwart ne trouverait alors aucune configuration et ouvrirait le port 8080.
container_image"stalwartlabs/stalwart"Référence de l'image de base.
enable_image_mirroringtrueMettre en miroir l'image dans Artifact Registry.
enable_cloudsql_volumetrueSans effet — Stalwart_Common le définit toujours sur false (pas de sidecar Auth Proxy).
service_annotations / service_labels{}Appliqué au service Kubernetes à la création uniquement ; App_GKE ignore les modifications ultérieures.

Groupe 5 : Variables d'environnement et secrets​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Comportement spécifique à Stalwart :

Stalwart_Common définit deux variables d'environnement, et environment_variables est fusionné par-dessus :

VariableValeur par défautObjectif
STALWART_PUBLIC_URL""URL de base publiée pour la découverte OAuth, OIDC et JMAP. Laissée vide volontairement — une mauvaise valeur est transmise aux clients dans les documents de découverte. Le wrapper n'a pas d'entrée dédiée pour cela ; définissez-la via environment_variables une fois que vous avez un domaine (par exemple https://mail.example.com).
STALWART_DATASTORE_TYPE"MySql"Le @type DataStore que le point d'entrée rend, dérivé du moteur Stalwart_Common provisionné. Ne le remplacez pas.

Le point d'entrée lit également STALWART_DB_USE_TLS et STALWART_DB_ALLOW_INVALID_CERTS (tous deux par défaut false) pour la connexion DataStore ; les valeurs par défaut sont correctes pour Cloud SQL sur l'IP privée.

Administrateur de démarrage — définissez-le :

L'administrateur de Stalwart est fourni comme STALWART_RECOVERY_ADMIN, avec la valeur username:password. Stockez-le dans Secret Manager et mappez-le dans secret_environment_variables :

printf 'admin:%s' "$(openssl rand -base64 24)" | \
gcloud secrets create stalwart-recovery-admin --data-file=- --project "$PROJECT"
secret_environment_variables = {
STALWART_RECOVERY_ADMIN = "stalwart-recovery-admin"
}

Sans cela, Stalwart génère un mot de passe administrateur aléatoire et l'imprime dans le journal du conteneur une seule fois ; le point d'entrée enregistre recovery_admin=<unset - a random password will be printed below> juste avant.

Les variables de secrets restantes (secret_rotation_period, secret_propagation_delay, protect_sensitive_environment_variables) se comportent comme décrit dans App_GKE.


Groupe 6 : Service Kubernetes, charge de travail et ports​

VariableValeur par défautNotes
service_type"LoadBalancer"Un équilibreur de charge réseau externe passthrough (networking.gke.io/load-balancer-type: External). Les protocoles de messagerie en ont besoin — une passerelle/Ingress ne transporte que du HTTP.
service_port443Port de service principal (nommé http), ciblant le port de conteneur 443.
session_affinity"ClientIP"Les requêtes provenant d'une même IP client vont vers le même pod.
workload_type"StatefulSet"Identité stable plus le PVC par pod du groupe 7.
namespace_name""Dérivé du nom du service lorsqu'il est vide.
enable_network_segmentationfalseNetworkPolicies Kubernetes.
termination_grace_period_seconds30Secondes entre SIGTERM et SIGKILL.

Carte des ports. extra_service_ports (une entrée du groupe 0, gérée par la plateforme) ajoute les ports de messagerie au même service. Chacun cible le même port sur le conteneur et utilise TCP :

PortNomProtocole
443httpHTTPS — interface d'administration, JMAP, /healthz/live. TLS est terminé par Stalwart, pas par Google.
25smtpSMTP. Entrant uniquement en pratique — Google Cloud bloque le port 25 sortant.
465submissionsSoumission SMTP, TLS implicite.
587submissionSoumission SMTP (STARTTLS) ; également le port pour relayer le courrier sortant via un hôte intelligent.
993imapsIMAP, TLS implicite.
995pop3sPOP3, TLS implicite.
4190managesieveManageSieve (vérifié pour renvoyer la propre bannière de Stalwart).

IMAP (143) et POP3 (110) en texte clair sont omis volontairement — les ports TLS implicites font le même travail sans chemin d'accès aux identifiants en clair. Le port 8080 n'est pas publié. GKE crée automatiquement les règles de pare-feu pour un service LoadBalancer. La description de la variable elle-même indique toujours qu'elle est "déclarée mais NON transférée" ; ce texte est obsolète — main.tf la transfère à App_GKE.


Groupe 7 : Charges de travail avec état​

VariableValeur par défautNotes
stateful_pvc_enabledtrueUn PVC par pod.
stateful_pvc_mount_path"/var/lib/stalwart"Répertoire de travail et état local de Stalwart. Le courrier lui-même est stocké dans le DataStore Cloud SQL.
stateful_pvc_size"10Gi"Taille de chaque PVC.
stateful_pvc_storage_class"standard-rwo"PD équilibré. Les modèles de PVC StatefulSet sont immuables — choisissez la classe avant le premier déploiement.
stateful_fs_group0fsGroup du pod.
stateful_headless_service, stateful_pod_management_policy, stateful_update_strategynullValeurs par défaut App_GKE (OrderedReady, RollingUpdate).

/etc/stalwart n'est délibérément pas persisté — config.json est régénéré à partir des variables de la plateforme à chaque démarrage.


Groupe 9 : Politiques de fiabilité​

enable_pod_disruption_budget (true) et pdb_min_available ("1"). App_GKE crée le PDB uniquement lorsque max_instance_count > 1 ; avec le max_instance_count = 1 recommandé, aucun PDB n'existe. Voir App_GKE.


Groupe 10 : Observabilité et santé​

Contrairement aux wrappers dont les sondes proviennent des propres variables de leur module _Common, Stalwart GKE transmet startup_probe_config et health_check_config à Stalwart_Common, de sorte que ces deux entrées sont les sondes sur le conteneur Stalwart.

Sonde de démarrage (startup_probe_config) :

ChampValeur par défautNotes
type"TCP"Connexion TCP à container_port (443). Ne pas passer à HTTP — la sonde ne peut pas parler HTTPS.
initial_delay_seconds60
timeout_seconds5
period_seconds10
failure_threshold3

Sonde de vivacité (health_check_config) : TCP, initial_delay_seconds = 60, timeout_seconds = 5, period_seconds = 30, failure_threshold = 3.

Ce que la sonde détecte. Elle fait échouer un serveur qui n'a pas démarré (seul le port 8080 est alors lié). Elle ne fait pas échouer un serveur qui a démarré avec son DataStore connecté mais sans configuration de serveur — le port 443 est également lié dans cet état, et sur le déploiement vérifié, les ports 443 et 8080 ont répondu /healthz/live avec 200. Vérifier que le port 8080 est fermé est une tâche d'opérateur :

kubectl exec -n "$NS" <pod> -- curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8080/healthz/live

Un serveur entièrement configuré refuse cette connexion. Ne redirigez pas une sonde défaillante vers le port 8080.

uptime_check_config est par défaut { enabled = false, path = "/" }. Sans passerelle, le test de disponibilité de App_GKE est un test HTTP simple (sans SSL) contre service_port sur l'adresse externe — mais Stalwart sert le port 443 uniquement via HTTPS, alors laissez-le désactivé.


Groupe 11 : Jobs et services additionnels​

Aucun job d'initialisation n'est défini — laissez initialization_jobs = []. cron_jobs et additional_services se comportent comme dans App_GKE.


Groupe 12 : CI/CD et autorisation binaire​

Identique à App_GKE. Voir App_GKE.


Groupes 13 et 14 : Stockage​

VariableValeur par défautNotes
enable_nfstrueMonte un partage NFS à nfs_mount_path ("/mnt/nfs"). Stalwart ne le lit ni ne l'écrit ; son état est sur le PVC et dans Cloud SQL.
create_cloud_storagetrueCrée le bucket générique data à partir de storage_buckets. Stalwart_Common ne déclare aucun de ses propres buckets.
gcs_volumes[]Pas de montages GCS FUSE par défaut.

Les autres entrées de stockage et de rétention d'images se comportent comme dans App_GKE.


Groupe 15 : Redis​

enable_redis est par défaut false ; laissez-le désactivé. Redis ne serait nécessaire que pour plusieurs réplicas, et la connexion Redis de Stalwart est une URL (redis://user:pass@host:port), dans laquelle une chaîne AUTH Memorystore devrait être encodée en pourcentage — le module ne le fait pas.


Groupe 16 : Base de données​

VariableValeur par défautNotes
database_type"MYSQL_8_0"Utilisé uniquement pour la validation au moment du plan. Le moteur provisionné et rendu dans config.json est défini par Stalwart_Common (MySQL 8.0) ; le wrapper ne lui transmet pas cette valeur.
application_database_name / application_database_user"stalwart"Inerte — la fondation nomme la base de données et l'utilisateur d'après le service.
database_password_length32Ne pas modifier sur un déploiement en cours — cela écrit un nouveau mot de passe dans Secret Manager sans mettre à jour l'utilisateur de la base de données.
enable_postgres_extensionsfalseNon applicable à MySQL ; laissez false.
enable_auto_password_rotation / rotation_propagation_delay_secfalse / 90Stalwart lit le mot de passe de la variable d'environnement DB_PASSWORD, donc un mot de passe renouvelé prend effet lorsque le pod est redémarré après le renouvellement.

Groupe 17 : Sauvegarde​

Identique à App_GKE : backup_schedule ("0 2 * * *", un CronJob Kubernetes), backup_retention_days (7, une règle de cycle de vie sur le bucket de sauvegardes), et les entrées de restauration enable_backup_import / backup_source / backup_file / backup_format.


Groupe 18 : Scripts SQL personnalisés​

Identique à App_GKE. Les scripts s'exécutent sur la base de données Stalwart via l'IP privée. Ne modifiez pas les tables que Stalwart possède.


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

VariableValeur par défautNotes
reserve_static_iptrueRéserve une IP externe statique régionale et l'attribue au service LoadBalancer, de sorte que les enregistrements MX et DNS aient une cible stable. (Elle n'est pas appliquée lorsque Cloud Deploy est activé.)
static_ip_name""Auto-généré comme <service-name>-lb-ip lorsqu'il est vide.
enable_custom_domainfalseLaissez false. true crée une passerelle, qui est HTTP uniquement et duplique le port 443 déjà sur le LoadBalancer — et utilise une autre IP externe.
application_domains[]Utilisé uniquement avec une passerelle.
network_tags["nfsserver"]Tags réseau de nœud/pod.

Groupes 20-22 : IAP, Cloud Armor et CDN, Contrôles de service VPC​

enable_iap, enable_cloud_armor et enable_cdn agissent tous sur une passerelle (HTTP) ; l'activation de Cloud Armor ou CDN en crée une. Aucun d'entre eux ne protège les ports de messagerie sur le LoadBalancer. Les contrôles de service VPC et la journalisation d'audit (Groupe 22) sont identiques à App_GKE.


Gardes de validation​

validation.tf fait échouer le plan lorsque min_instance_count > max_instance_count ; lorsque enable_redis = true sans redis_host ni enable_nfs ; lorsque enable_iap = true sans les deux champs client OAuth ; ou lorsque enable_cloudsql_volume = true avec database_type = "NONE".


Exploration du déploiement​

Console Google Cloud​

  • Kubernetes Engine → Charges de travail — le StatefulSet Stalwart et son pod.
  • Kubernetes Engine → Passerelles, services et Ingress — le service LoadBalancer avec ses sept ports et son IP externe.
  • Réseau VPC → Adresses IP — l'adresse …-lb-ip réservée.
  • SQL — l'instance Cloud SQL contenant la base de données Stalwart.
  • Secret Manager — le mot de passe de la base de données et votre secret STALWART_RECOVERY_ADMIN.

gcloud CLI et kubectl​

# Cluster credentials
gcloud container clusters get-credentials <cluster-name> --region "$REGION" --project "$PROJECT"

# Namespace, pod, Service and PVC
NS=$(kubectl get ns -o name | grep stalwart | head -1 | cut -d/ -f2)
kubectl get statefulset,pods,svc,pvc -n "$NS"

# The ports published on the LoadBalancer
kubectl get svc -n "$NS" -o jsonpath='{range .items[*].spec.ports[*]}{.name}{"\t"}{.port}{"\n"}{end}'

# Startup lines written by the entrypoint (DataStore target, admin state)
kubectl logs -n "$NS" statefulset/"$(kubectl get statefulset -n "$NS" -o jsonpath='{.items[0].metadata.name}')" | grep '\[startup\]'

# Health from inside the pod (443 must answer; 8080 should refuse once configured)
POD=$(kubectl get pods -n "$NS" -o jsonpath='{.items[0].metadata.name}')
kubectl exec -n "$NS" "$POD" -- curl -sk -o /dev/null -w '%{http_code}\n' https://127.0.0.1:443/healthz/live
kubectl exec -n "$NS" "$POD" -- curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/healthz/live

# Database password secret
gcloud secrets list --project "$PROJECT" --filter="name~stalwart"

Sorties du module​

SortieDescription
service_nameNom du service Kubernetes
namespaceEspace de noms Kubernetes
service_cluster_ipClusterIP du service
service_external_ipIP externe du LoadBalancer — l'adresse vers laquelle pointent les clients de messagerie et les enregistrements MX
service_urlRendu comme http:// plus l'IP externe. Stalwart répond en HTTPS sur le port 443, utilisez donc https:// + service_external_ip.
database_instance_name / database_name / database_userInstance Cloud SQL, base de données et utilisateur
database_password_secretSecret Manager secret contenant le mot de passe de la base de données
database_hostRapporte toujours 127.0.0.1 (le proxy par défaut du socle) ; Stalwart se connecte en fait à l'IP privée de Cloud SQL
database_portPort de la base de données
storage_bucketsBuckets GCS créés
container_imageImage de conteneur utilisée pour le déploiement
initialization_jobs / db_import_jobNoms des jobs
cicd_enabled / github_repository_urlStatut CI/CD
kubernetes_readytrue lorsque le point de terminaison du cluster était accessible et que les ressources Kubernetes étaient déployées

Pièges de configuration et valeurs par défaut judicieuses​

Niveaux de risque : Critique (perte de données, panne totale, faille de sécurité) — Élevé (service indisponible ou dégradation significative) — Moyen (fonction dégradée ou coût accru) — Faible (impact mineur).

VariableValeur par défaut judicieuseRisqueConséquence d'une valeur incorrecte
startup_probe_config / health_check_configtype = "TCP"CritiqueUne sonde HTTP ne peut pas vérifier le port 443 HTTPS uniquement de Stalwart et fera échouer un pod sain. Le port de la sonde est fixé à 443 par Stalwart_Common ; ne contournez jamais une sonde défaillante en ciblant le port 8080, qui répond précisément lorsque Stalwart n'est pas configuré ou n'a pas démarré.
container_image_source"custom"CritiqueSans le wrapper, il n'y a pas de config.json ; Stalwart ouvre le port 8080 en mode bootstrap et ne sert aucun courrier.
STALWART_RECOVERY_ADMINDéfini via secret_environment_variablesÉlevéNon défini, le seul mot de passe administrateur est imprimé une fois dans les logs du conteneur.
max_instance_count1ÉlevéLe 3 par défaut permet au HPA d'ajouter des réplicas, qui nécessitent un coordinateur basé sur Redis que le module ne configure pas, et crée un PDB.
Configuration du serveur (domaines, écouteurs, TLS)Appliquer avec stalwart-cli après le déploiementÉlevéNon effectué par le module. Tant que ce n'est pas fait, le port 8080 reste ouvert dans le pod et les connexions TLS externes ont été observées comme étant fermées sans certificat.
Courrier sortantSmart host sur le port 587ÉlevéGoogle Cloud bloque le port 25 sortant ; la livraison MX directe vers d'autres domaines ne peut pas fonctionner.
database_password_lengthLaisser inchangéÉlevéLe modifier sur un déploiement en cours rompt l'authentification de la base de données.
application_versionUne balise de version exacteMoyenUne reconstruction sous une balise inchangée ne crée pas de nouveau modèle de pod ; kubectl rollout restart tire l'image reconstruite (politique de tirage Always).
enable_custom_domain / enable_cloud_armor / enable_cdnfalseMoyenChacun crée une Gateway qui ne transporte que du HTTP et consomme une autre IP externe ; les ports de messagerie ne sont pas affectés.
reserve_static_iptrueMoyenAvec false, le LoadBalancer obtient une IP éphémère qui change chaque fois que le service est recréé — les enregistrements MX deviendraient obsolètes.
stateful_pvc_storage_class / stateful_pvc_sizeDécider avant le premier déploiementMoyenLes modèles de PVC StatefulSet sont immuables ; les modifications ultérieures ne s'appliquent pas au PVC existant.
application_display_name"Stalwart Mail Server"FaibleLa valeur par défaut fournie affiche Wiki.js dans la Console et les tableaux de bord.
enable_nfsfalse si rien d'autre n'en a besoinFaiblePar défaut true et monte un partage NFS que Stalwart n'utilise jamais.

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