Aller au contenu principal

Plane sur Google Cloud Run

Plane sur Google Cloud Run

Plane est une plateforme open source de gestion de projet — une alternative à Jira / Linear pour les problèmes, les cycles, les modules et les feuilles de route. Ce module déploie Plane sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Plane et sur la manière de les explorer et de les exploiter à partir de la console Google Cloud et de la ligne de commande. Pour les mécanismes communs à toutes les applications 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 Plane sur RAD, et comparaison​

L'exécution de Plane dans votre propre projet Google Cloud coûte environ 109,88 $ US/mois en infrastructure, plus des frais de module uniques de 175 crédits RAD (dimensionnés à 2 vCPU / 4 Gio sur une instance Cloud Run chaude toujours active). RAD facture les frais de module une seule fois, au moment du déploiement — jamais plus lors d'une mise à jour — et les builds sont inclus dans le prix ; l'utilisation de Google Cloud elle-même est facturée à votre propre compte de facturation au prix catalogue de Google. Sur un projet géré par RAD, les mêmes ressources sont mesurées à l'heure en crédits au prix catalogue plus la marge de RAD — environ 79 crédits/jour — et les frais de module sont inférieurs de 10 %, soit 157,50 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement Plane géré par RAD peut être arrêté, sans frais d'exécution, jusqu'à ce que vous en ayez à nouveau besoin. (ou voir le guide GKE si vous avez besoin de Kubernetes)

Ce que vous payez sur RAD​

ÉlémentVotre propre projetProjet géré par RAD
Frais de module175 crédits (une fois)157,50 crédits (une fois)
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 : le temps de build est toujours facturé à la minuteIdentique
Coût d'exécution Google Cloud~109,88 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~79 crédits/jour, mesuré à l'heure au prix catalogue + marge de RAD

Coût d'exécution par défaut dans votre propre projet

Ressource$/mois (prix catalogue Google, us-central1)
Cloud Run, 2x vCPU / 4 Gio (chaud)39,43
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02
Serveur de fichiers NFS/cache (petite VM)13,43
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Total109,88 $

Comparaison​

  • Les créateurs de Plane vendent également Plane Cloud, dont le niveau payant le moins cher (Pro) est de 8 $/utilisateur/mois (6 $/utilisateur/mois facturé annuellement) — vérifié sur leur page de tarification le 8 octobre 2026. Une équipe de 14 personnes paierait plus par mois en sièges Plane Cloud seuls que la facture d'infrastructure totale de ce déploiement, sans limite de sièges ; une équipe de 2-3 personnes paie moins sur Plane Cloud. L'auto-hébergement échange le plafond par siège contre un coût d'infrastructure forfaitaire qui ne croît pas avec les effectifs.
  • Sur un VPS nu, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, effectuez et testez les sauvegardes, et renouvelez les certificats ; Cloud SQL géré, Secret Manager et la surveillance de RAD gèrent les trois pour vous.

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

C'est l'option phare d'un projet géré par RAD, et elle est gratuite pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet lui-même — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne détruit pas la base de données, une VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend.

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. Parce que rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes : c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit. Ce qu'il faut : vous devez être propriétaire du projet (pas seulement faire gérer sa facturation par RAD), 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, donc votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont à nouveau pleinement opérationnels dans les 36 heures suivant une restauration.

Un véritable manque : 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, de sorte que le bucket de sauvegarde est très probablement supprimé dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé ce déploiement et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. 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​

L'autre levier, pour un projet propre (ou un projet géré par RAD au-delà de sa fenêtre de restauration de 30 jours), est de supprimer Plane purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 175 crédits au total pour ce module.

La suppression ne permet d'économiser de l'argent que si Plane reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour ce module, cela représente environ 5 jours ou plus d'inactivité, basé sur son coût d'exécution de 109,88 $ US/mois ci-dessus. La majeure partie de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée, et elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, de sorte que la suppression de cette seule application n'économise que sa propre part de calcul si quelque chose d'autre partage le projet.

Conservez les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

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 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres de RAD et les estimations de crédits quotidiens ; Resource Manager : supprimer et restaurer des projets pour les mécanismes de pause/restauration. https://plane.so/pricing

1. Vue d'ensemble​

