Aller au contenu principal

OpenProject sur GKE Autopilot

OpenProject sur GKE Autopilot

OpenProject est une suite open source de gestion de projet et de collaboration d'équipe sous licence GPLv3 — paquets de travail, diagrammes de Gantt, tableaux agiles, wikis, suivi du temps et budgets. Ce module déploie OpenProject sur GKE Autopilot au-dessus du socle App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

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 à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide du socle App_GKE plutôt que de les répéter ici.


Ce que coûte OpenProject sur RAD, et comparaison​

Pour une équipe de dix personnes, OpenProject sur le module GKE Autopilot de RAD coûte environ 150 $ US par mois, sans licence par utilisateur. GKE convient à OpenProject qui doit rester opérationnel, s'adapter à plusieurs pods ou fonctionner aux côtés d'autres charges de travail Kubernetes. Pour le coût le plus bas, le module Cloud Run exécute le même OpenProject pour environ 181 $ US par mois. Les chiffres sont ceux du 8 octobre 2026 ; les sources sont listé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 150 $ 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éploiement175 crédits (17,50 $ US au prix de la recharge)157,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 (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 141 crédits par jour, soit environ 4 230 par mois (environ 423 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
Qui possède 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 ponctuelle, et moins avec un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, donc 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
Pod GKE Autopilot, 2 vCPU / 4 Gio79,35 $ 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
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Totalenviron 150 $ US, ou environ 223 $ US sans le niveau gratuit
  • Le niveau gratuit de GKE couvre les frais de gestion d'un cluster Autopilot ou zonal par compte de facturation, il ne s'applique donc que si c'est votre seul cluster de ce type. Cloud SQL coûte le même prix en africa-south1 (Johannesburg) ; le pod et la VM coûtent environ 10 % de plus là-bas.
  • GKE Autopilot ne se met pas à l'échelle zéro. Au moins un pod OpenProject est toujours en cours d'exécution, donc le coût ci-dessus est le même que quelqu'un l'utilise ou non ; des pods supplémentaires ne sont ajoutés que sous charge.
  • É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.

Comparaison​

  • 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 $/mois, ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) à environ 49 $/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 à un instant précis, 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.

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 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 à une utilisation occasionnelle — préparer une certification, un environnement de démonstration, une activité saisonnière — que de faire fonctionner OpenProject 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, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable 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 attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune VM ou le cluster GKE un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de réactiver le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 423 $ US par mois pour le maintenir en fonctionnement. Déployez OpenProject, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et le temps pendant lequel OpenProject était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude et de démonstration conviennent). 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 pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

