Documenso sur Google Cloud Run
Documenso est une alternative open source à DocuSign — une application Next.js pour l'envoi, la signature et la gestion de documents à signature électronique sur une infrastructure que vous contrôlez. Ce module déploie Documenso sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par Documenso et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — référez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.
Ce que Documenso coûte sur RAD, et comment cela se compare
Documenso sur le module Cloud Run de RAD coûte environ 83,61 $ US par mois sans licence par signataire. Cela se compare à 25 $ US par mois pour le plan Individuel de Documenso ou 40 $ US par mois pour son plan Équipes (5 utilisateurs, 8 $ US par utilisateur supplémentaire). Un serveur autogé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. GKE Autopilot convient aux Documenso qui doivent rester opérationnels en permanence ou s'adapter à travers les pods ; pour le coût le plus bas, ce module Cloud Run vous offre déjà l'option la moins chère — voir le guide GKE si vous avez besoin de l'autre. Les chiffres sont au 8 octobre 2026 ; les sources sont listées à la fin de cette section.
Si vous n'en avez besoin qu'occasionnellement — études, démo, entreprise 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 83,61 $ 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 | 75 crédits (7,50 $ US au prix de la recharge) | 67,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 à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 83,61 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, environ 2 010 par mois (environ 201 $ US au prix de la recharge) |
| 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 acheté minimum est conservé en réserve |
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).
10 crédits coûtent 1 $ US 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 toutes les applications 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 |
|---|---|
| Cloud Run, 1x vCPU / 2 Gio (scaleToZero) | 13,16 $ 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 |
| Total | environ 83,61 $ US |
Comment cela se compare
| Option | Par mois | Qui l'exécute |
|---|---|---|
| Documenso, plan Individuel | 25 $ US par mois | Documenso |
| Documenso, plan Équipes (5 utilisateurs) | 40 $ US par mois | Documenso |
| RAD, Cloud Run, votre propre projet | Environ 83,61 $ US | Automatisation de RAD, dans votre projet |
| RAD, Cloud Run, un projet géré par RAD | Environ 96 $ US | RAD |
- Les plans hébergés de Documenso facturent par mois, quel que soit le nombre de documents que vous signez réellement ; le coût de RAD est l'infrastructure, qui est la même que vous envoyiez une enveloppe par mois ou cent.
- Le plan gratuit de Documenso vous limite à 5 documents par mois — le module de RAD exécute le même logiciel open source sans limite de documents.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Documenso 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 à Documenso dont vous n'avez besoin qu'occasionnellement — études, démo, entreprise 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. La restauration ne peut donc 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 cette période d'attente. Contrairement à la suppression d'un seul module, cela ne supprime pas Cloud SQL, la VM NFS ou Cloud Run 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. Parce que 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 201 $ US par mois pour le maintenir en fonctionnement. Déployez Documenso, 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 Documenso était réellement en ligne.
- Ce que cela nécessite. Vous devez posséder le 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 et de démo conviennent). 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 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
Cloud Run se met déjà à l'échelle à zéro entre les requêtes. 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 déployer à nouveau lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 $ US), et environ une heure, car RAD recrée le projet et les services partagés avant Documenso. La suppression permet d'économiser de l'argent une fois que Documenso resterait inutilisé pendant environ 3 jours ou plus dans votre propre projet (environ 2,79 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (67 crédits par jour).
- Supprimez tout ce que Documenso utilise. La majeure partie du coût d'exécution est la base de données et la VM NFS/cache. Elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc les supprimer alors que quelque chose d'autre partage le projet n'économise que la partie calcul de Documenso.
- Conservez d'abord vos données. 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 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 de Documenso 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 Documenso 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 Documenso pour les chiffres des plans Individuel et Équipes ;
1. Vue d'ensemble
Documenso s'exécute comme un conteneur Next.js unique sur Cloud Run v2, construit à partir d'une
image personnalisée légère basée sur l'image officielle documenso/documenso. Le
déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur Next.js sur le port 3000, 1 vCPU / 2 Gio par défaut ; autoscaling sans serveur, mise à l'échelle à zéro prise en charge |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — le moteur est fixé à POSTGRES_15 ; MySQL n'est pas pris en charge |
| Persistance des fichiers | Cloud Filestore (NFS) | Activé par défaut, monté à /mnt/nfs, mais non utilisé pour le stockage de documents (voir ci-dessous) |
| Stockage d'objets | Cloud Storage | Un bucket uploads + compte de service HMAC, provisionné pour un transport de téléchargement compatible S3 facultatif |
| Secrets | Secret Manager | Auto-généré NEXTAUTH_SECRET, NEXT_PRIVATE_ENCRYPTION_KEY, NEXT_PRIVATE_ENCRYPTION_SECONDARY_KEY, clés HMAC, et (facultativement) mot de passe SMTP ; mot de passe de la base de données |
| Ingress | URL Cloud Run / Équilibrage de charge Cloud | URL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé via Cloud Armor |
Valeurs par défaut judicieuses à connaître dès le départ :
- PostgreSQL 15 est obligatoire.
database_type = "POSTGRES_15"est la valeur par défaut. La pile Next.js + Prisma de Documenso ne prend pas en charge MySQL, mais — contrairement à certains autres modules — cela n'est pas appliqué par une précondition de temps de planification au niveauDocumenso_CloudRunouApp_CloudRun; changerdatabase_typede Postgres rompt silencieusement l'application au moment de l'exécution plutôt que de faire échouer la planification. - Build personnalisé, non pré-construit.
container_image_source = "custom"construit une image légèreFROM docker.io/documenso/documenso:${DOCUMENSO_VERSION}qui ajoutebash,curl,postgresql-clientetopenssl, plus un point d'entrée personnalisé. Lesh start.shde l'image officielle exécute les migrations Prisma et démarre le serveur Next.js — il n'y a pas de job de migration séparé. - Cloud SQL est atteint via un socket Unix, pas un proxy TCP.
enable_cloudsql_volume = truemonte le proxy d'authentification Cloud SQL comme un socket de domaine Unix à/cloudsql; le point d'entrée assembleNEXT_PRIVATE_DATABASE_URLà partir des valeursDB_*injectées, en se ramifiant sur le chemin du socket, le proxy127.0.0.1(GKE uniquement), ou l'IP directe + SSL selon ce qui est injecté. - Redis n'est pas requis, et la variable
enable_redispropre au module est effectivement décorative. Documenso utilise un fournisseur de jobs locaux basé sur PostgreSQL, il ne lit donc jamaisREDIS_HOST/REDIS_PORT. Plus important encore, les variablesDocumenso_CloudRundeenable_redis/redis_host/redis_port/redis_authsont transmises uniquement àDocumenso_Common(qui ne les utilise pas non plus) et ne sont jamais passées à l'appel de fondationApp_CloudRundansmain.tf. Leenable_redisde la fondation par défaut àtrue, doncREDIS_HOST/REDIS_PORT(pointant vers l'IP du serveur NFS, puisqueenable_nfsest également activé par défaut) sont injectés dans chaque déploiement Documenso indépendamment du paramètreenable_redisde ce module — inoffensif car Documenso les ignore, mais bon à savoir si vous auditez les variables d'environnement. - NFS est activé par défaut mais Documenso ne l'utilise pas pour les documents.
Les documents sont stockés dans PostgreSQL par défaut
(
NEXT_PUBLIC_UPLOAD_TRANSPORT = "database"). L'instance Filestore ainsi provisionnée est facturée qu'elle soit écrite ou non. - Un certificat de signature est requis pour la signature réelle de documents.
NEXT_PRIVATE_SIGNING_TRANSPORT = "local"attend un certificat.p12. Si aucun n'est fourni, le point d'entrée auto-génère un certificat auto-signé jetable afin que l'application démarre — mais la signature avec celui-ci n'est pas sûre pour la production. webapp_urlest vide par défaut. Jusqu'à ce qu'il soit défini,NEXTAUTH_URLetNEXT_PUBLIC_WEBAPP_URLpar défaut àhttp://localhost:3000; le point d'entrée les met à niveau automatiquement vers leCLOUDRUN_SERVICE_URLinjecté par la plateforme au démarrage, mais la définition explicite dewebapp_urlest recommandée une fois qu'une URL ou un domaine stable est connu.- Mise à l'échelle à zéro par défaut.
min_instance_count = 0,max_instance_count = 1. Les démarrages à froid ajoutent de la latence à la première requête après l'inactivité. - La sonde de démarrage est TCP, la sonde de vivacité est désactivée. Documenso n'expose pas de point de terminaison de santé dédié, donc la sonde de démarrage se base sur la liaison de port plutôt que sur un chemin HTTP, et la sonde de vivacité est désactivée pour éviter une boucle de redémarrage d'un conteneur sain.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources
sont rapportés dans les Sorties du déploiement.
A. Cloud Run — le service Documenso
Documenso s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement à la charge de requêtes entre les nombres d'instances minimum et maximum. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.
- Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux, et les métriques.
- CLI :
gcloud run services list --project "$PROJECT" --region "$REGION"
gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"
Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.
B. Cloud SQL pour PostgreSQL 15
Documenso stocke toutes les données d'application (utilisateurs, documents, destinataires, événements d'audit)
dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le service
se connecte en privé via le proxy d'authentification Cloud SQL sur un socket Unix ; aucune
adresse IP publique n'est exposée. Lors du premier déploiement, le job db-init crée le
rôle d'application et la base de données ; l'image officielle de Documenso exécute ensuite ses propres
migrations Prisma au démarrage du conteneur.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
- CLI :
gcloud sql instances list --project "$PROJECT" --filter="name~documenso"
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 du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.
C. Cloud Storage et persistance des fichiers
Un bucket Cloud Storage dédié (suffixe uploads, compatible CORS pour
un accès direct depuis le navigateur) et un compte de service détenant une clé HMAC sont
provisionnés automatiquement, accordant au SA de stockage roles/storage.objectAdmin
sur le bucket. Il s'agit d'une infrastructure opt-in : Documenso n'y écrit que si
vous définissez NEXT_PUBLIC_UPLOAD_TRANSPORT=s3 et connectez les variables d'environnement secrètes S3_ACCESS_KEY /
S3_SECRET_KEY — par défaut, les documents sont stockés dans
PostgreSQL. Séparément, un volume NFS (Cloud Filestore) est monté à
/mnt/nfs mais n'est pas écrit par l'application dans sa configuration
par défaut.
- Console : Cloud Storage → Buckets ; Filestore → Instances.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~documenso"
gcloud storage ls gs://<uploads-bucket>/ # bucket name is in the Outputs
gcloud filestore instances list --project "$PROJECT"
Voir App_CloudRun pour les options GCS Fuse et CMEK.
D. Secret Manager
Documenso nécessite trois secrets au démarrage — NEXTAUTH_SECRET,
NEXT_PRIVATE_ENCRYPTION_KEY et NEXT_PRIVATE_ENCRYPTION_SECONDARY_KEY —
tous validés par Zod par l'application Next.js, qui ne démarrera pas sans eux.
De plus, S3_ACCESS_KEY / S3_SECRET_KEY (informations d'identification HMAC, utilisées uniquement si
le transport de téléchargement S3 est activé) et, lorsque smtp_host est défini,
NEXT_PRIVATE_SMTP_PASSWORD sont générés. 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~documenso"
gcloud secrets versions access latest --secret=<nextauth-secret-name> --project "$PROJECT"
Voir App_CloudRun pour les détails d'injection et de rotation.
E. Réseau et ingress
Le service est accessible à son URL run.app par défaut, ce qui permet un accès public.
Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et
Cloud Armor peuvent être superposés ; les paramètres d'ingress et le contrôle d'égression VPC
contrôlent la connectivité.
- Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
- CLI :
gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
gcloud compute addresses list --project "$PROJECT"
Voir App_CloudRun.
F. Cloud Logging et Monitoring
Les journaux de conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte facultatifs.
- Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
3. Comportement de l'application Documenso
- Configuration de la base de données au premier déploiement. Le job
db-initexécutedb-init.shen utilisantpostgres:15-alpine. Il attend que Cloud SQL accepte les connexions, puis crée de manière idempotente le rôle d'application et la base de données (privilègeCREATEDB, propriété définie sur la base de données cible), accorde les privilèges de schéma, et enfin signale le sidecar du proxy d'authentification Cloud SQL (POST /quitquitquit) afin que le job puisse se terminer. Le job peut être réexécuté en toute sécurité (execute_on_apply = true,max_retries = 3). - Les migrations s'exécutent automatiquement, pas de job séparé. Le
start.shde l'image officielle de Documenso exécute les migrations Prisma contreNEXT_PRIVATE_DATABASE_URLà chaque démarrage du conteneur, puis lance le serveur autonome Next.js. NEXT_PRIVATE_DATABASE_URLest assemblé au démarrage. Le point d'entrée personnalisé le construit à partir deDB_USER/DB_PASSWORD/DB_HOST/DB_NAME/DB_PORTinjectés par la plateforme, en se ramifiant selon queDB_HOSTest un chemin de socket Unix (le cas normal de Cloud Run,enable_cloudsql_volume = true), un proxy d'authentification127.0.0.1(GKE uniquement), ou une IP directe (auquel cassslmode=requireest forcé).NEXT_PRIVATE_DIRECT_DATABASE_URLle reflète.- Trois secrets sont immuables en pratique.
NEXTAUTH_SECRETet les deux clés de chiffrement sont validées par Zod au démarrage et générées une fois dans Secret Manager.NEXTAUTH_SECRETpeut être tourné (invalide les sessions) ;NEXT_PRIVATE_ENCRYPTION_KEYne doit jamais être régénéré sur place — ne le tournez que via l'emplacement de la clé secondaire. - Pas de compte administrateur de démarrage. Ce module ne crée pas d'utilisateur administrateur/propriétaire Documenso. La première personne à s'inscrire via l'interface web de l'application devient le propriétaire du compte — comportement standard de Documenso en amont, non provisionné par ce module.
- Le certificat de signature est une étape post-déploiement requise pour la signature réelle.
Sans certificat fourni, le point d'entrée auto-génère un certificat auto-signé jetable
.p12à/opt/documenso/cert.p12afin que l'application démarre et que les fonctionnalités non liées à la signature fonctionnent, en affichant un avertissement sonore. Pour la signature en production, fournissez un vrai certificat viasecret_environment_variablesmappantNEXT_PRIVATE_SIGNING_LOCAL_FILE_CONTENTS(.p12encodé en base64) etNEXT_PRIVATE_SIGNING_PASSPHRASE. - Résolution d'URL de l'application web.
NEXTAUTH_URL/NEXT_PUBLIC_WEBAPP_URLpar défaut àhttp://localhost:3000. S'il est toujours à cette valeur par défaut lorsque le conteneur démarre, le point d'entrée écrase les deux avec leCLOUDRUN_SERVICE_URLinjecté par la plateforme. Définissezwebapp_urlexplicitement une fois que l'URL Cloud Run ou un domaine personnalisé est connu afin que les rappels OAuth/e-mail restent stables entre les redéploiements. - Chemin de santé. La sonde de démarrage est TCP sur le port 3000 (délai initial de 30 s, période de 20 s, 10 échecs autorisés) — elle réussit dès que le conteneur lie son port, car l'alternative HTTP nécessiterait une préparation complète de l'application et de la base de données et risquerait de ne jamais passer. La sonde de vivacité est désactivée par défaut ; Documenso n'a pas de point de terminaison de santé dédié.
- Inspectez le job d'initialisation et la configuration en cours d'exécution :
gcloud run jobs list --project "$PROJECT" --region "$REGION"
gcloud run jobs executions list --job <db-init-job-name> --project "$PROJECT" --region "$REGION"
gcloud run revisions describe <revision-name> --region "$REGION" \
--format='value(spec.template.spec.containers[0].env)'
4. Variables de configuration
Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement
(correspondant à la balise {{UIMeta group=N}} de chaque variable dans variables.tf). Seuls
les paramètres spécifiques ou notables pour Documenso sont listés ; toute autre entrée est
héritée de App_CloudRun avec son comportement standard.
Groupe 0 — Métadonnées du module
| Variable | Valeur par défaut | Description |
|---|---|---|
module_description / module_documentation / module_dependency / module_services | (défini) | Texte de la liste du catalogue et ordre des dépendances. Lu par la plateforme, non appliqué par Terraform. |
requires_services | { create_postgres = true, create_network_filesystem = true, ... } | Indique à la plateforme quels commutateurs Services_GCP create_* activer lors du provisionnement automatique pour ce module. |
credit_cost / require_credit_purchases | 75 / false | Métadonnées de facturation de la plateforme. |
enable_purge | true | Permet la suppression complète des ressources lors de la destruction. |
public_access | true | Liste le module dans le catalogue public. |
require_services_gcp_module | true | Une fonctionnalité App_CloudRun — fait échouer le plan si aucun VPC Services_GCP n'existe — mais cette variable n'est pas transmise à App_CloudRun ici, elle n'a donc aucun effet au niveau de ce module. |
shared_users | [] | Activement appliquée par la plateforme (contrairement à la plupart des variables du groupe 0) : les utilisateurs listés ici ont accès quelle que soit la valeur de public_access. |
technical_support_users | [] | Acheminer les demandes de support pour ce module vers ces utilisateurs. |
resource_creator_identity | rad-module-creator@YOUR_PLATFORM_PROJECT.iam.gserviceaccount.com | SA que Terraform utilise pour créer des ressources ; transmis à App_CloudRun. |
impersonation_service_account / job_execution_wait_timeout / module_writable_secret_ids | "" / 900 / {} | Déclaré pour la parité de convention ; non transmis nulle part dans main.tf — la définition de l'une de ces valeurs n'a aucun effet. |
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
support_users | [] | E-mails 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 | documenso | Nom de base pour les ressources. Ne pas modifier après le premier déploiement. |
display_name | Documenso | Nom lisible par l'homme affiché dans la console. |
description | Documenso - The Open Source DocuSign Alternative | Description du service. |
application_version | latest | Définit l'argument de build DOCUMENSO_VERSION pour l'image de base FROM docker.io/documenso/documenso:${DOCUMENSO_VERSION} de build personnalisé. |
webapp_url | "" | URL publique de l'instance. Définie après le premier déploiement (ou une fois qu'un domaine personnalisé est enregistré) afin que les rappels NextAuth et les liens e-mail soient stables. Jusqu'à ce qu'elle soit définie, le point d'entrée met à jour localhost:3000 vers le CLOUDRUN_SERVICE_URL en direct à chaque démarrage. |
application_display_name / application_description | (Valeurs par défaut de la fondation) | Miroirs de convention de fondation de display_name/description. Déclarés mais non transmis — utilisez display_name/description à la place. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
container_image_source | custom | Construit l'image wrapper légère via Cloud Build. prebuilt déploie directement l'image officielle (pas de point d'entrée, donc NEXT_PRIVATE_DATABASE_URL et le fallback du certificat de signature ne seraient pas assemblés). |
container_image | "" | Remplace l'URI de l'image ; laissez vide pour utiliser l'image Documenso intégrée. |
container_build_config | { enabled = true } | Configuration de Cloud Build ; Documenso_Common fournit dockerfile_path/context_path/build_args (DOCUMENSO_VERSION). |
cpu_limit | 1000m | 1 vCPU par instance. |
memory_limit | 2Gi | Mémoire par instance ; le plancher de la génération 2 de Cloud Run est de 512 Mio quel que soit le mode de facturation. |
min_instance_count | 0 | 0 active la mise à l'échelle à zéro. |
max_instance_count | 1 | Plafond des coûts ; Documenso n'a pas de mise en garde documentée pour plusieurs instances comme Listmonk/Activepieces, mais augmentez avec prudence. |
container_port | 3000 | Port du serveur Next.js de Documenso. |
execution_environment | gen2 | Gen2 requis pour les montages NFS et GCS Fuse. |
timeout_seconds | 300 | Durée maximale de la requête (0–3600 secondes). |
enable_cloudsql_volume | false | Doit être défini true pour le chemin de connexion à la base de données via socket Unix par défaut du point d'entrée ; le module fournit cette valeur par défaut false contrairement à la plupart des modules basés sur une base de données (voir Pièges). |
enable_image_mirroring | true | Mettre en miroir l'image Documenso dans Artifact Registry. |
traffic_split | [] | Répartir le trafic entre les révisions pour des déploiements échelonnés. |
container_protocol | http1 | http1 ou h2c. Documenso n'a pas besoin de HTTP/2 en clair. |
cloudsql_volume_mount_path | /cloudsql | Chemin du conteneur pour le socket Unix du proxy d'authentification Cloud SQL ; pertinent uniquement lorsque enable_cloudsql_volume = true. |
service_annotations / service_labels | {} | Annotations/étiquettes de service Cloud Run avancées. |
container_resources | { cpu_limit = "1000m", memory_limit = "512Mi" } | Miroir de convention de fondation de cpu_limit/memory_limit. Déclaré mais non transmis — utilisez ceux-ci à la place. |
additional_containers / additional_services | [] | Conteneurs sidecar / services Cloud Run supplémentaires. Déclarés mais non transmis à App_CloudRun — aucun sidecar ou service supplémentaire n'est déployé par ce module, quels que soient ces paramètres. |
max_revisions_to_retain | 7 | Déclaré pour la parité de convention ; non référencé par le déploiement de ce module. |
Groupe 5 — Accès, réseau et e-mail
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | all, internal ou internal-and-cloud-load-balancing. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Acheminer uniquement le trafic RFC 1918 via VPC. |
enable_iap | false | Exiger la connexion Google. |
iap_authorized_users / iap_authorized_groups | [] | Qui peut accéder via IAP. |
prereq_subnet_cidr_override | "" | Remplacement pour le CIDR du sous-réseau primaire VPC intégré, pertinent uniquement lorsqu'aucun réseau Services_GCP n'existe. Laissez vide pour dériver automatiquement un /24 unique. |
smtp_host | "" | Nom d'hôte du serveur SMTP. Laissez vide pour désactiver l'e-mail (invitations, notifications de signature). |
smtp_port / smtp_secure_enabled | 587 / false | Utilisez 465 + true pour TLS implicite, sinon STARTTLS sur 587. |
smtp_user | "" | Nom d'utilisateur d'authentification SMTP. |
smtp_password | "" | Génère automatiquement une valeur Secret Manager lorsqu'il est laissé vide et que smtp_host est défini. |
mail_from | "" | Adresse de l'expéditeur ; revient à noreply@documenso.local lorsque smtp_host est défini mais que cette valeur est vide. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | Clés de remplacement SMTP (EMAIL_SMTP_*) | Ensemble par défaut restant du modèle partagé du module ; Documenso lui-même lit les noms NEXT_PRIVATE_SMTP_* assemblés à partir des variables smtp_* du groupe 5, et non ces clés EMAIL_SMTP_* — la définition directe de celles-ci n'a aucun effet sur le mailer de Documenso. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. C'est ici que vous connectez un vrai certificat de signature : NEXT_PRIVATE_SIGNING_LOCAL_FILE_CONTENTS (.p12 encodé en base64) et NEXT_PRIVATE_SIGNING_PASSPHRASE. |
secret_propagation_delay | 30 | Secondes à attendre après la création du secret avant de continuer. |
secret_rotation_period | 2592000s | Fréquence de notification de rotation de Secret Manager. |
Groupe 7 — Sauvegarde et restauration
| Variable | Valeur par défaut | Description |
|---|---|---|
backup_schedule | 0 2 * * * | Cron de sauvegarde automatisée (UTC). |
backup_retention_days | 7 | Rétention ; augmentez pour la production/conformité. |
enable_backup_import / backup_source / backup_uri / backup_format | options de restauration | Restaurer à partir d'une sauvegarde lors du déploiement. |
backup_file | backup.sql | Miroir de convention de fondation du nom de fichier de sauvegarde. Déclaré mais non transmis — utilisez backup_uri à la place. |
Groupe 8 — CI/CD et autorisation binaire
Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir
App_CloudRun. Entrées clés : enable_cicd_trigger,
github_repository_url, github_token, github_app_installation_id,
cicd_trigger_config, enable_cloud_deploy, cloud_deploy_stages,
enable_binary_authorization.
| Variable | Valeur par défaut | Description |
|---|---|---|
binauthz_evaluation_mode | ALWAYS_ALLOW | Mode d'application lorsque enable_binary_authorization est vrai et que Services_GCP n'a pas préconfiguré une politique. Non référencé — n'a aucun effet sur le déploiement dans ce module. |
Groupe 9 — Scripts SQL personnalisés et ciblage d'instances NFS
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root | désactivé | Exécuter SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun. |
nfs_instance_name | "" | Cible une VM NFS GCE existante directement au lieu d'en découvrir une automatiquement. |
nfs_instance_base_name | app-nfs | Nom de base pour une VM NFS intégrée lorsqu'aucune n'est trouvée. |
nfs_volume_name | nfs-data-volume | Nom du volume Kubernetes/Cloud Run pour le montage NFS. Ne remplacer que pour un deuxième partage NFS avec un nom de volume distinct. |
Groupe 10 — Équilibreur de charge, CDN et rétention d'images
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_cloud_armor | false | Provisionner un équilibreur de charge HTTPS global + WAF Cloud Armor. |
admin_ip_ranges | [] | Plages CIDR exemptées des règles WAF. |
application_domains | [] | Noms de domaine personnalisés pour l'équilibreur de charge HTTPS. |
enable_cdn | false | Activer Cloud CDN sur le backend de l'équilibreur de charge HTTPS. |
max_images_to_retain / delete_untagged_images / image_retention_days | (défini) | Politique de nettoyage d'Artifact Registry. |
Groupe 11 — Stockage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Créer des buckets GCS définis dans storage_buckets. |
storage_buckets | un bucket data | Remplacé en pratique : documenso.tf fournit le bucket uploads réel (compatible CORS) via la sortie storage_buckets de Documenso_Common, et non la valeur par défaut de cette variable. |
enable_nfs | true | Provisionne Filestore par défaut. Non utilisé pour le stockage de documents — voir Vue d'ensemble. |
nfs_mount_path | /mnt/nfs | Chemin de montage à l'intérieur du conteneur (non utilisé par la configuration par défaut de l'application). |
gcs_volumes | [] | Montages de volume GCS Fuse (nécessite gen2). |
manage_storage_kms_iam / enable_artifact_registry_cmek | false | Options CMEK. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Non validé par le plan à aucun niveau — le fait de modifier cette valeur pour autre chose que Postgres rompt le schéma Prisma de Documenso au moment de l'exécution plutôt que de faire échouer tofu plan. |
db_name | documenso | La base de données réellement créée et injectée sous le nom DB_NAME. Immuable après le premier déploiement. |
db_user | documenso | Le rôle réellement créé et injecté sous le nom DB_USER ; mot de passe auto-généré dans Secret Manager. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
sql_instance_name / sql_instance_base_name | "" / app-sql | Cible une instance Cloud SQL existante ou nomme une instance intégrée. |
enable_auto_password_rotation / rotation_propagation_delay_sec | désactivé | Rotation du mot de passe de la base de données. |
db_host_env_var_name / db_user_env_var_name / db_name_env_var_name / db_port_env_var_name / service_url_env_var_name | "" | Déclaré pour la parité de convention mais non transmis nulle part dans main.tf ou documenso.tf — la définition de l'une de ces valeurs n'a aucun effet. |
application_database_name / application_database_user | crappdb / crappuser | Miroirs de convention de fondation de db_name/db_user. Déclarés mais non transmis — utilisez db_name/db_user à la place. |
db_password_env_var_name | "" | Nom de variable d'environnement supplémentaire pour exposer le mot de passe de la base de données à côté de DB_PASSWORD. Déclaré mais non transmis — n'a aucun effet. |
enable_mysql_plugins / mysql_plugins | false / [] | Installer des plugins MySQL après le provisionnement. Documenso est uniquement PostgreSQL et aucune des variables n'est transmise — n'a aucun effet. |
enable_postgres_extensions / postgres_extensions | false / [] | Installer des extensions PostgreSQL après le provisionnement. Déclaré mais non transmis — n'a aucun effet pour ce module. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laissez vide pour utiliser le job db-init intégré fourni par Documenso_Common. |
cron_jobs | [] | Aucune tâche récurrente planifiée par la plateforme n'est définie pour Documenso. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | TCP, port 3000, initial_delay_seconds=30, failure_threshold=10 | Sonde spécifique à Documenso transmise via la sortie config de Documenso_Common. TCP plutôt que HTTP car aucun point de terminaison HTTP ne signale de manière fiable une préparation complète sans risquer une sonde en échec permanent. |
liveness_probe | enabled = false | Désactivé — une sonde HTTP contre / redémarrerait en boucle un conteneur sain avant que l'application ne soit prête. |
startup_probe_config | désactivé | Sonde structurée alternative (désactivée par défaut ; startup_probe prend effet). |
health_check_config | HTTP / | Sonde de vivacité structurée alternative. |
uptime_check_config | { enabled=false, path="/" } | Test de disponibilité Cloud Monitoring ; désactivé par défaut. |
alert_policies | [] | Politiques d'alerte métrique. |
Groupe 21 — Redis / File d'attente de jobs
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Non transmis à App_CloudRun. Uniquement passé à Documenso_Common, qui ne le référence pas non plus — cette variable n'a aucun effet sur le service déployé. Documenso utilise un fournisseur de jobs locaux basé sur PostgreSQL et ne lit jamais REDIS_HOST. Le enable_redis de la fondation (par défaut true, non exposé ici) injecte toujours REDIS_HOST/REDIS_PORT quoi qu'il arrive — voir Vue d'ensemble. |
redis_host / redis_port / redis_auth | "" / 6379 / "" | Même mise en garde — inerte au niveau de ce module. |
cubejs_api_url | http://localhost:4000 | Reste inerte du modèle de variable partagé à partir duquel ce module a été cloné (URL de l'API Cube.js — pas un concept Documenso) ; non lu par aucun Dockerfile, point d'entrée ou mappage d'environnement dans ce module. |
hub_api_url | http://localhost:8080 | Idem — reste inerte, non lu nulle part dans ce module. |
Groupe 22 — Contrôles de service VPC et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC (nécessite organization_id). |
vpc_cidr_ranges / vpc_sc_dry_run | (défini) | CIDR de niveau d'accès / mode de simulation. |
enable_audit_logging | false | Journaux d'audit Cloud détaillés. |
5. Sorties
Retournées après un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL par défaut run.app du service. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (si activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_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 (via le socket du proxy d'authentification) / port. |
storage_buckets | Buckets Cloud Storage créés (le bucket uploads). |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | Statut de la surveillance, canaux, tests de disponibilité. |
initialization_jobs | Noms des jobs de configuration (db-init). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | Statut et détails CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | Statut VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation 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 du plan. Ce module transmet sa configuration au moteur de socle App_CloudRun, qui valide les valeurs et les combinaisons au moment du plan —
min_instance_count > max_instance_count, IAP activé sans identités autorisées, un runtimegen1avec des montages NFS/GCS, unredis_port/backup_retention_dayshors de portée. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource.Documenso_CloudRunlui-même n'ajoute pas devalidation.tfsupplémentaire au-delà des vérifications par variable dansvariables.tf— doncdatabase_typeloin de Postgres n'est pas détecté à quelque niveau que ce soit, seulement à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
database_type | POSTGRES_15 | Critique | Non validé au moment du plan par ce module ou le socle — le passage à MySQL/SQL Server rompt Prisma et chaque requête à l'exécution. |
Certificat de signature (NEXT_PRIVATE_SIGNING_LOCAL_FILE_CONTENTS) | Fournir un vrai .p12 après le déploiement | Critique | Sans cela, le point d'entrée auto-signe un certificat jetable — les documents sont "signés" mais la signature n'est pas fiable pour les lecteurs PDF ; non sûr pour la production. |
NEXT_PRIVATE_ENCRYPTION_KEY / _SECONDARY_KEY (auto-généré) | Ne jamais modifier directement | Critique | Ceux-ci chiffrent les données Documenso ; ne les faire pivoter que via l'emplacement de la clé secondaire, jamais en régénérant la clé primaire sur place. |
enable_cloudsql_volume | true | Critique | Par défaut à false dans ce module, mais la branche de connexion DB par défaut du point d'entrée attend le socket Unix du proxy d'authentification Cloud SQL à /cloudsql. Laisser ceci false tout en s'appuyant sur le chemin de connexion par défaut peut empêcher l'application d'atteindre la base de données via un socket. |
db_name / db_user | Définir une fois | Élevé | 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. |
webapp_url | Définir une fois que l'URL/le domaine est connu | Élevé | Si non défini, NEXTAUTH_URL/NEXT_PUBLIC_WEBAPP_URL suivent ce que CLOUDRUN_SERVICE_URL résout à chaque démarrage ; une valeur explicite maintient les rappels d'authentification et les liens e-mail stables lors des redéploiements. |
enable_backup_import | false sauf restauration | Critique | L'activation sans backup_uri valide fait échouer le job d'importation. |
db_host_env_var_name / db_user_env_var_name / db_name_env_var_name / db_port_env_var_name / service_url_env_var_name | Laisser non défini | Faible | Déclarés mais jamais transmis à aucun module — les définir n'a aucun effet. |
enable_redis / redis_host / redis_port / redis_auth | Laisser tel quel | Faible | Non transmis à App_CloudRun ; le propre enable_redis du socle (par défaut true, non exposé par ce module) injecte REDIS_HOST/REDIS_PORT de toute façon — Documenso les ignore dans tous les cas, il s'agit donc d'un piège de documentation, pas d'un risque fonctionnel. |
cubejs_api_url / hub_api_url | Laisser par défaut | Faible | Restes inertes du modèle de variable partagé ; Documenso ne les lit jamais. |
environment_variables par défaut (clés EMAIL_SMTP_*) | Utiliser smtp_host/smtp_user/etc. à la place | Moyen | Les clés EMAIL_SMTP_* dans la carte par défaut ne sont pas lues par Documenso — configurer l'e-mail via les variables smtp_* du groupe 5, qui sont traduites en NEXT_PRIVATE_SMTP_* par Documenso_Common. |
min_instance_count | 1 pour la production | Moyen | La mise à l'échelle à zéro (0) ajoute un délai de démarrage à froid sur la première requête après l'inactivité. |
enable_nfs | true (par défaut) ou false si non nécessaire | Moyen | Filestore est facturé que l'application y écrive ou non ; Documenso n'utilise pas le montage NFS dans sa configuration par défaut. |
smtp_host | Définir pour la production | Moyen | Si vide, aucune variable NEXT_PRIVATE_SMTP_* n'est injectée — aucun e-mail d'invitation ou de notification de signature n'est envoyé. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
container_image_source | custom (par défaut) | Élevé | Le passage à prebuilt déploie directement l'image officielle, en ignorant le point d'entrée personnalisé qui assemble NEXT_PRIVATE_DATABASE_URL, résout l'URL de l'application web et auto-génère un certificat de signature de secours. |
Pour le comportement du socle référencé partout — identité de service, mise à
l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor,
IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images —
voir App_CloudRun. La configuration d'application
spécifique à Documenso partagée avec la variante GKE (secrets, le job db-init
et le point d'entrée personnalisé) est définie dans Documenso_Common (source du module :
modules/Documenso_Common).
Guides associés
- Lab pratique : Documenso sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Documenso sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- Documenso Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de OpenProject sur Google Cloud Run, Cal.com sur Google Cloud Run, Kimai sur Google Cloud Run, Invoice Ninja sur Google Cloud Run dans la solution Automatisation des services professionnels.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.