Aller au contenu principal

EvolutionAPI sur GKE Autopilot

EvolutionAPI sur GKE Autopilot

Evolution API est une passerelle API WhatsApp Business open source en Node.js (basée sur la bibliothèque Baileys) qui provisionne des instances WhatsApp, envoie et reçoit des messages, et expose une API REST ainsi qu'une interface utilisateur de gestion pour intégrer WhatsApp à d'autres systèmes. Ce module déploie Evolution API 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 Evolution API et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes, et le 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 Evolution API sur RAD, et comment cela se compare​

Dans un projet Google Cloud que vous possédez, Evolution API sur le module GKE Autopilot de RAD coûte environ 150 US$ par mois, plus 30 US$ une fois par déploiement et aucune licence par utilisateur. Pour le coût le plus bas, le module Cloud Run exécute la même Evolution API pour environ 181 US$ par mois. Evolution API est une passerelle API WhatsApp Business open source utilisée pour envoyer et recevoir des messages et gérer plusieurs instances par programmation. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si cela s'exécute dans un projet géré par RAD pour vous, il peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de rester en fonctionnement — ainsi, un déploiement à usage occasionnel coûte quelques dollars par mois, et non les 423 US$ par mois que coûte son maintien en fonctionnement. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par dé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 pour le temps de build à la minuteIdem
Coût de fonctionnement 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 minimum acheté est conservé en réserve

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

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

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 2 vCPU / 4 Gio, fonctionnant en permanence79 US$
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 US$
Serveur de fichiers NFS/cache : une petite VM13 US$
Passerelle Cloud NAT et adresse IP5 US$
Cloud Storage pour les add-ons et les sauvegardes1 US$
Totalenviron 150 US$

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

Comment cela se compare​

Nous n'avons pas trouvé de plan commercial géré/SaaS spécifiquement pour Evolution API au 8 octobre 2026, donc la comparaison honnête se fait par rapport à son exécution par vous-même :

OptionPar moisQui l'exécute
Hetzner CPX22 (2 vCPU/4 Go)~24 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
DigitalOcean 2 vCPU/4 Go Droplet24 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
GCP Compute Engine e2-standard-2 (2 vCPU/8 Go)~49 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
RAD, GKE Autopilot, votre propre projet150 US$, plus 30 US$ une foisL'automatisation de RAD, dans votre projet
RAD, Cloud Runenviron 181 US$ ; voir le guide Cloud RunRAD
  • RAD n'est généralement pas moins cher en espèces qu'un VPS nu — la différence réside dans ce qui est géré pour vous. Le prix d'un VPS n'inclut pas le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau du système d'exploitation ; le Cloud SQL géré par RAD (où cette application utilise une base de données), Secret Manager et la surveillance couvrent cela à la place.
  • Evolution API est une passerelle API WhatsApp Business open source utilisée pour envoyer et recevoir des messages et gérer plusieurs instances par programmation. Cela détermine quelle colonne est importante : un fonctionnement prévisible et sans intervention est plus précieux pour la plupart des équipes utilisant ce type d'outil que de réduire de quelques dollars la facture mensuelle.

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

Si Evolution API s'exécute dans un projet géré par RAD pour vous, vous avez une option au-delà de la mise à l'échelle : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à un déploiement dont vous n'avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, un besoin saisonnier — que de le faire fonctionner en continu.

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

  • Comment ça marche. La suppression d'un projet géré par RAD dissocie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne le supprime pas immédiatement : il le conserve, récupérable, pendant 30 jours, et comme la facturation est déjà dissociée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, la VM ou GKE Autopilot un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 423 US$ par mois de maintien en fonctionnement. Déployez Evolution API, utilisez-la pour une session, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez que les frais de module une seule fois et les heures où il était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • 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 explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé ce déploiement et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

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

