Docuseal sur GKE Autopilot
DocuSeal est une plateforme de signature de documents open source — une alternative auto-hébergée à DocuSign pour créer, remplir et signer des documents PDF avec un constructeur de formulaires visuel, des modèles réutilisables et des pistes d'audit. Ce module déploie DocuSeal sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.
Ce guide se concentre sur les services cloud utilisés par DocuSeal 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 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 Docuseal sur RAD, et comment cela se compare
Le module GKE Autopilot de Docuseal sur RAD coûte environ 149,81 $ US par mois sans licence par utilisateur. Cela se compare aux 20 $ US par utilisateur et par mois pour le plan Pro hébergé de Docuseal. Un serveur auto-géré est moins cher en espèces, mais vous devez alors gérer vous-même la base de données, les sauvegardes, les correctifs de sécurité et les mises à niveau. Exceptionnellement pour ce catalogue, ce module GKE est en fait l'option la moins chère pour Docuseal — le guide Cloud Run par défaut maintient le calcul alloué en continu plutôt que de le réduire à zéro, ce qui coûte actuellement un peu plus cher (environ 180,87 $ US par mois) ; consultez ce guide uniquement si vous avez spécifiquement besoin de Cloud Run. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.
Si vous n'en avez besoin qu'occasionnellement — pour des études, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 149,81 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 175 crédits (17,50 $ US au prix de la recharge) | 157,5 crédits (10 % de moins) |
| Builds | Inclus 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 minute | Idem |
| Coût de fonctionnement Google Cloud | Facturé par Google à votre propre compte de facturation, environ 149,81 $ 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 quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est maintenu en réserve |
10 crédits coûtent 1 $ US en recharge unique, 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, de sorte qu'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, 2x vCPU / 4 Gio | 79,35 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion de cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $ |
| Total | environ 149,81 $ US |
Comment cela se compare
| Option | Par mois | Qui l'exécute |
|---|---|---|
| Docuseal, plan Pro (par utilisateur) | 20 $ US par mois | Docuseal |
| RAD, GKE Autopilot, votre propre projet | Environ 149,81 $ US | L'automatisation de RAD, dans votre projet |
| RAD, GKE Autopilot, un projet géré par RAD | Environ 333 $ US | RAD |
- Le plan Pro de Docuseal est tarifé par signataire ; même avec cinq utilisateurs (100 $ US/mois), il coûte plus cher que le coût de fonctionnement du projet propre à RAD, et le coût de RAD ne change pas lorsque vous ajoutez un autre signataire.
- Le plan Basic de Docuseal est gratuit mais plafonné à 10 e-mails de demande de signature par mois ; le module de RAD exécute le même logiciel open source sans un tel plafonnement.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Docuseal s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Docuseal dont vous n'avez besoin qu'occasionnellement — études, démo, activité saisonnière — 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, 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.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, la VM NFS ou le pod GKE un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
- Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 423 $ US par mois de fonctionnement continu. Déployez Docuseal, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et les heures pendant lesquelles Docuseal a été réellement actif.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démo). Google indique que la plupart des services sont à 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 n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé les données et que vous souhaitez les conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
GKE maintient au moins un pod en cours d'exécution, il ne se met donc jamais à l'échelle zéro de lui-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, le moyen 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) : 175 crédits (17,50 $ US), et environ une heure, car RAD recrée le projet et les services partagés avant Docuseal. La suppression permet d'économiser de l'argent une fois que Docuseal resterait inutilisé pendant environ 4 jours ou plus dans votre propre projet (environ 4,99 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (141 crédits par jour).
- Supprimez tout ce que Docuseal utilise. La majeure partie du coût de fonctionnement est la base de données et la VM NFS/cache. Ils ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de Docuseal pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de Docuseal.
- Conservez vos données en premier. Les sauvegardes nocturnes de la base de données sont écrites dans un bucket à l'intérieur du déploiement, et ce bucket est supprimé avec lui. Avant de supprimer, copiez la dernière sauvegarde sur Google Drive, ou sur un bucket que vous conservez.
- Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres lors du déploiement.
Sessions de lab et environnements gérés
- Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose de Docuseal 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 Docuseal 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 propres à RAD et estimations de crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes et la fenêtre de pause/restauration. Tarification DocuSeal pour le chiffre du plan Pro ;
1. Vue d'ensemble
DocuSeal s'exécute comme une seule charge de travail web Ruby on Rails (Puma). Le déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pods Rails/Puma sur le port 3000, 2 vCPU / 4 Gio par défaut |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — DocuSeal ne prend pas en charge MySQL ou d'autres moteurs |
| Documents persistants | Filestore / NFS ou PVC de bloc | Les documents téléchargés se trouvent à /data/docuseal |
| Stockage d'objets | Cloud Storage | Un bucket provisionné automatiquement (pas le magasin de documents par défaut) |
| Secrets | Secret Manager | SECRET_KEY_BASE auto-généré ; mot de passe de la base de données |
| Ingress | Cloud Load Balancing | LoadBalancer externe, domaine personnalisé facultatif + 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 ; la sélection de tout autre moteur interrompt le démarrage.
container_port = 3000et les sondes doivent correspondre. Sur GKE, la variable d'environnementPORTn'est pas injectée (contrairement à Cloud Run), donc Puma utilise sa configuration par défaut de 3000. Sicontainer_portou les sondes pointent ailleurs, elles atteignent un port mort et le pod ne devient jamais Prêt même si l'application est saine.- Le sidecar Auth Proxy est utilisé sur GKE.
enable_cloudsql_volume = trueexécute le sidecar Cloud SQL Auth Proxy, de sorte que DocuSeal atteint PostgreSQL via127.0.0.1(TCP simple, TLS terminé par le proxy) — le point d'entrée prend la branche de bouclage. SECRET_KEY_BASEest généré automatiquement et stocké dans Secret Manager. Il ne doit jamais être renouvelé après le premier démarrage — cela invaliderait tous les cookies de session signés, déconnectant chaque utilisateur.- Les documents téléchargés nécessitent un volume persistant. Par défaut,
enable_nfs = truemonte le volume NFS partagé à/data/docuseal; alternativement, définissezstateful_pvc_enabled = true(sélectionne automatiquement un StatefulSet) avecstateful_pvc_mount_path = /data/docusealpour un PVC de bloc par pod. - Minimum 1 réplica (GKE ne prend pas en charge la mise à l'échelle à zéro) ;
session_affinitypar défaut àClientIPet une IP statique est réservée afin que l'adresse du LoadBalancer survive aux redéploiements. - Pas de Redis. DocuSeal utilise une file d'attente/cache basée sur PostgreSQL
(
enable_redis = false). - Les migrations s'exécutent au démarrage. DocuSeal applique ses propres migrations ActiveRecord à chaque démarrage ; le seul job d'initialisation crée le rôle et la base de données PostgreSQL.
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 DocuSeal
Les pods DocuSeal sont planifiés sur Autopilot, qui facture le CPU/la mémoire demandés par les pods. L'autoscaling horizontal des pods dimensionne le déploiement entre le nombre minimum et maximum de réplicas. Lorsqu'un PVC de bloc est activé, la charge de travail devient un StatefulSet.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail DocuSeal pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
- CLI :
kubectl get pods,svc,hpa -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation
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
DocuSeal stocke toutes les données de l'application (modèles, soumissions,
soumissionnaires, utilisateurs, piste d'audit) dans une instance gérée de Cloud
SQL pour PostgreSQL 15. Les pods l'atteignent en privé via le sidecar
Cloud SQL Auth Proxy sur 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 le rôle
de l'application.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les drapeaux 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=docuseal --database=docuseal --project "$PROJECT"
Le nom de l'instance, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.
C. Documents persistants — NFS ou PVC de bloc
DocuSeal écrit les documents et pièces jointes téléchargés à /data/docuseal. Par
défaut, cela est pris en charge par le volume NFS partagé (enable_nfs = true) ;
alternativement, un PVC de bloc par pod (stateful_pvc_enabled = true, 10 Gio par défaut) monté
au même chemin le prend en charge dans un StatefulSet.
- Console : Filestore → Instances (NFS) ; Kubernetes Engine → Stockage (PVC).
- CLI :
kubectl get pvc -n "$NAMESPACE"
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- ls -la /data/docuseal
Voir App_GKE pour le modèle de découverte NFS et les modèles de PVC StatefulSet.
D. Cloud Storage
Un bucket Cloud Storage (suffixe de nom storage) est provisionné
automatiquement et le compte de service de la charge de travail se voit accorder
l'accès. Le magasin de documents de DocuSeal utilise par défaut le volume
persistant ci-dessus, de sorte que ce bucket est disponible pour une utilisation
auxiliaire plutôt que comme magasin de documents principal.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT"
gcloud storage ls gs://<bucket-name>/ # bucket name is in the Outputs
Voir App_GKE pour les options CMEK et les montages GCS Fuse.
E. Secret Manager
Un secret cryptographique est généré automatiquement et stocké dans Secret
Manager : SECRET_KEY_BASE (utilisé par Rails pour signer les cookies de session et
autres valeurs signées). 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~docuseal"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.
F. Réseau et ingress
Par défaut, la charge de travail est exposée via une IP externe Cloud Load
Balancing (service_type = LoadBalancer) avec une IP statique réservée 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 ingress,svc -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.
G. Cloud Logging et Monitoring
Les sorties standard/erreur des pods (Rails se connecte à la sortie standard) 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
3. Comportement de l'application Docuseal
- Configuration de la base de données au premier déploiement. Un job
d'initialisation exécute
db-init.shen utilisantpostgres:15-alpine. Il se connecte via le Cloud SQL Auth Proxy et crée de manière idempotente le rôle et la base de donnéesdocuseal, accorde tous les privilèges, réaffecte la propriété du schémapublicau rôle de l'application (PostgreSQL 15 n'accorde plusCREATEsurpublicpar défaut), et 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 au démarrage. DocuSeal exécute automatiquement ses propres migrations ActiveRecord à chaque démarrage en tant que rôle d'application, de sorte que la mise à niveau de la version de l'application applique les modifications de schéma sans étape de migration distincte.
SECRET_KEY_BASEest immuable après le premier démarrage. Il est généré une fois et écrit dans Secret Manager. Le renouveler invalide tous les cookies de session signés, forçant chaque utilisateur à se reconnecter. Ne le renouvelez que pendant une fenêtre de maintenance planifiée.- Chemin de santé. Les sondes de démarrage, de vivacité et de disponibilité
ciblent
/up— le point de terminaison de santé intégré de Rails, qui renvoie un200non authentifié une fois l'application démarrée. Les sondes s'exécutent sur le port 3000 ; comme GKE n'injecte pasPORT,container_portet le port de la sonde doivent tous deux être 3000. - Configuration initiale. DocuSeal n'a pas de identifiants par défaut. Une fois l'adresse IP du LoadBalancer attribuée, ouvrez l'URL du service et remplissez l'écran de configuration pour créer le compte administrateur initial (e-mail + mot de passe) avant d'inviter des utilisateurs ou de créer des modèles.
- Documents persistants. Les documents téléchargés se trouvent à
/data/docusealsur le volume NFS (ou le PVC de bloc). Inspectez le montage depuis un pod :kubectl exec -n "$NAMESPACE" deploy/<service-name> -- df -h /data/docuseal - Inspecter l'exécution du job :
kubectl get jobs -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" job/<job-name>
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 DocuSeal sont listés ; toutes les autres entrées sont héritées de App_GKE avec leur comportement standard et leurs valeurs par défaut.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour la charge de travail et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Court suffixe qui rend les noms de ressources uniques par environnement. |
support_users | [] | Adresses e-mail ayant accès au projet et aux alertes de surveillance. |
resource_labels | {} | Étiquettes appliquées à toutes les ressources. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | docuseal | Nom de base pour les ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag d'image DocuSeal (FROM docuseal/docuseal:<tag>) ; épingler à une version spécifique en production. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
container_resources | { cpu_limit = "2000m", memory_limit = "4Gi" } | Limites et requêtes CPU/mémoire pour le conteneur DocuSeal. |
min_instance_count | 1 | Réplicas minimum ; GKE nécessite ≥ 1. |
max_instance_count | 5 | Réplicas maximum. |
container_port | 3000 | Puma écoute sur 3000 ; les sondes doivent correspondre. Ne pas modifier. |
enable_image_mirroring | true | Mettre en miroir l'image DocuSeal dans Artifact Registry. |
container_image_source | custom | Wrapper léger construit à partir de docuseal/docuseal. |
Groupe 5 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres supplémentaires non secrets. Les valeurs principales (RAILS_LOG_TO_STDOUT, WORKDIR) sont définies automatiquement. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. SECRET_KEY_BASE est injecté automatiquement. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Comment le service Kubernetes est exposé. |
workload_type | null | Sélectionne automatiquement le déploiement ; devient StatefulSet lorsque stateful_pvc_enabled = true. |
session_affinity | ClientIP | Routage persistant pour les sessions d'interface utilisateur. |
reserve_static_ip | true | IP externe stable entre les redéploiements. |
database_type | POSTGRES_15 | Moteur PostgreSQL 15 fixe. |
enable_cloudsql_volume | true | Sidecar Auth Proxy → TCP de bouclage. Maintenir activé. |
Groupe 7 — StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | null | Définir true pour un PVC de bloc par pod (sélectionne automatiquement StatefulSet) comme alternative à NFS. |
stateful_pvc_mount_path | /data/docuseal | Chemin de montage du PVC — doit correspondre à WORKDIR de DocuSeal. |
stateful_pvc_size | 10Gi | Taille de stockage du PVC par pod. |
stateful_fs_group | 0 | fsGroup appliqué au volume PVC. |
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /up, délai 60s, timeout 10s, période 15s, 30 tentatives | Sonde de démarrage vers le point de terminaison de santé de Rails. |
liveness_probe | HTTP /up, délai 60s, timeout 5s, période 30s, 3 tentatives | Sonde de vivacité. |
uptime_check_config | { enabled=false, path="/" } | Test de disponibilité Cloud Monitoring facultatif ; désactivé par défaut. |
Groupe 11 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laisser vide pour utiliser le job intégré db-init (crée le rôle + la base de données). |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | Monter le volume NFS partagé à /data/docuseal pour les documents persistants (le modèle de persistance par défaut). |
nfs_mount_path | /data/docuseal | Chemin de montage — doit correspondre à WORKDIR de DocuSeal. |
Groupe 15 — Cache et file d'attente Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | DocuSeal utilise une file d'attente/cache basée sur PostgreSQL ; laisser désactivé. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
application_database_name | docuseal | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
application_database_user | docuseal | Utilisateur 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 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.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
stage_service_cluster_ips | Mappage des ClusterIP pour les services spécifiques à l'étape. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre DocuSeal. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name | Nom de la base de données de l'application. |
database_user | Utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (127.0.0.1 via l'Auth Proxy) / port. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
initialization_jobs / db_import_job | Noms des jobs de configuration et (facultatifs) d'importation. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_name | Détails GitHub CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
kubernetes_ready | Indique 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_enabled | Journalisation 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 au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un
Deploymentworkload_typeà côté destateful_pvc_enabled = true, des unitésquota_memory_*non binaires, IAP sans identités autorisées, undatabase_typequi ne correspond pas à une extension activé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'au moment de l'application ou de l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
SECRET_KEY_BASE (auto-généré) | Ne jamais renouveler après le premier démarrage | Critique | Le renouvellement invalide tous les cookies de session signés — chaque utilisateur est déconnecté. |
enable_nfs / stateful_pvc_enabled | Exactement un activé | Critique | Sans aucun des deux, les documents sont écrits sur le disque éphémère du pod et sont perdus au redémarrage/replanification. |
nfs_mount_path / stateful_pvc_mount_path | /data/docuseal | Critique | Doit correspondre à WORKDIR de DocuSeal ; un chemin non concordant signifie que les documents sont écrits sur un stockage non persistant. |
application_database_name / application_database_user | Définir une fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données. |
container_port | 3000 | Élevé | GKE n'injecte pas PORT ; un port non concordant fait que les sondes atteignent un port mort et le pod ne devient jamais Prêt. |
enable_cloudsql_volume | true | Élevé | Le sidecar Auth Proxy fournit le chemin de bouclage attendu par le point d'entrée ; le désactiver interrompt la connectivité de la base de données sur GKE. |
workload_type | null / StatefulSet | Élevé | Forcer Deployment avec stateful_pvc_enabled = true échoue au moment de la planification. |
session_affinity | ClientIP | Moyen | Sans persistance, les sessions de signature en plusieurs étapes peuvent être acheminées vers différents pods. |
quota_memory_requests / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms. |
memory_limit | 4Gi | Moyen | Le rendu/la signature de PDF consomme beaucoup de mémoire ; une réduction excessive risque un OOM sous charge. |
application_version | Épingler en production | Moyen | latest peut tirer une nouvelle version majeure lors du redéploiement, appliquant des migrations que vous n'avez pas examinées. |
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 à DocuSeal partagée avec la variante Cloud Run est décrite dans Docuseal_Common.
Guides connexes
- Lab pratique : DocuSeal sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- DocuSeal sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- DocuSeal Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.