La pile auto-hébergée en amont de Plane est multi-services : web / space / admin (frontends), api (Django/gunicorn), worker + beat (Celery), live (collaboration en temps réel), et un job migrator, plus PostgreSQL, Redis, RabbitMQ et un stockage d'objets compatible S3. Ce module déploie l'image communautaire tout-en-un publiée de Plane (makeplane/plane-aio-community), qui regroupe chaque sous-service derrière un proxy inverse Caddy interne sur le port 80 via supervisord — ainsi un service Cloud Run expose toute l'application. Le déploiement relie :

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur tout-en-un (api + workers + frontends + migrator), 2 vCPU / 4 Gio par défaut
Broker de messagesRabbitMQ sidecar in-podrabbitmq:3.13-management-alpine à 127.0.0.1:5672 — obligatoire pour Celery
Base de donnéesCloud SQL pour PostgreSQL 15PostgreSQL simple, aucune extension requise
Cache / backend de file d'attente de tâchesRedisActivé par défaut ; co-hébergé sur la VM du serveur NFS si aucun hôte externe n'est donné
Fichiers partagésFilestore / NFS autogéréRequis pour la colocation Redis (environnement d'exécution gen2)
Stockage d'objetsCloud StorageUn bucket storage dédié est provisionné — le câblage de téléchargement S3 est un TODO documenté
SecretsSecret ManagerSECRET_KEY, LIVE_SERVER_SECRET_KEY et le mot de passe de la base de données gérés automatiquement
IngressURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est le moteur fixe. Plane est une application Django ; database_type = "POSTGRES_15" et aucun autre moteur ne fonctionne.
  • RabbitMQ est obligatoire et s'exécute en tant que sidecar in-pod. Le start.sh de Plane se termine avec un code d'erreur non nul si AMQP_URL est vide. AMQP (TCP 5672) est un protocole non-HTTP que le réseau de service à service de Cloud Run ne peut pas transporter, donc le broker partage le pod à 127.0.0.1:5672. L'état du broker est éphémère (la durabilité de la file d'attente est un TODO documenté).
  • Build personnalisé. Un Dockerfile d'enveloppe mince superpose un point d'entrée de plateforme sur l'image AIO ; le point d'entrée compose les chaînes de connexion DATABASE_URL / REDIS_URL / AMQP_URL que Plane attend des valeurs discrètes DB_* / REDIS_* / RABBITMQ_* que la fondation injecte.
  • application_version par défaut à stable. L'image en amont n'a pas de tag latest — une entrée latest est automatiquement mappée à stable au moment du build.
  • Une instance maintenue en vie, CPU sur demande. min_instance_count = 1 par défaut, car l'instance exécute également le worker et le beat Celery de Plane — à 0, elle est récupérée environ 15 minutes après la dernière requête et chaque tâche périodique s'arrête. cpu_always_allocated = false (facturation basée sur les requêtes) continue de limiter le CPU de cette instance entre les requêtes, donc définissez cpu_always_allocated = true pour un traitement en arrière-plan continu.
  • Deux secrets d'application sont auto-générés dans Secret Manager : Django SECRET_KEY (50 caractères) et LIVE_SERVER_SECRET_KEY (40 caractères, authentification de collaboration en temps réel).
  • Un job db-init s'exécute à chaque apply pour créer de manière idempotente la base de données et l'utilisateur Plane ; les migrations de schéma sont exécutées par l'étape migrator de l'image AIO au démarrage.
  • Les téléchargements de fichiers sont un TODO. Plane a besoin d'un point d'extrémité compatible S3 ; le bucket GCS storage existe mais les clés HMAC d'interopérabilité GCS S3 ne sont pas encore câblées. Les problèmes, projets et cycles fonctionnent sans cela — les pièces jointes et les avatars ne fonctionnent pas.
  • Les sondes de santé ciblent /health via le proxy Caddy interne sur le port 80.

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

A. Cloud Run — le service Plane (avec le sidecar RabbitMQ)​

Plane s'exécute en tant que service Cloud Run v2 unique. Le conteneur principal est l'image tout-en-un (supervisord exécute migrator → api / frontends / live + worker/beat Celery derrière Caddy sur :80) ; un deuxième conteneur sidecar mq exécute RabbitMQ. Le démarrage du conteneur principal attend la sonde TCP 5672 du sidecar.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques. Le sidecar apparaît sous l'onglet Conteneurs de la révision.
  • 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​