GKE maintient au moins un pod en fonctionnement, donc Evolution API ne se met jamais à l'échelle zéro d'elle-même. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 300 crédits (30,00 US$). La suppression permet d'économiser de l'argent si Evolution API resterait inutilisée pendant environ 7 jours ou plus dans votre propre projet (environ 5 US$ par jour), ou environ 2 jours ou plus dans un projet géré par RAD (141 crédits par jour).
  • Supprimez tout ce qu'Evolution API utilise. La majeure partie du coût de fonctionnement est généralement la base de données et toute VM de fichier/cache partagée. Elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
  • Conservez d'abord les données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez les paramètres à nouveau lorsque vous déployez.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose d'Evolution API dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite 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 interrompue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

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

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour le mécanisme de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Evolution API s'exécute comme une charge de travail web Node.js sur GKE Autopilot. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod Node.js, 2 vCPU / 4 Gio par défaut ; épinglé à un seul réplica
Base de donnéesCloud SQL pour PostgreSQL 15Requis — Evolution API utilise Prisma uniquement avec PostgreSQL
CacheRedisActivé par défaut (CACHE_REDIS_URI) ; met en cache l'état des instances/messages
Stockage d'objetsCloud StorageUn bucket de données dédié provisionné automatiquement
SecretsSecret ManagerAUTHENTICATION_API_KEY auto-généré ; mot de passe de la base de données
IngressCloud Load BalancingLoadBalancer externe avec affinité de session ClientIP ; domaine personnalisé optionnel + certificat géré

Valeurs par défaut judicieuses à connaître à l'avance :

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; Evolution API utilise Prisma et ne prend pas en charge d'autres moteurs.
  • La charge de travail est épinglée à un seul réplica (min_instance_count = 1, max_instance_count = 1). Evolution API maintient des sessions de socket WhatsApp (Baileys) actives en mémoire, par pod ; ces sessions ne sont pas partagées entre les réplicas, donc la mise à l'échelle fragmente les connexions actives. N'augmentez pas max_instance_count.
  • AUTHENTICATION_API_KEY est généré automatiquement et stocké dans Secret Manager. C'est la clé d'administration globale d'Evolution API et elle ne doit jamais être renouvelée après le premier démarrage — la renouveler rend les instances WhatsApp déjà provisionnées inaccessibles et renvoie 401 à chaque client détenant toujours l'ancienne clé.
  • Redis est activé par défaut (enable_redis = true). Laissez redis_host vide pour utiliser l'IP de la VM du serveur NFS comme point de terminaison Redis (nécessite enable_nfs = true), ou pointez-le vers une instance gérée explicite.
  • L'affinité de session est ClientIP et le type de service est LoadBalancer par défaut, exposant une IP externe pour les rappels de webhook WhatsApp et l'interface utilisateur de gestion.
  • La mémoire par défaut est de 4 Gio — Evolution API nécessite au moins 2 Gio pour un fonctionnement fiable.
  • SERVER_URL est défini par défaut à l'exécution par le point d'entrée du conteneur à partir de l'URL du service injectée, de sorte que les URL de code QR et de rappel de webhook reflètent l'adresse réelle.

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

A. GKE Autopilot — la charge de travail Evolution API​

Les pods Evolution API sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. La charge de travail s'exécute en un seul réplica par conception.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Evolution API pour voir 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 (Déploiement vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

Evolution API stocke toutes les données d'application (instances WhatsApp, contacts, chats, historique des messages) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les pods l'atteignent privatement via le sidecar Cloud SQL Auth Proxy sur une boucle de retour TCP (127.0.0.1) ; 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 ; les migrations Prisma créent ensuite le schéma au démarrage du conteneur.

  • 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=evolution --database=evolution --project "$PROJECT"

Le nom de l'instance, la base de données (evolution), l'utilisateur (evolution) 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. Cloud Storage​

Un bucket de données Cloud Storage dédié est provisionné automatiquement pour le stockage de fichiers d'Evolution API. Le compte de service de la charge de travail se voit accorder l'accès. Des buckets supplémentaires peuvent être déclarés via storage_buckets.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

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

D. Redis (cache)​

