Aller au contenu principal

Chatwoot sur GKE Autopilot

Chatwoot sur GKE Autopilot

Chatwoot est une plateforme open source multicanal de service client et d'engagement client (e-mail, chat en direct, boîtes de réception sociales et de messagerie, suivi des SLA et rapports) qui sert d'alternative conforme au RGPD à Zendesk ou Intercom. Ce module déploie Chatwoot 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 Chatwoot et sur la façon de les explorer et de les exploiter à partir de la console Google Cloud et de la ligne de commande. Pour les mécanismes communs à chaque application 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 Chatwoot sur RAD, et comment cela se compare​

Le module Chatwoot sur GKE Autopilot de RAD coûte environ 150 $ US par mois dans votre propre projet Google Cloud, sans frais de licence supplémentaires — Chatwoot est open source. Dans un projet géré par RAD pour vous, le même déploiement est facturé à 141 crédits par jour (environ 4 230 par mois, soit environ 423 $ US au prix de la recharge). Ou consultez le guide Cloud Run pour l'option moins chère. Si vous n'avez besoin de Chatwoot qu'occasionnellement — pour des études, une démo, 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, de sorte que ce chiffre mensuel ne représente que quelques dollars. Voir Mettre en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Chatwoot est open source, il n'y a donc pas de frais de licence. Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement300 crédits (30 $ US au prix de la recharge)270 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minuteIdentique
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 150 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 141 crédits par jour, environ 4 230 par mois (environ 423 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde acheté minimum est conservé en réserve

10 crédits coûtent 1 $ US pour une recharge unique, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

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

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 2x vCPU / 4 GiB79,35 $ US
Cloud SQL pour PostgreSQL, 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
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Total (hors frais de cluster GKE partagés)environ 150 $ US

Les prix de Cloud SQL et Cloud Run/GKE sont les mêmes en africa-south1 (Johannesburg) ; la petite VM coûte environ 10 % de plus là-bas.

  • GKE Autopilot ne se met pas à l'échelle à zéro. Au moins un pod est toujours en cours d'exécution, de sorte que le coût ci-dessus s'applique que l'application soit utilisée ou non ; des pods supplémentaires ne sont ajoutés qu'en cas de charge.

Comparaison pour une équipe de dix agents​

L'équipe de Chatwoot vend Chatwoot Cloud hébergé par agent :

OptionPar mois (10 agents)Notes
Chatwoot Cloud, Hacker0 $ USTier gratuit, limité
Chatwoot Cloud, Startups190 $ US (19 $ US/agent)Hébergé par Chatwoot
Chatwoot Cloud, Business390 $ US (39 $ US/agent)Hébergé par Chatwoot, le plus populaire
Chatwoot Cloud, Enterprise990 $ US (99 $ US/agent)Hébergé par Chatwoot
RAD, Cloud Run, votre propre projetEnviron 102 $ US, plus 11 $ US une fois par déploiementL'automatisation de RAD, dans votre projet
RAD, Cloud Run, un projet géré par RADEnviron 960 crédits (96 $ US)RAD
  • Le prix de Chatwoot Cloud augmente avec chaque siège d'agent ; le coût de RAD est celui de l'infrastructure. Pour dix agents, le coût d'exécution de RAD dans votre propre projet est déjà inférieur au tier payant le moins cher de Chatwoot Cloud.
  • Un serveur bon marché est bon marché jusqu'à ce que quelque chose tombe en panne. Sur RAD, la base de données est Cloud SQL avec des sauvegardes automatisées, et les secrets vivent dans Secret Manager. Sur votre propre serveur, chacun de ces éléments est un travail que quelqu'un doit faire.

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

Si Chatwoot s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet — plutôt que la suppression de ce seul module — délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement. Google le conserve, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant cette période. 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.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut demander à Google de récupérer le projet et de rattacher son compte de facturation, puis d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes, et une mise à jour ne facture plus les frais de module. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), de sorte qu'une restauration ne coûte normalement aucun crédit.
  • Ce que cela nécessite. Vous devez posséder le projet (pas un projet pour lequel RAD ne gère que la facturation), le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et effacer à nouveau le seuil d'admission du tier (100 crédits pour le tier sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage désactivée, il est donc très probable qu'il disparaisse dès que le projet est supprimé — même si le projet lui-même est récupérable pendant 30 jours. Copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer s'il y a quelque chose d'important à conserver ; pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Source : Supprimer et restaurer des projets.

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

