Aller au contenu principal

OpenProject sur Google Cloud Run

OpenProject sur Google Cloud Run

OpenProject est une suite de gestion de projet et de collaboration d'équipe open source, sous licence GPLv3 — paquets de travail, diagrammes de Gantt, tableaux agiles, wikis, suivi du temps et budgets. Ce module déploie OpenProject 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 qu'OpenProject utilise 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, entrée 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 — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte OpenProject sur RAD, et comment cela se compare​

Pour une équipe de dix personnes, OpenProject sur le module Cloud Run de RAD coûte environ 181 $ US par mois, sans licence par utilisateur. L'édition Cloud hébergée d'OpenProject n'a pas de plan adapté à une équipe de dix personnes (voir ci-dessous) ; 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. Les chiffres sont valables au 8 octobre 2026 ; les sources sont énumérées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 181 $ 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éploiement300 crédits (30 $ US au prix de la recharge)270 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites, puis 2 crédits chacune, et rien pour la suppression ou un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 113 crédits par jour, soit environ 3 390 par mois (environ 339 $ 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

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 (valeur par défaut du module)Par mois
Cloud Run, 2 vCPU / 4 Gio (alwaysOn)110,42 $ 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 181 $ US
  • Cloud SQL et Cloud Run coûtent le même prix en africa-south1 (Johannesburg) ; la VM coûte environ 10 % de plus.
  • Ce module maintient au moins une instance en cours d'exécution par défaut (min_instance_count est au moins 1), de sorte que la ligne Cloud Run ci-dessus ne se réduit pas entre les requêtes.
  • Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 $ US par mois à elle seule.

Comment cela se compare​

  • L'édition Cloud hébergée d'OpenProject n'a pas de prix clair pour dix utilisateurs. Chaque plan payant (à partir de 5,95 €/utilisateur/mois) nécessite un minimum de 25 utilisateurs (openproject.org/pricing, 8 octobre 2026) ; le seul plan qui convient réellement à une équipe de dix personnes est le plan communautaire gratuit — la même édition que RAD déploie.
  • Un VPS nu dimensionné près de l'empreinte 2 vCPU / 4 Gio d'OpenProject — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $ US/mois, ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) à environ 49 $ US/mois — est moins cher en espèces que les chiffres RAD ci-dessus.
  • La différence est le temps d'administration : les sauvegardes Cloud SQL et la récupération ponctuelle, Secret Manager et la surveillance Google Cloud sont inclus sur RAD. Sur un VPS nu, PostgreSQL, les sauvegardes, les correctifs et les mises à niveau sont votre travail.
  • Si OpenProject doit rester actif sans mise à l'échelle à zéro, ou fonctionner à côté d'autres charges de travail Kubernetes, consultez plutôt le guide GKE — environ 150 $ US par mois dans votre propre projet, ou 3 330 crédits (environ 266 à 333 $ US) par mois dans un projet géré par RAD.

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

Si OpenProject s'exécute dans un projet géré par RAD pour vous, vous disposez d'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 à une utilisation occasionnelle — préparation d'une certification, environnement de démonstration, activité saisonnière — que l'exécution continue d'OpenProject.

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. 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. Contrairement à la suppression d'un seul module, cela ne détruit pas Cloud SQL, aucune VM 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. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 339 $ US par mois pour le maintenir en fonctionnement. Déployez OpenProject, 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 le temps réel d'activité d'OpenProject.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox, adapté à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes d'OpenProject 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 apporté des modifications à OpenProject que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme dans 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 redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 300 crédits (30,00 $ US), car RAD recrée le projet et les services partagés avant OpenProject. La suppression ne permet d'économiser de l'argent que si OpenProject reste inutilisé pendant environ 6 jours ou plus, à la fois dans votre propre projet (environ 6,03 $ US par jour) et dans un projet géré par RAD (113 crédits par jour).
  • La majeure partie du coût d'exécution est généralement la base de données et la VM de fichier/cache partagée. Elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, de sorte que la suppression d'OpenProject alors que quelque chose d'autre partage le projet n'économise que la partie calcul d'OpenProject.
  • Conservez d'abord les données. Les sauvegardes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci. Copiez donc la dernière sauvegarde avant de la supprimer si vous souhaitez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lors du déploiement.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose de l'application 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 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 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 ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle ; Tarification OpenProject.


