Aller au contenu principal

Documenso sur Google Cloud Run

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édezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 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 quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde acheté minimum est conservé en réserve

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 SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 83,61 $ US

Comment cela se compare​

OptionPar moisQui l'exécute
Documenso, plan Individuel25 $ US par moisDocumenso
Documenso, plan Équipes (5 utilisateurs)40 $ US par moisDocumenso
RAD, Cloud Run, votre propre projetEnviron 83,61 $ USAutomatisation de RAD, dans votre projet
RAD, Cloud Run, un projet géré par RADEnviron 96 $ USRAD
  • 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 CloudNotes
CalculCloud Run v2Conteneur 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éesCloud SQL pour PostgreSQL 15Requis — le moteur est fixé à POSTGRES_15 ; MySQL n'est pas pris en charge
Persistance des fichiersCloud Filestore (NFS)Activé par défaut, monté à /mnt/nfs, mais non utilisé pour le stockage de documents (voir ci-dessous)
Stockage d'objetsCloud StorageUn bucket uploads + compte de service HMAC, provisionné pour un transport de téléchargement compatible S3 facultatif
SecretsSecret ManagerAuto-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
IngressURL Cloud Run / Équilibrage de charge CloudURL 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 niveau Documenso_CloudRun ou App_CloudRun ; changer database_type de 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ère FROM docker.io/documenso/documenso:${DOCUMENSO_VERSION} qui ajoute bash, curl, postgresql-client et openssl, plus un point d'entrée personnalisé. Le sh start.sh de 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 = true monte le proxy d'authentification Cloud SQL comme un socket de domaine Unix à /cloudsql ; le point d'entrée assemble NEXT_PRIVATE_DATABASE_URL à partir des valeurs DB_* injectées, en se ramifiant sur le chemin du socket, le proxy 127.0.0.1 (GKE uniquement), ou l'IP directe + SSL selon ce qui est injecté.
  • Redis n'est pas requis, et la variable enable_redis propre au module est effectivement décorative. Documenso utilise un fournisseur de jobs locaux basé sur PostgreSQL, il ne lit donc jamais REDIS_HOST/REDIS_PORT. Plus important encore, les variables Documenso_CloudRun de enable_redis/redis_host/redis_port/redis_auth sont transmises uniquement à Documenso_Common (qui ne les utilise pas non plus) et ne sont jamais passées à l'appel de fondation App_CloudRun dans main.tf. Le enable_redis de la fondation par défaut à true, donc REDIS_HOST/REDIS_PORT (pointant vers l'IP du serveur NFS, puisque enable_nfs est également activé par défaut) sont injectés dans chaque déploiement Documenso indépendamment du paramètre enable_redis de 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_url est vide par défaut. Jusqu'à ce qu'il soit défini, NEXTAUTH_URL et NEXT_PUBLIC_WEBAPP_URL par défaut à http://localhost:3000 ; le point d'entrée les met à niveau automatiquement vers le CLOUDRUN_SERVICE_URL injecté par la plateforme au démarrage, mais la définition explicite de webapp_url est 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-init exécute db-init.sh en utilisant postgres: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ège CREATEDB, 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.sh de l'image officielle de Documenso exécute les migrations Prisma contre NEXT_PRIVATE_DATABASE_URL à chaque démarrage du conteneur, puis lance le serveur autonome Next.js.
  • NEXT_PRIVATE_DATABASE_URL est assemblé au démarrage. Le point d'entrée personnalisé le construit à partir de DB_USER/DB_PASSWORD/DB_HOST/ DB_NAME/DB_PORT injectés par la plateforme, en se ramifiant selon que DB_HOST est un chemin de socket Unix (le cas normal de Cloud Run, enable_cloudsql_volume = true), un proxy d'authentification 127.0.0.1 (GKE uniquement), ou une IP directe (auquel cas sslmode=require est forcé). NEXT_PRIVATE_DIRECT_DATABASE_URL le reflète.
  • Trois secrets sont immuables en pratique. NEXTAUTH_SECRET et 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_SECRET peut être tourné (invalide les sessions) ; NEXT_PRIVATE_ENCRYPTION_KEY ne 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.p12 afin 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 via secret_environment_variables mappant NEXT_PRIVATE_SIGNING_LOCAL_FILE_CONTENTS (.p12 encodé en base64) et NEXT_PRIVATE_SIGNING_PASSPHRASE.
  • Résolution d'URL de l'application web. NEXTAUTH_URL / NEXT_PUBLIC_WEBAPP_URL par 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 le CLOUDRUN_SERVICE_URL injecté par la plateforme. Définissez webapp_url explicitement 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​

VariableValeur par défautDescription
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_purchases75 / falseMétadonnées de facturation de la plateforme.
enable_purgetruePermet la suppression complète des ressources lors de la destruction.
public_accesstrueListe le module dans le catalogue public.
require_services_gcp_moduletrueUne 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_identityrad-module-creator@YOUR_PLATFORM_PROJECT.iam.gserviceaccount.comSA 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é​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe 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​

VariableValeur par défautDescription
application_namedocumensoNom de base pour les ressources. Ne pas modifier après le premier déploiement.
display_nameDocumensoNom lisible par l'homme affiché dans la console.
descriptionDocumenso - The Open Source DocuSign AlternativeDescription du service.
application_versionlatestDé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​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit 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_limit1000m1 vCPU par instance.
memory_limit2GiMé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_count00 active la mise à l'échelle à zéro.
max_instance_count1Plafond des coûts ; Documenso n'a pas de mise en garde documentée pour plusieurs instances comme Listmonk/Activepieces, mais augmentez avec prudence.
container_port3000Port du serveur Next.js de Documenso.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseDoit ê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_mirroringtrueMettre 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_protocolhttp1http1 ou h2c. Documenso n'a pas besoin de HTTP/2 en clair.
cloudsql_volume_mount_path/cloudsqlChemin 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_retain7Dé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​

VariableValeur par défautDescription
ingress_settingsallall, internal ou internal-and-cloud-load-balancing.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger 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_enabled587 / falseUtilisez 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​

VariableValeur par défautDescription
environment_variablesClé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_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmentez pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.
backup_filebackup.sqlMiroir 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.

VariableValeur par défautDescription
binauthz_evaluation_modeALWAYS_ALLOWMode 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​

VariableValeur par défautDescription
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootdé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_nameapp-nfsNom de base pour une VM NFS intégrée lorsqu'aucune n'est trouvée.
nfs_volume_namenfs-data-volumeNom 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​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner 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_cdnfalseActiver 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​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS définis dans storage_buckets.
storage_bucketsun bucket dataRemplacé 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_nfstrueProvisionne Filestore par défaut. Non utilisé pour le stockage de documents — voir Vue d'ensemble.
nfs_mount_path/mnt/nfsChemin 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_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Non 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_namedocumensoLa base de données réellement créée et injectée sous le nom DB_NAME. Immuable après le premier déploiement.
db_userdocumensoLe rôle réellement créé et injecté sous le nom DB_USER ; mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).
sql_instance_name / sql_instance_base_name"" / app-sqlCible une instance Cloud SQL existante ou nomme une instance intégrée.
enable_auto_password_rotation / rotation_propagation_delay_secdé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_usercrappdb / crappuserMiroirs 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_pluginsfalse / []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_extensionsfalse / []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​