Plane stocke les espaces de travail, les projets, les problèmes, les cycles et les utilisateurs dans une instance Cloud SQL gérée pour PostgreSQL 15. Lors du premier déploiement, un job db-init crée la base de données et l'utilisateur de l'application ; l'étape migrator de l'image AIO applique ensuite les migrations Django à chaque démarrage de conteneur. Le point d'entrée de la plateforme se connecte via l'IP TCP privée avec sslmode=require (le volume de socket Cloud SQL est monté, mais Django/psycopg de Plane utilise le DATABASE_URL composé).

  • 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> --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. Redis (backend Celery et cache)​

Redis prend en charge le cache de Plane et le magasin de résultats Celery. Lorsqu'aucun redis_host externe n'est configuré, la VM du serveur NFS co-héberge Redis et son IP est résolue au moment de l'exécution (le point d'entrée substitue l'espace réservé $(NFS_SERVER_IP) avant de composer REDIS_URL).

  • Console : Memorystore → Redis (si vous utilisez une instance gérée) ; Compute Engine → Instances de VM (VM NFS/Redis).
  • CLI :
    redis-cli -h <redis-host> ping
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50 | grep "Composed REDIS_URL"

D. Cloud Storage​

Un bucket storage dédié (gcs-<service-name>-storage) est provisionné pour les téléchargements de fichiers Plane. Le câblage de téléchargement est un TODO : Plane nécessite un point d'extrémité compatible S3, et bien que AWS_S3_ENDPOINT_URL pointe vers https://storage.googleapis.com, les clés HMAC d'interopérabilité S3 de GCS ne sont pas provisionnées — fournissez AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY via environment_variables (ou utilisez un bucket S3 externe) pour activer les pièces jointes.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~plane"
    gcloud storage ls gs://<storage-bucket>/

E. Secret Manager​

Trois secrets sont gérés automatiquement : le SECRET_KEY de Django, le LIVE_SERVER_SECRET_KEY (authentification de collaboration en temps réel) et le mot de passe Cloud SQL. Tous sont injectés au moment de l'exécution ; le texte en clair n'apparaît jamais dans la configuration.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~plane"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

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

F. Réseau et entrée​

Le service est accessible par son URL run.app par défaut ; l'URL prédite est injectée comme WEB_URL / DOMAIN_NAME / CORS_ALLOWED_ORIGINS afin que les redirections OAuth, CORS et les liens e-mail fonctionnent immédiatement. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés — si vous le faites, le domaine doit correspondre à ces variables d'URL.

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

G. Cloud Logging et Monitoring​