Dans votre propre projet, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est 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) : 300 crédits (30,00 $ US) au prix de la recharge. La suppression ne permet d'économiser de l'argent que si Chatwoot resterait inutilisé pendant environ 4 jours ou plus — dans votre propre projet, cela représente environ 4,99 $ US par jour, et dans un projet géré par RAD, c'est 141 crédits par jour.
  • La majeure partie du coût d'exécution ici est généralement la base de données et/ou la VM de fichier/cache partagée ou le cluster. Ils ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, de sorte que la suppression de Chatwoot pendant qu'une autre application partage le projet n'économise que la partie calcul de Chatwoot.
  • Conserver les données en premier. 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 cabinets de conseil. Un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

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

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et la mise en garde sur le bucket de sauvegarde ; Tarification Chatwoot Cloud ; les prix changent, vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Chatwoot s'exécute comme une seule charge de travail Ruby on Rails qui combine le serveur web et un worker Sidekiq en arrière-plan dans un seul pod. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotRails + worker Sidekiq co-localisé sur le port 3000, 2 vCPU / 4 GiB par défaut
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — le moteur est fixé à POSTGRES_15 ; l'extension vector (pgvector) est activée pour les fonctionnalités d'IA/recherche de Chatwoot
Cache et file d'attenteRedis (VM NFS hébergée sur Cloud Filestore, ou externe)Prend en charge la file d'attente de jobs de Sidekiq et le pub/sub ActionCable
Persistance des fichiersCloud Filestore (NFS)Les pièces jointes persistent sous /opt/chatwoot/storage, partagées entre les pods
Stockage d'objetsCloud StorageUn bucket storage suffixé provisionné automatiquement
SecretsSecret ManagerSECRET_KEY_BASE Rails auto-généré ; mot de passe de la base de données
IngressCloud Load BalancingLoadBalancer externe avec une IP statique réservée ; domaine personnalisé facultatif + certificat géré

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

  • PostgreSQL 15 est obligatoire. database_type par défaut à POSTGRES_15 ; le schéma de Chatwoot et les fonctionnalités basées sur pgvector l'exigent.
  • Image personnalisée. container_image_source = "custom" — le module Common construit FROM chatwoot/chatwoot:${APP_VERSION} et superpose un point d'entrée cloud qui mappe les variables d'environnement DB_*/REDIS_* de la fondation sur la convention POSTGRES_*/REDIS_URL de Chatwoot et lance Sidekiq en arrière-plan avant d'exécuter le serveur Rails. L'image s'exécute en tant que root — correspondant à l'image amont, dont /app//app/tmp sont propriétaires de root et non inscriptibles par le groupe, de sorte que l'étape create_tmp_directories de Rails nécessite root pour réussir.
  • Cloud SQL est accessible via le sidecar Auth Proxy sur loopback. enable_cloudsql_volume = true exécute un sidecar cloud-sql-proxy écoutant sur 127.0.0.1:5432 ; le point d'entrée mappe les DB_HOST/DB_IP injectés sur POSTGRES_HOST.
  • Deux jobs d'initialisation s'exécutent en séquence. db-init (crée la base de données, le rôle et les autorisations — y compris une autorisation cloudsqlsuperuser pour que Chatwoot puisse créer lui-même des extensions Postgres) s'exécute en premier, puis chatwoot-prepare (rails db:chatwoot_prepare) crée/met à jour le schéma et initialise les valeurs par défaut. Il n'y a pas d'étape de migration dans le conteneur ; la configuration du schéma se fait entièrement dans ces deux Jobs avant que le conteneur de l'application n'ait besoin de servir le trafic.
  • Redis est activé par défaut (enable_redis = true). Laissez redis_host vide pour utiliser l'IP Redis partagée hébergée sur le serveur NFS que la fondation injecte automatiquement.
  • SECRET_KEY_BASE est généré une fois et partagé entre le processus web Rails et le worker Sidekiq (ils s'exécutent dans le même conteneur ici, mais la valeur doit également rester stable lors des redémarrages/redéploiements — Rails l'utilise pour signer les sessions et chiffrer les colonnes chiffrées d'ActiveRecord).
  • L'affinité de session est ClientIP afin que les requêtes d'un client atteignent le même pod.
  • PodDisruptionBudget est activé par défaut (enable_pod_disruption_budget = true, pdb_min_available = "1").
  • ENABLE_ACCOUNT_SIGNUP par défaut à "false" — l'inscription libre-service administrateur/agent est désactivée sur un helpdesk fraîchement déployé ; activez-la via environment_variables si vous souhaitez une inscription publique.

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

Les pods Chatwoot sont planifiés sur Autopilot, qui facture le CPU/la mémoire réellement demandés par les pods. Chaque pod exécute à la fois le serveur web Rails et un processus worker Sidekiq en arrière-plan, de sorte que la charge de travail ne doit pas être mise à l'échelle à zéro — Sidekiq est ce qui délivre/reçoit les messages de canal et traite les jobs en arrière-plan.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Chatwoot pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

Chatwoot stocke toutes les données de l'application (conversations, contacts, boîtes de réception, agents, rapports) dans une instance Cloud SQL pour PostgreSQL 15 gérée, y compris l'extension vector utilisée par ses fonctionnalités d'IA/recherche. Les pods l'atteignent via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1:5432 ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init crée la base de données de l'application, le rôle et les autorisations (y compris une autorisation cloudsqlsuperuser pour que les propres appels de création d'extension de Chatwoot réussissent), puis le job chatwoot-prepare exécute rails db:chatwoot_prepare pour construire le schéma.

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

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