VariableValeur par défautDescription
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é​

VariableValeur par défautDescription
startup_probeTCP, port 3000, initial_delay_seconds=30, failure_threshold=10Sonde 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_probeenabled = falseDésactivé — une sonde HTTP contre / redémarrerait en boucle un conteneur sain avant que l'application ne soit prête.
startup_probe_configdésactivéSonde structurée alternative (désactivée par défaut ; startup_probe prend effet).
health_check_configHTTP /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​

VariableValeur par défautDescription
enable_redisfalseNon 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_urlhttp://localhost:4000Reste 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_urlhttp://localhost:8080Idem — reste inerte, non lu nulle part dans ce module.

Groupe 22 — Contrôles de service VPC et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer 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_loggingfalseJournaux 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.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL par défaut run.app du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (si activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison de la base de données (via le socket du proxy d'authentification) / port.
storage_bucketsBuckets Cloud Storage créés (le bucket uploads).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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 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 runtime gen1 avec des montages NFS/GCS, un redis_port/backup_retention_days hors 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_CloudRun lui-même n'ajoute pas de validation.tf supplémentaire au-delà des vérifications par variable dans variables.tf — donc database_type loin de Postgres n'est pas détecté à quelque niveau que ce soit, seulement à l'exécution.

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typePOSTGRES_15CritiqueNon 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éploiementCritiqueSans 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 directementCritiqueCeux-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_volumetrueCritiquePar 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_userDé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_urlDé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_importfalse sauf restaurationCritiqueL'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_nameLaisser non définiFaibleDéclarés mais jamais transmis à aucun module — les définir n'a aucun effet.
enable_redis / redis_host / redis_port / redis_authLaisser tel quelFaibleNon 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_urlLaisser par défautFaibleRestes 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 placeMoyenLes 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_count1 pour la productionMoyenLa 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_nfstrue (par défaut) ou false si non nécessaireMoyenFilestore est facturé que l'application y écrive ou non ; Documenso n'utilise pas le montage NFS dans sa configuration par défaut.
smtp_hostDéfinir pour la productionMoyenSi 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_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
container_image_sourcecustom (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).

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