Redis est activé par défaut (enable_redis = true). Evolution API l'utilise pour la mise en cache des instances/messages (CACHE_REDIS_URI, index de base de données Redis 6). Lorsque redis_host est laissé vide et enable_nfs = true, l'IP de la VM du serveur NFS est utilisée comme point de terminaison Redis ; le point d'entrée du conteneur assemble l'URI à l'exécution.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace
    # Confirm the cache URI is injected into the running pod:
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep CACHE_REDIS

E. Secret Manager​

Un secret cryptographique est généré automatiquement et stocké dans Secret Manager : AUTHENTICATION_API_KEY — la clé API d'administration globale d'Evolution API, montée via le pilote CSI Secret Store. Le mot de passe de la base de données est géré séparément par la fondation.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~api-key"
    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 du Secret Store CSI.

F. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe Cloud Load Balancing avec affinité de session ClientIP — requise pour que les requêtes d'un client WhatsApp restent sur le seul pod détenant son socket. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements.

  • 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 CDN et les détails des IP statiques.

G. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Le point d'entrée émet des marqueurs [cloud-entrypoint] qui confirment la configuration résolue de la base de données/Redis/URL au démarrage. Des tests de disponibilité et des règles d'alerte optionnels 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

3. Comportement de l'application EvolutionAPI​

  • Configuration de la base de données lors du premier déploiement. Un job d'initialisation exécute db-init.sh en utilisant postgres:15-alpine. Il se connecte via le Cloud SQL Auth Proxy et crée de manière idempotente la base de données et le rôle evolution, accorde les privilèges et fait de l'utilisateur de l'application le propriétaire du schéma public, puis signale au sidecar proxy de s'arrêter afin que le pod du job se termine. Le job peut être réexécuté en toute sécurité.
  • Migrations Prisma au démarrage. Evolution API exécute prisma migrate deploy à chaque démarrage de conteneur (via le deploy_database.sh encapsulé), de sorte que la mise à niveau de la version de l'application applique les modifications de schéma sans étape de migration distincte. Sur GKE, le sidecar cloud-sql-proxy est une boucle de retour TCP, de sorte que le point d'entrée se connecte avec sslmode=disable.
  • AUTHENTICATION_API_KEY est immuable après le premier démarrage. La clé d'administration globale est générée une fois et écrite dans Secret Manager. La faire pivoter rend toutes les instances WhatsApp déjà provisionnées inaccessibles et renvoie 401 à chaque client détenant toujours l'ancienne clé. Ne la faites pivoter que lors d'une migration planifiée.
  • Réplica unique par conception. Les sessions de socket WhatsApp (Baileys) résident dans la mémoire du pod et ne sont pas partagées entre les réplicas. min_instance_count = 1 en maintient une en exécution ; max_instance_count = 1 empêche la fragmentation des connexions actives. Ne pas mettre à l'échelle. L'affinité de session ClientIP maintient chaque client épinglé au pod.
  • URL de rappel de webhook / QR. Le point d'entrée définit par défaut SERVER_URL sur l'URL de service injectée. Après l'attribution de l'IP externe du LoadBalancer, définissez SERVER_URL (via environment_variables) sur l'URL externe afin que les rappels de code QR et de webhook utilisent une adresse accessible :
    kubectl get svc <service-name> -n "$NAMESPACE" \
    -o jsonpath='{.status.loadBalancer.ingress[0].ip}'
  • Configuration initiale. Après le déploiement, récupérez AUTHENTICATION_API_KEY de Secret Manager et utilisez-le (comme en-tête apikey) pour accéder à l'interface utilisateur de gestion à /manager, créez une instance WhatsApp (POST /instance/create), puis scannez le code QR renvoyé depuis WhatsApp sur votre téléphone pour connecter le numéro.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent la racine / — un point de terminaison de statut non authentifié qui répond une fois le serveur démarré. Prévoyez plusieurs minutes au premier démarrage pendant l'exécution des migrations Prisma.

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 Evolution API 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(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail et les ressources régionales.

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

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameevolutionapiNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionv2.1.1Tag de l'image Evolution API ; latest correspond à un v2.1.1 épinglé dans l'argument de build.

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

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
min_instance_count1Nombre minimal de réplicas de pods ; maintient un pod en fonctionnement pour les sockets WhatsApp en mémoire.
max_instance_count1Épinglé à 1. Ne pas augmenter — les sessions ne sont pas partagées entre les pods.
container_port8080Evolution API écoute sur le port 8080 (SERVER_PORT).
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour la connectivité PostgreSQL.

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

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerExpose une IP externe pour les rappels de webhook et l'interface utilisateur de gestion.
workload_typenull (se résout automatiquement en Deployment)Déploiement sans état (tout l'état réside dans PostgreSQL + Redis).
session_affinityClientIPRoutage persistant afin que les requêtes d'un client atteignent le pod détenant son socket WhatsApp.

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

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

VariableValeur par défautDescription
enable_nfstrueProvisionne la VM du serveur NFS, qui co-localise également le point de terminaison Redis (voir Groupe 15).

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

Groupe 15 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueActive le cache Redis d'Evolution API (CACHE_REDIS_URI).
redis_host""Point de terminaison Redis. Laissez vide pour utiliser l'IP du serveur NFS (nécessite enable_nfs = true).
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis optionnel (sensible).

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

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
application_database_nameevolutionNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_userevolutionUtilisateur de la base de données de l'application. Immuable après le premier déploiement.

Toutes les autres entrées suivent le comportement standard d'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 à la phase.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Evolution API.
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_channelsStatut et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration et d'importation (optionnel).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationStatut 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_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut 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 au moteur de la fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un conflit StatefulSet, IAP sans identités autorisées, unités quota_memory_* non binaires, un redis_port/backup_retention_days hors limites, enable_cloudsql_volume = false sur une application basée sur une base de données. Une configuration invalide fait échouer le plan 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 si incorrect
AUTHENTICATION_API_KEY (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueLe faire pivoter rend chaque instance WhatsApp déjà provisionnée inaccessible et renvoie 401 à tous les clients détenant l'ancienne clé.
application_database_name / application_database_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit tout l'historique des messages.
max_instance_count1CritiqueLa mise à l'échelle fragmente les sessions de socket WhatsApp en mémoire entre les pods, rompant les connexions actives et dupliquant les livraisons de webhook.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont des octets et bloquent toute planification de pod dans l'espace de noms.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy est requis pour la connectivité PostgreSQL ; le désactiver rompt la connexion à la base de données.
enable_redistrueÉlevéLa désactivation supprime le cache d'instances/messages d'Evolution API ; l'application est configurée pour l'attendre (CACHE_REDIS_ENABLED = true).
redis_host"" (NFS) ou expliciteÉlevéLorsque Redis est activé mais que NFS est désactivé et qu'aucun hôte n'est défini, l'URI du cache est vide et la mise en cache est silencieusement désactivée.
session_affinityClientIPÉlevéSans persistance, les requêtes peuvent être acheminées loin du pod unique détenant le socket WhatsApp, ce qui interrompt les opérations d'instance.
service_typeLoadBalancerÉlevéClusterIP rend l'interface utilisateur de gestion et les points de terminaison de webhook inaccessibles depuis l'extérieur du cluster.
min_instance_count1ÉlevéGKE exige min ≥ 1 ; la garde de validation rejette les valeurs invalides. Maintenir 1 préserve les sockets WhatsApp chauds.
enable_iapuniquement lorsque les webhooks ne sont pas nécessairesÉlevéIAP bloque toutes les requêtes non authentifiées, y compris les rappels de webhook externes.
application_versionÉpingler (ex. v2.1.1)Moyenlatest correspond à un tag épinglé, mais l'épinglage explicite évite les mises à niveau surprises qui exécutent de nouvelles migrations Prisma.

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

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