1. Vue d'ensemble​

OpenProject s'exécute en tant que conteneur Ruby on Rails (Puma) sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Rails/Puma, 2 vCPU / 4 Gio par défaut, CPU toujours alloué
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — OpenProject ne prend pas en charge MySQL ou d'autres moteurs
Stockage des pièces jointesCloud Filestore (NFS)Stockage durable des pièces jointes des paquets de travail, monté à /opt/openproject/storage
SecretsSecret ManagerSECRET_KEY_BASE auto-généré ; mot de passe de la base de données
EntréeURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé
Tâches d'arrière-plangood_job (en cours, sur PostgreSQL)Pas de Redis — la file d'attente des tâches réside dans PostgreSQL

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; la sélection de tout autre moteur empêche le démarrage.
  • Connexion à la base de données TCP par IP privée. enable_cloudsql_volume = false sur Cloud Run. OpenProject (Rails) lit une seule URL sous forme DATABASE_URL, et l'analyseur URI de Ruby ne peut pas contenir le répertoire du socket Unix de Cloud SQL (ses deux-points interrompent l'analyse de l'URL), de sorte que le point d'entrée se connecte via l'IP privée de l'instance avec sslmode=require.
  • Pas de Redis. Les tâches d'arrière-plan s'exécutent via good_job avec la file d'attente dans PostgreSQL (GOOD_JOB_EXECUTION_MODE = async) ; enable_redis est transféré en tant que false.
  • SECRET_KEY_BASE est généré automatiquement et stocké dans Secret Manager. Il ne doit jamais être modifié après le premier démarrage — le modifier rendrait illisibles toutes les sessions existantes et toutes les colonnes de base de données chiffrées.
  • Le CPU est toujours alloué (cpu_always_allocated = true, min_instance_count = 1) car le worker good_job et le planificateur cron doivent continuer à fonctionner sans requête entrante. Cela annule la mise à l'échelle à zéro par conception ; voir le tableau des pièges pour le retour en arrière axé sur les coûts.
  • Les migrations s'exécutent dans un job db-migrate, pas au démarrage. Le service s'exécute en mode web uniquement (./docker/prod/web) ; un job dédié au moment de l'apply exécute rake db:migrate db:seed en premier, de sorte que le conteneur web démarre rapidement avec un schéma migré.
  • Les sondes de santé sont TCP / désactivées. Rails 8 Host Authorization 400 toute sonde HTTP dont l'en-tête Host est l'IP du pod, de sorte que la sonde de démarrage est TCP et la sonde de vivacité est désactivée.
  • La première connexion est admin / admin. OpenProject force un changement de mot de passe lors de la première connexion — faites-le immédiatement.

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

A. Cloud Run — le service OpenProject​

OpenProject 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 minimal et maximal 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écurisés.

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

OpenProject stocke toutes les données d'application (projets, paquets de travail, wikis, utilisateurs, métadonnées des pièces jointes) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Sur Cloud Run, le service se connecte via l'IP privée de l'instance avec sslmode=require (pas le socket du proxy d'authentification — l'analyseur DSN d'URL de Ruby ne peut pas contenir le répertoire du socket). Lors du premier déploiement, le job db-init crée la base de données et l'utilisateur, et le job db-migrate exécute rake db:migrate db:seed pour construire le schéma et initialiser le compte administrateur.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    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 Filestore (stockage de pièces jointes NFS)​

Les pièces jointes des paquets de travail sont stockées sur un partage NFS Cloud Filestore monté à /opt/openproject/storage (enable_nfs = true par défaut) ; le module pointe OpenProject vers celui-ci en définissant OPENPROJECT_ATTACHMENTS__STORAGE__PATH sur nfs_mount_path chaque fois que NFS est activé. Sans cela, les pièces jointes atterrissent sur le disque éphémère du conteneur et sont perdues à chaque révision/redéploiement.

  • Console : Filestore → Instances.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"

Pour utiliser un stockage d'objets compatible GCS à la place, définissez les variables d'environnement OPENPROJECT_FOG_*. Voir App_CloudRun pour le modèle de serveur NFS.

D. Secret Manager​