Les journaux de conteneurs (y compris la sortie de supervisord de chaque sous-service groupé et le sidecar mq) sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring, avec une vérification de disponibilité facultative contre /health (désactivée par défaut) et des stratégies d'alerte facultatives.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Vérifications de disponibilité.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Plane​

  • Configuration de la base de données au premier déploiement. Un job db-init (postgres:15-alpine) crée de manière idempotente la base de données et l'utilisateur Plane, accorde les privilèges (y compris GRANT <user> TO postgres afin que la propriété puisse être définie), et arrête proprement son sidecar Cloud SQL Proxy. Il s'exécute à chaque apply et peut être réexécuté en toute sécurité.
  • Les migrations s'exécutent au démarrage, pas dans un job d'initialisation. Le supervisord de l'image AIO exécute un programme migrator (manage.py migrate) avant le démarrage de l'API et des frontends. La sonde de démarrage autorise jusqu'à ~5 minutes (30 s de délai initial + 30 × 10 s d'échecs) pour un premier démarrage à froid.
  • Les URL de connexion sont composées par le point d'entrée. Le point d'entrée de la plateforme construit DATABASE_URL (IP privée TCP, sslmode=require ; bouclage avec sslmode=disable sur GKE), REDIS_URL (résolvant $(NFS_SERVER_IP)), et AMQP_URL (à partir de l'hôte injecté du sidecar), puis exécute le /app/start.sh intégré de Plane. Recherchez les lignes de journal Composed DATABASE_URL / REDIS_URL / AMQP_URL lors du débogage.
  • RabbitMQ est obligatoire. Le start.sh de Plane valide AMQP_URL et se termine s'il est vide. L'état du broker du sidecar est éphémère — les tâches Celery en file d'attente sont perdues lors du recyclage de l'instance (durcissement documenté TODO).
  • Configuration initiale — Mode Dieu. Ouvrez <web_url>/god-mode/ pour créer l'administrateur de l'instance et configurer l'instance (le point d'entrée corrige le Caddyfile interne avec une redirection 308 de /god-mode vers /god-mode/, contournant un problème de nom de base SPA Remix). Ensuite, inscrivez-vous à l'URL racine et créez votre premier espace de travail.
  • Les téléchargements de fichiers échouent tant que le stockage S3 n'est pas câblé. Tout le reste (problèmes, projets, cycles, modules) fonctionne ; les pièces jointes et les avatars nécessitent de véritables identifiants S3 (voir §2D).
  • Compromis travail en arrière-plan. Sous les valeurs par défaut cpu_always_allocated = false + min = 1, l'instance reste active mais son CPU est limité entre les requêtes, de sorte que le travail Celery en arrière-plan (notifications, webhooks, exportations) peut prendre du retard. Pour les équipes qui dépendent de notifications en temps opportun, définissez cpu_always_allocated = true ; ne réduisez jamais min_instance_count à 0.
  • Chemin de santé. Les sondes de démarrage et de vivacité et la vérification de disponibilité ciblent /health sur le port 80 (le proxy Caddy interne).
  • Vérification :
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/health"
    gcloud run services logs read <service-name> --region "$REGION" --limit 100 | grep -E "Composed|Starting Plane"

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 Plane 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.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails auxquels sont accordés l'accès au projet et les alertes de surveillance.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameplaneNom de base des ressources. Ne pas modifier après le premier déploiement.
display_namePlane - Project ManagementNom convivial affiché dans la console.
application_versionstableTag de l'image AIO. L'image en amont n'a pas de tag latest — latest est mappé à stable au moment du build.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