C. Redis (cache, file d'attente et pub/sub)​

Sidekiq (la file d'attente de jobs en arrière-plan de Chatwoot) et ActionCable (mises à jour de l'interface utilisateur en temps réel) nécessitent tous deux Redis. enable_redis = true par défaut ; lorsque redis_host est laissé vide, la fondation injecte l'IP Redis partagée hébergée sur le serveur NFS en tant que REDIS_HOST, et le point d'entrée du conteneur construit REDIS_URL à partir de celle-ci au démarrage. Pointez redis_host/redis_port/redis_auth vers une instance Cloud Memorystore dédiée pour une charge de travail de production plus lourde.

Sidekiq nécessite Redis 6.2 ou plus récent, et le Redis hébergé sur NFS est 6.0. Le Redis partagé sur la VM NFS exécute la version 6.0.16, et Sidekiq 7 refuse de démarrer avec. L'interface utilisateur web fonctionne toujours (le point d'entrée met Sidekiq en arrière-plan), de sorte que le déploiement semble sain alors qu'aucun job en arrière-plan ne s'exécute. Pointez redis_host vers une instance Redis 6.2+ — par exemple Memorystore, via create_redis = true dans Services_GCP, qui provisionne Redis 7.2.

  • Console : Memorystore → Instances Redis (si vous utilisez une instance dédiée).
  • CLI :
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E '^REDIS_'
    gcloud redis instances list --project "$PROJECT" --region "$REGION"

Voir App_GKE pour la façon dont le Redis hébergé sur NFS et l'intégration de Memorystore sont câblés.

D. Cloud Storage et persistance des fichiers (NFS)​

Un bucket Cloud Storage dédié (suffixe storage) est provisionné automatiquement et le compte de service de la charge de travail est autorisé à y accéder. Séparément, les pièces jointes de Chatwoot résident sur NFS (Cloud Filestore) à /opt/chatwoot/storage, partagées entre les pods.

  • Console : Cloud Storage → Buckets ; Filestore → Instances.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
    gcloud filestore instances list --project "$PROJECT"
    kubectl get pvc -n "$NAMESPACE"

Voir App_GKE pour les options CMEK et les montages GCS Fuse.

E. Secret Manager​