GKE Autopilot ne se met pas à 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) : 175 crédits (17,50 $ 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 devait rester inutilisé pendant environ 4 jours ou plus, à la fois dans votre propre projet (environ 4,99 $ US par jour) et dans un projet géré par RAD (141 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 si rien d'autre dans le projet ne les utilise, donc 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, donc copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres 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 obtient 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 sociétés 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 propres frais de 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 fonctionne comme une charge de travail web Ruby on Rails (Puma). Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods Rails/Puma, 2 vCPU / 4 Gio par défaut, autoscaling horizontal
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
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré
Jobs en arrière-plangood_job (in-process, sur PostgreSQL)Pas de Redis — la file d'attente des jobs 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 interrompt le démarrage.
  • Side-car Cloud SQL Auth Proxy. enable_cloudsql_volume = true sur GKE. Le proxy écoute sur 127.0.0.1 et la branche de bouclage du point d'entrée compose DATABASE_URL sans SSL (le proxy termine TLS).
  • Pas de Redis. Les jobs en 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é comme false.
  • SECRET_KEY_BASE est généré automatiquement et stocké dans Secret Manager. Il ne doit jamais être renouvelé après le premier démarrage — le renouveler rend chaque session existante et toutes les colonnes de base de données chiffrées illlisibles.
  • Les migrations s'exécutent dans un job db-migrate, pas au démarrage. La charge de travail 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 les pods démarrent rapidement avec un schéma migré.
  • Les deux sondes de santé sont TCP. Rails 8 Host Authorization 400 toute sonde HTTP dont l'en-tête Host est l'IP du pod, donc une sonde TCP (écoute de port Puma) est utilisée pour le démarrage et la vivacité. GKE prend en charge une sonde de vivacité TCP, elle reste donc activée (contrairement à Cloud Run).
  • L'affinité de session est ClientIP et un minimum de 1 réplica est maintenu (GKE n'a pas de mise à l'échelle zéro) ; un PodDisruptionBudget maintient les pods en service pendant les mises à niveau de nœuds.
  • Les déploiements basés sur NFS utilisent la stratégie Recreate pour éviter que deux pods n'écrivent le même volume de pièce jointe pendant une mise à jour.
  • 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 vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail OpenProject​

Les pods OpenProject sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. L'autoscaling horizontal des pods dimensionne le déploiement entre le nombre minimum et maximum de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail OpenProject pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

OpenProject stocke toutes les données de l'application (projets, paquets de travail, wikis, utilisateurs) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les pods l'atteignent en privé via le side-car Cloud SQL Auth Proxy sur le bouclage 127.0.0.1 ; aucune IP publique n'est exposée. 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.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs et 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, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.

C. Cloud Filestore (stockage NFS des pièces jointes)​

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é. Cela permet de conserver les pièces jointes durables et partagées entre les pods.

  • Console : Filestore → Instances.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    kubectl get pvc,pv -n "$NAMESPACE"

Voir App_GKE pour les options CMEK et les montages GCS Fuse.

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 le socle.

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

Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.

E. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe Cloud Load Balancing (service_type = LoadBalancer). Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements. OpenProject construit des URL absolues à partir de OPENPROJECT_HOST__NAME et OPENPROJECT_HTTPS, où OPENPROJECT_HTTPS n'est pas codé en dur sur GKE — main.tf définit https_enabled = var.enable_custom_domain, donc ce n'est que true une fois qu'un domaine personnalisé + certificat géré est configuré. Sans domaine personnalisé, l'IP brute du LoadBalancer est uniquement HTTP ; forcer HTTPS dans cet état forcerait la redirection de chaque requête vers une adresse https:// qui ne répond jamais (une panne silencieuse et totale). C'est l'opposé de OpenProject_CloudRun, qui passe toujours https_enabled = true car une URL Cloud Run *.run.app est toujours HTTPS.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

F. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application 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 de migrer, et crée l'extension pg_trgm nécessaire aux index trigrammes d'OpenProject.
  • Les migrations ne s'exécutent pas au démarrage. La charge de travail 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, l'apply échoue bruyamment sur le garde-fou des migrations en attente — il n'y a pas de déploiement silencieux 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 faites pivoter que pendant une fenêtre de maintenance planifiée.
  • Les jobs en arrière-plan s'exécutent en interne. good_job exécute son worker et sa cron à l'intérieur de chaque pod (GOOD_JOB_EXECUTION_MODE = async) avec la file d'attente sur PostgreSQL — pas de Redis.
  • 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 du kubelet (qui utilisent l'IP du pod). Les sondes de démarrage et de vivacité sont donc TCP ; la sonde de disponibilité atteint /health_checks/default.
  • La première connexion est admin / admin. Amorcée par rake db:seed. OpenProject force un changement de mot de passe lors de la première connexion.
  • Inspecter l'exécution du job :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<job-name>

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour OpenProject sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standards.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail 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{}Libellés appliqués à toutes les ressources pour le suivi des coûts/de la propriété.

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.
application_versionlatestTag d'image OpenProject (OPENPROJECT_VERSION). latest est épinglé à la version majeure stable 16 ; épingler explicitement en production.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
min_instance_count1Réplicas minimum (GKE n'a pas de mise à l'échelle zéro).
max_instance_count5Réplicas maximum (limite supérieure HPA).
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.
container_resources2000m / 4GiLimites et requêtes CPU/mémoire. Rails a besoin de marge pour les migrations et les workers.
enable_cloudsql_volumetrueSide-car Cloud SQL Auth Proxy (connexion en boucle locale).
timeout_seconds300Durée maximale de la requête (0 à 3600 secondes).
enable_image_mirroringtrueMettre en miroir l'image OpenProject dans Artifact Registry avant le déploiement.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres non secrets supplémentaires (remplacements OPENPROJECT_*). Ne pas définir SECRET_KEY_BASE ou DATABASE_URL ici.
secret_environment_variables{}Mappage de variable d'environnement → nom de 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 6 — Backend et cluster GKE​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service Kubernetes est exposé.
workload_typenull (Déploiement)Deployment (par défaut) ou StatefulSet.
session_affinityClientIPRoutage persistant pour les sessions d'interface utilisateur.
network_tags["nfsserver"]Tags réseau de nœud/pod ; nfsserver est requis lorsque enable_nfs = true.
termination_grace_period_seconds60Secondes à attendre après SIGTERM avant SIGKILL.
enable_network_segmentationfalseCréer des ressources Kubernetes NetworkPolicy.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enablednullActiver les modèles PVC. Non requis — les pièces jointes utilisent NFS.
stateful_pvc_size10GiTaille de stockage PVC par pod.
stateful_pvc_mount_path/dataChemin de montage du conteneur pour le PVC.
stateful_pvc_storage_classstandard-rwoKubernetes StorageClass pour les PVC.

Groupe 9 — Stratégies de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau de nœuds.
pdb_min_available1Nombre minimum de pods disponibles pendant les perturbations volontaires.
enable_resource_quotafalseAppliquer un ResourceQuota d'espace de noms.
quota_memory_requests / quota_memory_limits(défini)Quota de mémoire de l'espace de noms — doit utiliser des unités binaires (4Gi, 8192Mi).

Groupe 10 — 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_probeTCP, délai de 90sTCP pour qu'un Puma sain reste en vie (GKE prend en charge la vivacité TCP).
startup_probe_config(défini)Sonde d'infrastructure de niveau App_GKE.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring facultatif.
alert_policies[]Stratégies d'alerte métrique facultatives.

Groupe 11 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser les jobs intégrés db-init + db-migrate.
cron_jobs[]CronJobs Kubernetes planifiés.
additional_services[]Services side-car ou auxiliaires déployés aux côtés d'OpenProject.

Groupe 12 — CI/CD et intégration GitHub​

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

Groupe 13 — Système de fichiers (NFS)​

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

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS définis dans storage_buckets.
storage_buckets[{ name_suffix = "data" }]Un bucket data est déclaré par défaut ; étendez la liste si vous en avez besoin de plus.
gcs_volumes[]Montages de volume GCS Fuse via le pilote CSI.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
max_images_to_retain7Nombre maximal d'images récentes d'Artifact Registry à conserver.
delete_untagged_imagestrueSupprimer automatiquement les images non taguées.
image_retention_days30Jours après lesquels les images sont éligibles à la suppression.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
application_database_nameopenprojectNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_useropenprojectUtilisateur de la base de données de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16-64).
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer les pods en rolling update.

Groupe 17 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter à 30-90 pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôte personnalisés + certificat géré (une passerelle avec une IP statique est provisionnée automatiquement).
application_domains[]Noms d'hôte à servir.
reserve_static_iptrueIP externe stable entre les redéploiements.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google devant OpenProject.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder.
iap_oauth_client_id / iap_oauth_client_secret""Requis lorsque IAP est activé (sensible).

Groupe 21 — Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une stratégie Cloud Armor (WAF) au backend Ingress.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
cloud_armor_policy_namedefault-waf-policyNom de la stratégie.
enable_cdnfalseActiver Cloud CDN sur le backend Ingress GKE.

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​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsMappage des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre OpenProject.
database_instance_nameNom de l'instance Cloud SQL.
database_nameNom de la base de données de l'application.
database_userUtilisateur 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 de la base de données (127.0.0.1 via le proxy d'authentification) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration (db-init, db-migrate) et d'importation (facultatif).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_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 base App_GKE, 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, une charge de travail Deployment avec stateful_pvc_enabled = true, un entier brut quota_memory_*, un backup_retention_days hors limites. 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'à l'apply ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
SECRET_KEY_BASE (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueLe faire pivoter rend illisibles toutes les sessions existantes et toutes les colonnes de base de données chiffrées.
application_database_name / application_database_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommer 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 le stockage éphémère du pod — elles sont perdues lorsqu'un pod est replanifié.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
startup_probe.type / liveness_probe.typeTCPÉlevéUne sonde HTTP atteint l'autorisation d'hôte Rails (400 Invalid host_name, Hôte = IP du pod) et ne passe jamais — un pod sain ne devient jamais Ready, ou un pod sain TCP redémarre en boucle.
enable_cloudsql_volumetrue sur GKEÉlevéLe sidecar Auth Proxy fournit la connexion PostgreSQL en boucle locale ; sa désactivation est bloquée par une protection de validation au moment du plan.
memory_limit (via container_resources)4GiÉlevéLes migrations et les workers en cours d'exécution OOM en dessous de ~2 GiB.
min_instance_count1ÉlevéGKE exige min ≥ 1 ; la protection de validation rejette les valeurs invalides.
session_affinityClientIPMoyenSans persistance, les sessions UI peuvent être acheminées vers différents pods entre les requêtes.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont des octets et bloquent toute planification de pod dans l'espace de noms.
enable_pod_disruption_budgettrueMoyenLa désactivation permet à GKE d'expulser tous les pods simultanément pendant la maintenance — avec NFS Recreate, cela interrompt le service.
application_versionÉpingler une version majeure (16)Moyenlatest n'a pas de tag d'image sur Docker Hub ; le module l'épingle à 16. Épinglez explicitement pour contrôler les mises à niveau.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement de base référencé partout — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à OpenProject partagée avec la variante Cloud Run 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.