VariableValeur par défautDescription
cpu_limit2000mL'image AIO exécute de nombreux processus (api, workers, frontends, Caddy) ; 2 vCPU minimum.
memory_limit4Gi4 Gio recommandés — augmenter si le migrator ou le worker manque de mémoire.
cpu_always_allocatedfalseFacturation basée sur les requêtes : le CPU est limité entre les requêtes, de sorte que les notifications Celery, les webhooks et les exportations peuvent prendre du retard ; définissez true pour un traitement en arrière-plan continu.
min_instance_count1Gardez 1 : l'instance héberge le worker et le beat Celery, donc à 0 les tâches périodiques s'arrêtent une fois qu'elle est récupérée.
max_instance_count3Plafond de coût.
container_port80Le port du proxy Caddy interne — le seul port exposé par le conteneur AIO.
enable_cloudsql_volumetrueMonte le volume de socket Cloud SQL (le point d'entrée se connecte toujours via TCP IP privée).
execution_environmentgen2Requis pour les montages NFS.
timeout_seconds300Délai d'expiration de la requête.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 5 — Contrôle d'accès et d'entrée​

VariableValeur par défautDescription
ingress_settingsallAccès Internet public (requis pour l'accès au navigateur à Plane).
vpc_egress_settingPRIVATE_RANGES_ONLYSortie de plage privée via le connecteur VPC (Cloud SQL, Redis, NFS).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Remplace ou étend l'environnement de Plane. Utilisez ceci pour fournir de véritables identifiants S3 (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, AWS_S3_BUCKET_NAME, AWS_S3_ENDPOINT_URL) une fois le stockage d'objets câblé.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupes 7-10 — Sauvegarde, CI/CD, SQL personnalisé, Domaine et CDN​

Comportement standard d'App_CloudRun — voir App_CloudRun. Notable pour Plane : si vous définissez application_domains, le domaine personnalisé devient l'hôte que les utilisateurs atteignent, et WEB_URL / CORS_ALLOWED_ORIGINS / DOMAIN_NAME doivent le résoudre (remplacer via environment_variables) ou les liens de connexion et d'e-mail seront rompus.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueRequis pour la colocation Redis sur la VM du serveur NFS (gen2).
create_cloud_storagetrueProvisionne le bucket storage déclaré par Plane_Common.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Plane nécessite PostgreSQL — ne pas changer pour MySQL.
db_nameplane_dbNom de la base de données. Immuable après le premier déploiement.
db_userplane_userUtilisateur de l'application. Immuable après le premier déploiement.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré (postgres:15-alpine). Les migrations de schéma sont gérées par le propre migrator de l'image AIO au démarrage.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /health, délai initial de 30 s, 30 échecs × 10 sFenêtre généreuse (~5 min) pour l'étape du migrator au premier démarrage.
liveness_probeHTTP /health, délai de 30 s, période de 30 sVivacité par rapport au point d'extrémité de santé frontal Caddy.
uptime_check_configdésactivé, chemin /healthVérification de disponibilité Cloud Monitoring ; désactivée par défaut.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueRequis — la file d'attente de tâches Celery et le cache de Plane dépendent de Redis.
redis_host""Laissez vide pour utiliser le Redis hébergé sur la VM NFS.
redis_port6379Port Redis.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 22 — VPC Service Controls et journalisation d'audit​

Comportement standard d'App_CloudRun (enable_vpc_sc, vpc_cidr_ranges, vpc_sc_dry_run, enable_audit_logging) — voir App_CloudRun.


5. Sorties​

Retournées 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.
web_urlURL de l'interface utilisateur web de Plane (le proxy Caddy interne sert web/space/admin/api sur cette URL unique).
api_urlURL de l'API Plane (même URL de service, routée par le proxy interne).
service_locationRégion dans laquelle le service s'exécute.
stage_servicesDétails du 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 d'extrémité de la base de données (sensible) / port.
storage_bucketsBuckets Cloud Storage créés (inclut le bucket storage).
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.
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​

Les validations au moment de la planification en détectent plusieurs ; les autres n'apparaissent qu'au moment de l'exécution.

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

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15CritiquePlane est une application Django/PostgreSQL ; MySQL ou NONE interrompt le migrator et le démarrage.
db_name / db_userdéfini 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.
Sidecar RabbitMQlaisser câbléCritiqueLe start.sh de Plane se termine si AMQP_URL est vide — le broker est obligatoire, et il doit être in-pod (Cloud Run ne peut pas router AMQP entre les services).
container_port80CritiqueLe conteneur AIO n'expose que le proxy Caddy interne sur :80 ; tout autre port échoue toutes les sondes.
application_versionstable ou un vrai tagÉlevéL'image en amont n'a pas de tag latest ; le module mappe latest→stable, mais un tag explicite invalide renvoie une erreur 404 au build (MANIFEST_UNKNOWN).
enable_redistrueÉlevéSans Redis, Celery et le cache n'ont pas de backend ; les workers ne démarrent pas.
enable_nfstrue (quand redis_host vide)ÉlevéLe Redis par défaut réside sur la VM NFS ; la désactivation de NFS sans redis_host externe laisse Plane sans point d'extrémité Redis.
Fenêtre d'échec startup_probe≥ 30 × 10 sÉlevéLe migrator au premier démarrage peut prendre des minutes ; une sonde trop serrée tue l'instance en pleine migration.
cpu_always_allocated / min_instance_counttrue / 1 pour les équipes critiques en matière de notificationsMoyenSous les valeurs par défaut (false / 1), le CPU de l'instance est limité entre les requêtes, de sorte que les notifications/webhooks/exportations Celery peuvent prendre du retard.
Stockage d'objets (AWS_*)de vrais identifiants S3 avant de compter sur les téléchargementsMoyenLes téléchargements de fichiers (pièces jointes, avatars) échouent tant que les clés HMAC ou un point d'extrémité S3 externe ne sont pas fournis — le reste de Plane fonctionne.
application_domains + variables d'environnement URLmaintenir la synchronisationMoyenUn domaine personnalisé qui ne correspond pas à WEB_URL/CORS_ALLOWED_ORIGINS/DOMAIN_NAME interrompt les redirections de connexion et les liens e-mail.
memory_limit4GiMoyenL'image AIO exécute de nombreux processus ; un sous-dimensionnement entraîne un manque de mémoire pour le migrator ou le worker Celery.
Durabilité RabbitMQaccepter l'éphémère ou externaliserFaibleL'état du broker sidecar est éphémère ; les tâches en file d'attente sont perdues lors du recyclage de l'instance.

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 à Plane partagée avec la variante GKE est décrite dans Plane_Common.

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