Un secret spécifique à Chatwoot est généré automatiquement et stocké dans Secret Manager : SECRET_KEY_BASE (clé de signature de session/chiffrement ActiveRecord de Rails, partagée identiquement entre les processus web et Sidekiq). Le mot de passe de la base de données est géré séparément par la fondation. Sur GKE, les secrets sont projetés dans les pods via le pilote CSI Secret Store.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~chatwoot"
    gcloud secrets versions access latest --secret=secret-<resource-prefix>-chatwoot-secret-key-base --project "$PROJECT"

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

F. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP Cloud Load Balancing externe (service_type = LoadBalancer, reserve_static_ip = true afin que l'adresse survive aux redéploiements). Un domaine personnalisé avec un certificat géré par Google peut être activé.

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

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails des IP statiques.

G. Cloud Logging et Monitoring​

Les sorties standard/erreur des pods (les processus Rails et Sidekiq, car ils partagent un conteneur) sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des politiques d'alerte facultatifs sont disponibles.

  • 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

Voir App_GKE pour la gestion des tests de disponibilité et le câblage des politiques d'alerte.


3. Comportement de l'application Chatwoot​

  • La configuration de la base de données au premier déploiement s'exécute sous forme de deux jobs chaînés. db-init (image postgres:15-alpine) se connecte à Cloud SQL, crée de manière idempotente le rôle et la base de données, accorde les privilèges, accorde cloudsqlsuperuser au rôle de l'application (nécessaire car l'utilisateur de l'application Cloud SQL n'est pas un véritable super-utilisateur Postgres et db:chatwoot_prepare's schema.rb appelle enable_extension pour plusieurs extensions), et pré-crée vector, pg_stat_statements, pg_trgm, et pgcrypto de manière défensive. chatwoot-prepare dépend ensuite de db-init et exécute bundle exec rails db:chatwoot_prepare en utilisant l'image de l'application Chatwoot construite (pas une image client générique) afin que la chaîne d'outils et la configuration Rails complètes soient présentes. Les deux jobs s'exécutent sur execute_on_apply = true.
  • Pas de migrations dans le conteneur. La création/mise à jour du schéma est entièrement gérée par le job d'initialisation chatwoot-prepare avant que le conteneur de l'application ne soit censé servir le trafic — le point d'entrée d'exécution n'exécute pas rails db:migrate.
  • Alias de variables d'environnement de base de données. La plateforme injecte DB_HOST (le sidecar proxy, 127.0.0.1 sur GKE), DB_PORT, DB_NAME, DB_USER, DB_PASSWORD ; le point d'entrée cloud (cloud-entrypoint.sh, intégré à l'image) mappe ceux-ci sur la convention POSTGRES_HOST/POSTGRES_PORT/POSTGRES_DATABASE/POSTGRES_USERNAME/POSTGRES_PASSWORD de Chatwoot.
  • L'URL Redis est auto-réparatrice. Si REDIS_URL n'est pas déjà défini, le point d'entrée le construit à partir des REDIS_HOST/REDIS_PORT/REDIS_AUTH injectés — cela couvre à la fois le cas explicite redis_host et le cas de repli NFS par défaut, de sorte que laisser redis_host vide produit toujours un REDIS_URL fonctionnel au démarrage du conteneur.
  • Sidekiq s'exécute co-localisé, en arrière-plan. cloud-entrypoint.sh démarre bundle exec sidekiq -C config/sidekiq.yml & avant d'exécuter le serveur Rails ; un trap sur TERM/INT arrête Sidekiq en même temps que le conteneur. Étant donné que Sidekiq traite les jobs en arrière-plan (livraison de canaux, notifications, rapports) uniquement tant qu'un pod est actif, conservez min_instance_count >= 1 en production.
  • Compte administrateur/première exécution. L'interface utilisateur d'intégration de Chatwoot crée le premier compte administrateur de manière interactive à /installation/onboarding lors de la première visite — il n'y a pas de secret d'identifiant administrateur auto-généré pour ce module.
  • Chemin de santé. La sonde de démarrage est HTTP GET / ; la sonde de vivacité est GET /health, car elle est mise en miroir dans la vérification de santé de la passerelle, qui nécessite un 200 littéral et / redirections. La sonde de disponibilité définie par le module Common (initial_delay_seconds = 30) cible /. Laissez du temps au premier démarrage — chatwoot-prepare doit se terminer avant même que le conteneur de l'application ne démarre.
  • Signal d'arrêt du proxy Cloud SQL. Les deux jobs d'initialisation wget/curl-POST vers le point de terminaison --quitquitquit du sidecar proxy (127.0.0.1:9091/quitquitquit) à la sortie afin que le pod du job se termine au lieu de rester bloqué sur un sidecar actif.
  • Les mises à jour recréent le pod au lieu de le déployer. Parce que enable_nfs = true par défaut, App_GKE déploie la charge de travail avec la stratégie Recreate plutôt que RollingUpdate — deux pods en concurrence pour le même volume de montage NFS et la base de données partagée se bloqueraient sur le pod de surtension lors d'un déploiement (vérifié en direct via un déploiement NFS Chatwoot). Une augmentation de version ou un changement de configuration qui touche le modèle de pod entraîne donc un bref temps d'arrêt pendant que l'ancien pod se termine avant que le nouveau ne démarre, plutôt qu'un déploiement sans temps d'arrêt.
  • Inspectez les jobs d'initialisation et la configuration en cours d'exécution :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
    kubectl logs -n "$NAMESPACE" job/<chatwoot-prepare-job-name>
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E 'POSTGRES_|REDIS_'

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 Chatwoot 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 3 — Identité de l'application​

VariableValeur par défautDescription
application_namechatwootNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionv4.15.1Tag d'image chatwoot/chatwoot utilisé comme base de build personnalisé. Incrémenter pour déclencher une reconstruction.

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

VariableValeur par défautDescription
container_resources.cpu_limit2000m2 vCPU — Rails + worker Sidekiq co-localisé.
container_resources.memory_limit4Gi4 GiB minimum recommandé ; les deux processus partagent le conteneur.
min_instance_count1Maintenir à 1 pour que le worker Sidekiq (et ActionCable) reste actif.
max_instance_count5Plafond de mise à l'échelle horizontale standard.
container_port3000Port du serveur Rails de Chatwoot.
container_image_sourcecustomConstruit sur mesure à partir de chatwoot/chatwoot ; ne pas définir à prebuilt.
enable_cloudsql_volumetrueSidecar Auth Proxy (loopback) — requis sur GKE.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour l'interface utilisateur de Chatwoot.
workload_typenull → DeploymentDéploiement standard (pas de PVC nécessaire par défaut).
session_affinityClientIPRoutage persistant pour qu'un client atteigne le même pod.

Groupe 9 — Fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueLimite les évictions volontaires simultanées de pods.
pdb_min_available"1"Maintient au moins un pod (et son worker Sidekiq) disponible pendant les perturbations.

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

VariableValeur par défautDescription
enable_nfstrueNFS est activé par défaut pour que les pièces jointes persistent et soient partagées.
nfs_mount_path/opt/chatwoot/storageOù Chatwoot stocke les pièces jointes téléchargées.

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redistrueRequis pour la mise en file d'attente Sidekiq et le pub/sub ActionCable ; transmis à la fondation sans condition.
redis_host""Vide utilise l'IP Redis partagée hébergée sur le serveur NFS que la fondation injecte.
redis_port6379Port TCP Redis.
redis_auth""Mot de passe d'authentification Redis, si l'instance cible en nécessite un.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixé par la sortie de configuration du module Common (également codé en dur dans le config.database_type Common) ; Chatwoot nécessite PostgreSQL 15+ avec pgvector.
application_database_namechatwootNom de la base de données. Immuable après le premier déploiement.
application_database_userchatwootUtilisateur de la base de données de l'application ; mot de passe auto-généré dans Secret Manager.
enable_postgres_extensionstrue (valeur par défaut Common)Active vector après le provisionnement ; db-init.sh le pré-crée également de manière défensive.

Groupe 1 — Recherche et intégrations optionnelles​

VariableValeur par défautDescription
elasticsearch_url""Point de terminaison Elasticsearch optionnel (par exemple, de Elasticsearch_GKE) pour la recherche en texte intégral de Chatwoot. Laisser vide pour désactiver.
elasticsearch_username""Nom d'utilisateur Elasticsearch ; laisser vide lorsque xpack.security.enabled est faux.
elasticsearch_password_secret""ID du secret Secret Manager contenant le mot de passe Elasticsearch ; lorsqu'il est défini, injecté en tant que ELASTICSEARCH_PASSWORD et accordé secretAccessor.

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

VariableValeur par défautDescription
reserve_static_iptrueIP externe stable lors des redéploiements.
application_domains[]Noms d'hôtes personnalisés + certificat géré.

Toutes les autres entrées suivent le comportement standard de App_GKE.


5. Sorties​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Chatwoot.
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 de la base de données (127.0.0.1 via l'Auth Proxy) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration (db-init, chatwoot-prepare) et d'importation (facultatif).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment de la planification. Ce module transmet sa configuration via le moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — paramètres de type de charge de travail/PVC non concordants, IAP activé sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. Une configuration invalide échoue la planification avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15 (fixé par Common)CritiqueLe schéma de Chatwoot et la recherche basée sur pgvector nécessitent Postgres 15+ ; tout autre moteur casse chatwoot-prepare.
application_database_name / application_database_userDéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et orpheline toutes les données.
SECRET_KEY_BASE (auto-généré)Ne jamais changerCritiqueSa rotation invalide chaque session/cookie signé et rend les colonnes chiffrées d'ActiveRecord définitivement illisibles ; Sidekiq échouera également à déchiffrer les jobs en cours.
enable_redistrue (transmis sans condition)CritiqueSidekiq (jobs en arrière-plan, livraison de canaux) et ActionCable (interface utilisateur en temps réel) nécessitent tous deux Redis ; le désactiver casse silencieusement la livraison des messages même si l'interface utilisateur web se charge.
min_instance_count1ÉlevéEn dessous de 1, le worker Sidekiq co-localisé ne s'exécute pas entre les requêtes, de sorte que les jobs en arrière-plan (interrogation de canaux, notifications, rapports) stagnent entre les démarrages à froid.
enable_nfstrueÉlevéLe désactiver rend les pièces jointes téléchargées éphémères — perdues lors de la recréation du pod. Le laisser activé change également la stratégie de déploiement en Recreate (bref temps d'arrêt par mise à jour) au lieu de RollingUpdate — attendu, pas un bug.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy sur 127.0.0.1:5432 est requis pour la connectivité de la base de données sur GKE.
Ordre des jobs chatwoot-prepareS'exécute après db-init (depends_on_jobs = ["db-init"])ÉlevéL'exécution de la préparation du schéma avant l'existence des autorisations de base de données/rôle/extension échoue le job (must be superuser sur CREATE EXTENSION, ou la base de données/le rôle manquant entièrement).
container_image_sourcecustomÉlevéChatwoot est une image pré-construite Docker Hub enveloppée dans un point d'entrée personnalisé (mappage d'environnement + lancement de Sidekiq) ; passer à prebuilt ignore ce wrapper et le conteneur ne mappera pas DB_*/REDIS_* correctement.
pdb_min_available"1"MoyenLa maintenance/les mises à niveau volontaires des nœuds pourraient autrement évincer le seul pod exécutant Sidekiq, interrompant le traitement en arrière-plan.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer lors des redéploiements, cassant le DNS et toutes les URL de webhook/rappel de canal configurées.
ENABLE_ACCOUNT_SIGNUP"false" (par défaut)MoyenLaisser l'inscription libre-service publique activée sur un helpdesk accessible via Internet permet à quiconque d'enregistrer un compte agent/administrateur.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité des données de conversation/client.

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 à Chatwoot partagée avec la variante Cloud Run est décrite dans le module Chatwoot_Common (modules/Chatwoot_Common) ; voir Chatwoot_Common pour les secrets, le bootstrap de la base de données, l'image/point d'entrée du conteneur, les sondes de santé et le stockage d'objets.

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