Un secret cryptographique est généré automatiquement et stocké dans Secret Manager : SECRET_KEY_BASE (signature de session/cookie Rails et dérivation de clé de colonne chiffrée). 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~secret-key-base"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

E. Réseau et entrée​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'entrée et de sortie VPC contrôlent la connectivité. OpenProject construit des URL absolues à partir de OPENPROJECT_HOST__NAME (défini par le point d'entrée) et OPENPROJECT_HTTPS = true.

  • 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 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 OpenProject​

  • Configuration de la base de données en deux phases lors du premier déploiement. Le job db-init (postgres:15-alpine) crée le rôle et la base de données ; le job db-migrate exécute ensuite l'image de l'application avec rake db:migrate db:seed. Le job de migration supprime toutes les tables partielles d'une tentative précédente interrompue (DROP OWNED BY CURRENT_USER CASCADE) avant la migration, et crée l'extension pg_trgm nécessaire aux index trigrammes d'OpenProject. Les deux jobs s'exécutent au moment de l'apply.
  • Les migrations ne s'exécutent pas au démarrage. Le service s'exécute en mode web uniquement (./docker/prod/web), ce qui ignore le seeder tout-en-un. Rails (production) refuse de démarrer Puma tant que des migrations sont en attente, donc si db-migrate échoue, la création du service échoue bruyamment — il n'y a pas de livraison silencieuse de base de données vide.
  • SECRET_KEY_BASE est immuable après le premier démarrage. Il est généré une fois et stocké dans Secret Manager. Le modifier rend les sessions existantes et toutes les colonnes chiffrées illisibles. Ne le modifiez que pendant une fenêtre de maintenance planifiée avec un plan de rechiffrement complet des données.
  • Les tâches d'arrière-plan s'exécutent en interne. good_job exécute son worker et son cron à l'intérieur du conteneur web (GOOD_JOB_EXECUTION_MODE = async) avec la file d'attente sur PostgreSQL — pas de Redis. C'est pourquoi le CPU est toujours alloué par défaut.
  • L'autorisation d'hôte protège les sondes de santé. Rails 8 renvoie 400 Invalid host_name à toute requête dont l'en-tête Host n'est pas OPENPROJECT_HOST__NAME, y compris les sondes de santé HTTP (qui utilisent l'IP du pod). La sonde de démarrage est donc TCP et la sonde de vivacité est désactivée ; la sonde de disponibilité atteint /health_checks/default où la plateforme définit correctement Host.
  • La première connexion est admin / admin. Initialisée par rake db:seed. OpenProject force un changement de mot de passe lors de la première connexion.
  • Inspecter l'exécution des tâches :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

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 OpenProject 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_nameopenprojectNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameOpenProjectNom lisible par l'homme affiché dans la console.
description(défini)Description du service.
application_versionlatestTag d'image OpenProject (OPENPROJECT_VERSION). latest est épinglé à la version majeure stable 16 ; OpenProject ne publie que des tags majeurs numériques.
db_nameopenprojectNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_useropenprojectUtilisateur de la base de données de l'application.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit2000mCPU par instance ; 2 vCPU recommandés.
memory_limit4GiMémoire par instance ; Rails a besoin de marge pour les migrations et les workers.
cpu_always_allocatedtrueMaintient le CPU alloué afin que le worker good_job et le cron s'exécutent sans requêtes entrantes.
min_instance_count1Maintient une instance chaude pour les tâches d'arrière-plan.
max_instance_count5Limite supérieure de l'autoscaling.
container_port8080Port de liaison par défaut de Puma ; le module exécute ./docker/prod/web (Puma directement), contournant le proxy Apache de l'image tout-en-un sur le port 80.
execution_environmentgen2Gen2 requis pour les montages NFS.
timeout_seconds300Durée maximale de la requête (0 à 3600 secondes).
enable_cloudsql_volumefalseDésactivé sur Cloud Run — OpenProject se connecte via TCP par IP privée.
enable_image_mirroringtrueMettre en miroir l'image OpenProject dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.
max_revisions_to_retain7Nombre d'anciennes révisions à conserver.

Groupe 5 — Accès et contrôle d'entrée​

VariableValeur par défautDescription
ingress_settingsallEntrée publique pour l'accès au navigateur et à l'API.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google devant OpenProject.
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 non secrets supplémentaires (par exemple, remplacements de OPENPROJECT_*). Ne pas définir SECRET_KEY_BASE ou DATABASE_URL ici — ils sont gérés automatiquement.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager.
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 ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

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, 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.
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_buckets[{ name_suffix = "data" }]Buckets GCS provisionnés par défaut ; en ajouter d'autres pour des besoins personnalisés.
enable_nfstrueCloud Filestore pour le stockage durable des pièces jointes.
nfs_mount_path/opt/openproject/storageChemin des pièces jointes OpenProject à l'intérieur du conteneur.
gcs_volumes[]Montages de volumes 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
db_nameopenprojectNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_useropenprojectUtilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16 à 64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.

Groupe 13 — Tâches et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser les jobs db-init + db-migrate intégrés.
cron_jobs[]Cloud Scheduler + Cloud Run Jobs facultatifs (par exemple, un point de terminaison cron externe si vous passez au démarrage à froid).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP, délai de 30s, fenêtre de 30 × 15sTCP car Rails Host Authorization 400 les sondes HTTP ; vérifie que Puma écoute.
liveness_probedésactivéCloud Run n'a pas de sonde de vivacité TCP ; une sonde HTTP redémarrerait en boucle un conteneur sain.
startup_probe_configHTTP /, activé, délai de 60s, failure_threshold 30Sonde structurée au niveau App_CloudRun (parallèle à startup_probe, qui est ce qui contrôle réellement le conteneur).
health_check_configHTTP /, activé, délai de 60s, failure_threshold 3Sonde de vivacité structurée au niveau App_CloudRun (parallèle à liveness_probe, qui est désactivée sur le conteneur).
uptime_check_configdésactivéVérification de disponibilité Cloud Monitoring ; activer pour la surveillance de production.
alert_policies[]Politiques d'alerte métrique.

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.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Retourné 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é).
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 Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés.
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é.
initialization_jobsNoms des jobs de configuration (db-init, db-migrate).
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_name / cloudbuild_trigger_idRegistre 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 du plan. Ce module transmet sa configuration au moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment du plan — un réplica en lecture sans son primaire, IAP sans identités autorisées, un runtime gen1 avec des montages NFS/GCS, un database_type qui ne correspond pas à une extension activée, un backup_retention_days hors plage. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'au moment de l'apply ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence si incorrect
SECRET_KEY_BASE (auto-généré)Ne jamais modifier après le premier démarrageCritiqueLe modifier rend toutes les sessions existantes et toutes les colonnes de base de données chiffrées illisibles.
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données.
enable_nfstrueCritiqueLe désactiver place les pièces jointes sur un disque éphémère — elles sont perdues à chaque révision/redéploiement.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
enable_cloudsql_volumefalse sur Cloud RunÉlevéL'activation du socket rend le DSN d'URL de Rails impossible à analyser (les deux-points du socket cassent l'URL) ; l'application ne parvient pas à se connecter.
startup_probe.typeTCPÉlevéUne sonde de démarrage HTTP atteint l'autorisation d'hôte Rails (400 Invalid host_name) et ne passe jamais — la révision ne devient jamais prête même si Puma est sain.
liveness_probe.enabledfalseÉlevéUne sonde de vivacité HTTP 400 sur l'autorisation d'hôte et redémarre en boucle un conteneur sain.
memory_limit4GiÉlevéLes migrations et les workers internes OOM en dessous de ~2 Gio.
cpu_always_allocatedtrueMoyenLa définition de false limite le worker/cron good_job à ~0 entre les requêtes — les e-mails/notifications d'arrière-plan sont bloqués. Ne revenir en arrière qu'avec un point de terminaison cron Cloud Scheduler externe.
application_versionÉpingler une version majeure (16)Moyenlatest n'a pas de tag d'image sur Docker Hub ; le module l'épingle à 16. Épingler explicitement pour contrôler les mises à niveau.
min_instance_count1MoyenDéfinir 0 uniquement avec cpu_always_allocated = false et un cron externe — sinon les tâches d'arrière-plan s'arrêtent entre les requêtes.
enable_iapselon les besoinsMoyenIAP bloque tout accès non authentifié, y compris l'API ; n'activer que si cela est intentionnel.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, entrée 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 à OpenProject partagée avec la variante GKE est décrite dans OpenProject_Common.

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