Aller au contenu principal

Stirling-PDF sur Google Cloud Run

Stirling-PDF sur Google Cloud Run

Stirling-PDF est une boîte à outils PDF web open source (licence MIT pour le cœur), hébergée localement — fusionner, diviser, convertir, OCR, compresser, filigraner, signer, caviarder et plus de 50 autres opérations PDF, toutes traitées sur votre propre infrastructure afin que les documents ne touchent jamais un service tiers. Ce module déploie Stirling-PDF sur Cloud Run v2 sur la base 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 Stirling-PDF 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 à chaque application 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 et le cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte Stirling-PDF sur RAD, et comment cela se compare​

Stirling-PDF sur le module Cloud Run de RAD coûte environ 19,16 $ US par mois dans un projet Google Cloud que vous possédez, les frais de module étant facturés une fois en crédits RAD. Stirling-PDF est sans état et sans base de données, c'est donc la configuration la moins chère du côté Cloud Run de la plateforme. Pour le coût de fonctionnement le plus bas, il reste ici ; GKE Autopilot ne vaut la peine que s'il doit être associé à d'autres charges de travail Kubernetes — voir le guide GKE pour cette option, à environ 45,68 $ US par mois à la place. Si vous n'en avez besoin qu'occasionnellement — un lot de documents, un job de conversion unique — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de payer pour qu'il reste inactif. Voir Mettez-le en pause gratuitement, ci-dessous. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

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éploiement40 crédits (4 $ US au prix de la recharge)36 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 de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 19,16 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 16 crédits par jour, environ 480 par mois (environ 48 $ 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 minimum acheté est conservé en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : le premier à 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, le réseau est partagé par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas un deuxième ensemble de celui-ci.

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

Ressource (module par défaut)Par mois
Cloud Run, 1x vCPU / 2 GiB (scaleToZero)13,16 $ US
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Total19,16 $ US

Comment cela se compare​

  • Le plan hébergé de Stirling PDF, Stirling PDF Team, coûte 99 $/mois pour un maximum de 100 utilisateurs sur son SaaS hébergé — des frais par organisation destinés aux équipes, et non un coût d'infrastructure (source : stirling.com/pricing). Le chiffre du projet propre de RAD est une petite fraction de cela car il s'agit du coût de calcul brut de Cloud Run sans frais de logiciel par siège.
  • Une comparaison autogérée : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte le même 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — tous plus que le chiffre Cloud Run du projet propre de RAD, et tous doivent être maintenus à jour manuellement, ce que Secret Manager et la surveillance gérés par RAD couvrent autrement.
  • Sans base de données et sans état persistant, Stirling-PDF est proche du plancher de ce que coûte tout déploiement sur RAD — la quasi-totalité de la facture est le conteneur Cloud Run lui-même.

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

Si Stirling-PDF s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démolit pas les ressources de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

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

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter la mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce qu'il faut : vous devez posséder le projet (pas un projet dont RAD ne gère que la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services fonctionnent à nouveau pleinement dans les 36 heures suivant une restauration.

Un véritable écart : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Stirling-PDF lui-même ne contient pas de base de données, donc 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​

Dans votre propre projet, ou une fois que la fenêtre de restauration de 30 jours est passée, l'alternative est de supprimer Stirling-PDF purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 40 crédits (4,00 $ US) dans votre propre projet, ou 36 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Stirling-PDF reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût de fonctionnement quotidien — par rapport au total du projet propre ci-dessus (environ 0,64 $ US par jour), cela représente environ 8 jours ou plus, ou environ 3 jours ou plus dans un projet géré par RAD (16 crédits par jour). Il n'y a pas de base de données ici, donc la suppression de cette application libère l'intégralité de son coût de fonctionnement plutôt qu'une simple part de celui-ci.

Conservez d'abord les données : tout ce que Stirling-PDF écrit dans un bucket de sauvegarde à l'intérieur du déploiement est supprimé avec lui, alors copiez tout ce que vous voulez conserver avant de supprimer.

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 l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite fixée par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est interrompue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres de RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration ; stirling.com/pricing pour le prix hébergé de Stirling PDF Team.

1. Vue d'ensemble​

Stirling-PDF s'exécute en tant que conteneur Java / Spring Boot (avec un LibreOffice intégré pour les conversions de documents) sur Cloud Run v2. Le déploiement relie un ensemble délibérément restreint de services Google Cloud — Stirling-PDF est sans état, il n'y a donc pas de base de données, pas de stockage persistant et pas de secrets à gérer :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Java, 1 vCPU / 2 GiB par défaut, autoscaling sans serveur ; mise à l'échelle à zéro activée
Image de conteneurArtifact RegistryImage officielle stirlingtools/stirling-pdf, mise en miroir par défaut
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé
Redis (inerte)RedisDésactivé par défaut. enable_redis ne fait que l'injection par la fondation des variables d'environnement REDIS_* — Stirling-PDF ne les lit jamais, donc cela ne fournit aucune limitation de débit ou détection de bot
ObservabilitéCloud Logging / Cloud MonitoringJournaux de conteneurs, métriques, vérification de disponibilité et alertes facultatives

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

  • Sans état — pas de base de données, pas de stockage, pas de secrets. database_type = "NONE", pas de buckets GCS, pas de NFS, et une carte de secrets vide. Chaque opération PDF s'exécute dans un répertoire de travail éphémère par requête qui est supprimé à la fin.
  • Image pré-construite. container_image_source = "prebuilt" déploie l'image officielle stirlingtools/stirling-pdf directement ; enable_image_mirroring = true la met en miroir dans Artifact Registry pour éviter les limites de débit de Docker Hub.
  • La connexion est désactivée par défaut. enable_login = false (SECURITY_ENABLELOGIN=false) fournit une instance ouverte. Activez-la et placez le service derrière IAP ou Cloud Armor pour un déploiement privé.
  • Facturation basée sur les requêtes + mise à l'échelle à zéro. cpu_always_allocated = false et min_instance_count = 0 — le CPU est facturé uniquement lors du traitement d'une requête, et le service se met à l'échelle à zéro lorsqu'il est inactif. Un démarrage à froid ajoute quelques secondes de préchauffage de la JVM.
  • Plancher de mémoire de 2 GiB. La JVM plus LibreOffice nécessite au moins 2Gi ; augmentez memory_limit pour les charges de travail OCR / conversion lourdes.
  • Ingress public par défaut. ingress_settings = "all" pour que la boîte à outils soit accessible à son URL run.app. Combinez avec IAP pour un accès protégé par l'identité.
  • Les sondes de santé atteignent /api/v1/info/status — un point de terminaison public, non authentifié, qui renvoie 200 une fois que la JVM et LibreOffice ont été initialisés (fenêtre de ~70s au premier démarrage).

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 Stirling-PDF​

Stirling-PDF s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge de requêtes entre le nombre minimum (0) et maximum d'instances. 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. Artifact Registry — l'image de conteneur​

L'image officielle stirlingtools/stirling-pdf est mise en miroir dans Artifact Registry (enable_image_mirroring = true) et Cloud Run la tire de là. Aucune étape Cloud Build ne s'exécute — l'image est pré-construite en amont.

  • Console : Artifact Registry → Dépôts.
  • CLI :
    gcloud artifacts repositories list --project "$PROJECT" --location "$REGION"
    gcloud artifacts docker images list <repo-path> --project "$PROJECT"

Voir App_CloudRun pour le mécanisme de mise en miroir et la rétention d'images.

C. Réseau et ingress​

Le service est accessible à son URL run.app par défaut (ingress_settings = "all"). 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 de contrôle d'egress 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.

D. Redis (inerte — enable_redis n'a aucun effet sur l'application)​

Redis est désactivé par défaut (enable_redis = false). La définition de enable_redis = true ne fait que l'injection par la fondation App_CloudRun des variables d'environnement REDIS_HOST/REDIS_PORT/ REDIS_AUTH dans le conteneur — Stirling-PDF ne les lit jamais. Le propre commentaire de stirlingpdf.tf confirme "pas de DB ou Redis", et ni StirlingPDF_Common ni ce module ne mappent ces variables d'environnement dans aucun paramètre reconnu par Stirling-PDF. L'activation de Redis n'implémente pas la limitation de débit ou la détection de bot pour cette application ; il n'y a aucun moyen pris en charge d'ajouter ce comportement à Stirling-PDF via ce module. Utilisez enable_cloud_armor pour une véritable atténuation des abus sur une instance publique.

  • CLI (pour confirmer que les variables d'environnement sont présentes mais inutilisées) :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

E. Identity-Aware Proxy (facultatif)​

Étant donné que Stirling-PDF traite des documents potentiellement sensibles, un déploiement privé devrait restreindre l'accès avec IAP. L'activation de enable_iap nécessite une identité Google authentifiée et autorisée avant que toute requête n'atteigne le service — aucun VPN ou configuration de connexion Stirling-PDF n'est nécessaire.

  • Console : Sécurité → Identity-Aware Proxy.
  • CLI :
    gcloud iap web get-iam-policy --resource-type=backend-services --project "$PROJECT"

Voir App_CloudRun pour le câblage IAP.

F. Cloud Logging et Monitoring​

Les journaux de conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte facultatives.

  • 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 Stirling-PDF​

  • Rien n'est persistant. Les téléchargements sont écrits dans un répertoire de travail éphémère par requête et supprimés lorsque la réponse est renvoyée. Il n'y a pas de base de données et pas de bucket — un redéploiement ou un événement de mise à l'échelle ne perd rien car il n'y a rien à perdre.
  • Démarrage lent au premier boot. L'initialisation de Spring Boot et LibreOffice prend des dizaines de secondes. La sonde de démarrage cible /api/v1/info/status et permet jusqu'à ~70 secondes (10s de délai initial + 6 × 10s) avant que la révision ne soit marquée comme non saine.
  • La connexion est facultative et désactivée par défaut. enable_login = false fournit une instance ouverte. Définissez enable_login = true pour exiger l'authentification intégrée de Stirling-PDF ; combinez avec IAP pour une défense en profondeur.
  • Les mises à niveau de version sont des mises à jour de balises d'image. Étant donné que l'image est non modifiée en amont et qu'il n'y a pas de schéma, la modification de application_version déploie une nouvelle révision sans étape de migration.
  • Fichiers volumineux et conversions longues. Augmentez memory_limit et timeout_seconds pour les documents volumineux ou l'OCR lourd ; définissez SYSTEM_MAXFILESIZE via environment_variables pour limiter la taille de téléchargement.
  • Confirmer la configuration en cours d'exécution :
    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT" \
    --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. Seuls les paramètres spécifiques ou notables pour Stirling-PDF sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)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[]Adresses e-mail autorisées à accéder 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_namestirlingpdfNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameStirling-PDFNom lisible par l'homme affiché dans la console.
application_versionlatestBalise d'image Stirling-PDF ; épingler à une version spécifique en production.
enable_loginfalseActiver l'authentification intégrée de Stirling-PDF (SECURITY_ENABLELOGIN).
default_localeen-USLocale d'interface utilisateur par défaut (SYSTEM_DEFAULTLOCALE).

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltDéployer l'image officielle (prebuilt) ou construire une image personnalisée.
cpu_limit1000mCPU par instance.
memory_limit2GiMémoire par instance ; plancher de 2 Gi pour JVM + LibreOffice.
cpu_always_allocatedfalseFacturation basée sur les requêtes — Stirling-PDF n'a pas de travail en arrière-plan.
min_instance_count0Fixé à 0 (mise à l'échelle à zéro) — le module code en dur cette valeur ; la variable n'est pas transmise à la fondation et ne peut pas être modifiée.
max_instance_count3Limite supérieure d'autoscaling (sûr à augmenter — pas d'état partagé).
container_port8080Stirling-PDF écoute sur le port 8080.
execution_environmentgen2Gen2 recommandé.
timeout_seconds60Durée maximale de la requête ; augmenter pour les conversions volumineuses.
enable_cloudsql_volumefalseNon utilisé — Stirling-PDF n'a pas de base de données.
enable_image_mirroringtrueMettre l'image en miroir dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
ingress_settingsallall pour l'accès public ; internal-and-cloud-load-balancing derrière un équilibreur de charge.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Recommandé pour les instances privées/documents sensibles.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres Stirling-PDF supplémentaires (par exemple SYSTEM_MAXFILESIZE). La connexion et la locale sont définies via enable_login / default_locale.
secret_environment_variables{}Références Secret Manager. Stirling-PDF n'en a pas besoin par défaut.
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​

Stirling-PDF est sans état, donc les entrées de sauvegarde (backup_schedule, backup_retention_days, enable_backup_import, backup_source, backup_uri, backup_format) n'ont pas de données d'application à protéger. Laissé aux valeurs par défaut.

Groupe 8 — CI/CD et Binary Authorization​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

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. Recommandé pour les instances publiques.
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_storagefalseStirling-PDF est sans état — pas de bucket par défaut.
storage_buckets[]Buckets GCS supplémentaires facultatifs.
enable_nfsfalseNFS désactivé par défaut ; activer uniquement si Redis est colocalisé sur le serveur NFS.
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_typeNONEFixe — Stirling-PDF n'utilise pas de base de données.
database_password_length32Non utilisé.
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéNon applicable.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/v1/info/status, délai de 10s, 6 tentativesSonde de démarrage. Fenêtre de ~70s au premier démarrage pour JVM + LibreOffice.
liveness_probeHTTP /api/v1/info/status, délai de 15sSonde de vivacité.
uptime_check_config{ enabled=false, path="/api/v1/info/status" }Vérification de disponibilité Cloud Monitoring.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Redis (passthrough de fondation inerte)​

VariableValeur par défautDescription
enable_redisfalseInerte pour Stirling-PDF : ne fait que l'injection par App_CloudRun des variables d'environnement REDIS_HOST/REDIS_PORT/REDIS_AUTH, que l'application ne lit jamais. Aucune limitation de débit ou détection de bot ne résulte de l'activation de ceci.
redis_host""Point de terminaison Redis. Laisser vide pour utiliser l'adresse IP du serveur NFS. Non utilisé par Stirling-PDF quelle que soit la valeur.
redis_port6379Port Redis. Non utilisé par Stirling-PDF quelle que soit la valeur.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible). Non utilisé par Stirling-PDF quelle que soit la valeur.

Groupe 22 — VPC Service Controls 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 simulation (dry-run).
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Renvoyé lors d'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 run.app par défaut 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 (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés (vides — Stirling-PDF est sans état).
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_namesÉtat de la surveillance, canaux, vérifications de disponibilité.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_nameRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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

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

Validation héritée au moment de la planification. Ce module transmet sa configuration via le moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — IAP sans identités autorisées, un environnement d'exécution gen1 avec des montages NFS/GCS, un redis_port/timeout_seconds hors plage, une mémoire inférieure au plancher gen2. Une configuration invalide échoue la planification avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'au moment de l'application ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
enable_login + ingressenable_login = true ou IAP pour usage privéÉlevéenable_login = false par défaut + ingress public laisse une boîte à outils PDF ouverte que toute personne ayant l'URL peut utiliser.
enable_iapActiver pour les instances de documents sensiblesÉlevéSans IAP (et avec la connexion désactivée), le service n'est pas authentifié ; les utilisateurs peuvent télécharger des documents confidentiels vers un point de terminaison ouvert.
memory_limit2GiÉlevéEn dessous de ~2 Gi, la JVM + LibreOffice tue le processus par manque de mémoire pendant les conversions ; gen2 rejette également < 512Mi au moment de la planification.
timeout_seconds60, augmenter pour les fichiers volumineuxÉlevéLes jobs OCR/conversion volumineux dépassant le délai d'attente renvoient 504 en cours d'opération.
Fenêtre startup_probeConserver la valeur par défaut de ~70sMoyenRaccourcir le délai initial / le seuil d'échec marque la révision comme non saine avant que LibreOffice ne termine son préchauffage.
enable_cloud_armorActiver pour les instances publiquesMoyenUne boîte à outils publique sans WAF est exposée aux abus et à l'analyse automatisée.
enable_redisLaisser false — il est inerte pour cette applicationFaibleL'activer n'ajoute que des variables d'environnement REDIS_* inutilisées à la révision ; Stirling-PDF ne les lit jamais, donc cela ne fournit aucune limitation de débit ou détection de bot. Utilisez enable_cloud_armor à la place pour une véritable atténuation des abus.
min_instance_count0 (fixe)FaibleLa mise à l'échelle à zéro ajoute quelques secondes de préchauffage de la JVM à la première requête après l'inactivité. Le module code en dur min_instance_count = 0 — la variable n'est pas transmise, elle ne peut donc pas être augmentée à 1 pour éliminer les démarrages à froid.
SYSTEM_MAXFILESIZE (via environment_variables)Définir une limite raisonnableFaibleLes téléchargements illimités permettent à un seul fichier volumineux de consommer la mémoire de l'instance.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Stirling-PDF partagée avec la variante GKE est décrite dans StirlingPDF_Common.

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