Plane Common — Configuration d'application partagée
Plane_Common est la couche d'application partagée pour Plane. Elle n'est pas déployée seule ; elle fournit plutôt la configuration spécifique à Plane sur laquelle s'appuient Plane_CloudRun et la variante GKE, afin que les deux variantes de plateforme se comportent de manière identique là où cela compte. Les utilisateurs finaux ne configurent jamais cette couche directement — elle n'a pas d'entrées d'interface utilisateur de déploiement propres — mais comprendre ce qu'elle fournit explique les valeurs par défaut que vous voyez dans la documentation de la plateforme.
Pour l'infrastructure qui provisionne et exécute réellement Plane, consultez le guide de la plateforme (Plane_CloudRun) et les guides de base (App_CloudRun, App_GKE, App_Common).
1. Ce que cette couche fournit
| Domaine | Fourni par Plane_Common | Où cela apparaît |
|---|---|---|
| Image de conteneur | Dockerfile d'encapsulation mince FROM makeplane/plane-aio-community:<version> — l'image tout-en-un regroupant api + worker + beat + web/space/admin + live + migrator derrière un proxy Caddy interne sur :80 | Sortie container_image du déploiement de la plateforme |
| Point d'entrée personnalisé | Compose DATABASE_URL / REDIS_URL / AMQP_URL à partir des valeurs discrètes DB_* / REDIS_* / RABBITMQ_* que la fondation injecte, puis exécute /app/start.sh de Plane | Comportement de l'application dans les guides de la plateforme |
| Secrets | Génère automatiquement le SECRET_KEY (50 caractères) et le LIVE_SERVER_SECRET_KEY (40 caractères) de Django dans Secret Manager | Sorties secret_ids / secret_values, injectées comme variables d'environnement secrètes |
| Moteur de base de données | Fixe Cloud SQL pour PostgreSQL 15 (PostgreSQL pur, sans extensions) | §Base de données dans les guides de la plateforme |
| Amorçage de la base de données | Définit le job db-init (postgres:15-alpine) qui crée la base de données et l'utilisateur de manière idempotente | Sortie initialization_jobs |
| Stockage d'objets | Déclare le bucket Cloud Storage storage (le câblage de téléchargement S3 est un TODO documenté) | Sortie storage_buckets |
| Environnement de base | WEB_URL / DOMAIN_NAME / CORS_ALLOWED_ORIGINS à partir de l'URL de service prédite, SITE_ADDRESS=:80, GUNICORN_WORKERS=2, DEBUG=0, points de terminaison Redis et RabbitMQ, espaces réservés de stockage AWS_* | Environnement du conteneur en cours d'exécution |
| Vérifications de santé | Sondes de démarrage par défaut (/health, délai de 30 s, 30 échecs × 10 s) et de vivacité (/health, délai de 30 s, période de 30 s) | §Observabilité dans les guides de la plateforme |
2. Image de conteneur et point d'entrée personnalisé
Plutôt que de câbler séparément les sept services amont de Plane, Plane_Common utilise l'image communautaire tout-en-un publiée et superpose un point d'entrée de plateforme via un Dockerfile d'encapsulation mince. L'argument de build APPLICATION_VERSION épingle le tag de base ; comme l'image amont n'a pas de tag latest, latest est mappé à stable au moment de la construction.
Le point d'entrée effectue ces actions à chaque démarrage de conteneur :
- URL de la base de données. Préfère l'IP TCP privée injectée (
DB_IP) et composeDATABASE_URLavecsslmode=requirepour les connexions IP privées directes (Cloud Run) ousslmode=disablepour le proxy d'authentification Cloud SQL en boucle locale (GKE). Exporte également les variables discrètesPOSTGRES_*que certains chemins de code Plane lisent. - URL Redis. Résout l'espace réservé
$(NFS_SERVER_IP)à l'exécution (Cloud Run ne substitue pas les références$(VAR)) et composeREDIS_URL. - URL AMQP. Récupère l'hôte du sidecar RabbitMQ (injecté comme
PLANE_MQ_HOSTsur Cloud Run ; DNS intra-cluster sur GKE), supprime tout schéma/port, et composeAMQP_URL. Lestart.shde Plane se termine si cette valeur est vide — RabbitMQ est obligatoire. - Espaces réservés de domaine et de stockage. Dérive
DOMAIN_NAMEdeWEB_URLlorsqu'il n'est pas défini et exporte les valeurs d'espace réservéAWS_*afin que la validation destart.shréussisse (les téléchargements réels nécessitent de vraies informations d'identification S3 — voir §6). - Patch de redirection en mode Dieu. Patche de manière idempotente le Caddyfile fourni avec une redirection 308 de
/god-modevers/god-mode/(le nom de base du routeur de l'admin SPA nécessite la barre oblique finale — sans elle, le panneau d'administration tourne en boucle indéfiniment). - Transfert. Exécute le
/app/start.shfourni par Plane, qui lance supervisord : migrator → api / space / admin / live + worker / beat + le proxy Caddy.
Pour confirmer ce que le point d'entrée a composé :
# Cloud Run — the composed-URL log lines
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 100 \
| grep -E "Composed (DATABASE|REDIS|AMQP)_URL|Starting Plane"
3. Secrets dans Secret Manager
Deux secrets d'application sont générés avec random_password et stockés dans Secret Manager :
| Secret | Variable d'environnement | Objectif |
|---|---|---|
secret-<prefix>-plane-key | SECRET_KEY | Clé de signature cryptographique Django (50 caractères) |
secret-<prefix>-plane-live-key | LIVE_SERVER_SECRET_KEY | Secret partagé authentifiant le serveur de collaboration en temps réel live (40 caractères) |
La fondation gère également le secret du mot de passe Cloud SQL. Inspectez-les :
gcloud secrets list --project "$PROJECT" --filter="name~plane"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Un délai de time_sleep de 30 secondes après la création de la version du secret absorbe le décalage de réplication avant que le service ne les consomme.
4. Moteur de base de données et amorçage
Plane nécessite PostgreSQL ; le moteur est fixé à POSTGRES_15 (aucune extension n'est nécessaire). À chaque apply, le job db-init (postgres:15-alpine) de manière idempotente :
- Attend l'instance avec
pg_isready(socket ou IP privée). - Crée l'utilisateur de l'application (ou réinitialise son mot de passe).
- Accorde le rôle d'utilisateur à
postgresafin que la propriété puisse être attribuée. - Crée la base de données avec l'utilisateur de l'application comme propriétaire (ou transfère la propriété).
- Accorde tous les privilèges sur la base de données et sur
SCHEMA public. - Envoie
POST /quitquitquitau sidecar Cloud SQL Proxy afin que le job se termine proprement.
Les migrations de schéma ne sont pas exécutées par le job d'initialisation — l'étape migrator de l'image AIO (manage.py migrate) s'exécute à l'intérieur de supervisord à chaque démarrage de conteneur, avant que l'API et les frontends ne démarrent.
gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"
gcloud run jobs executions list --project "$PROJECT" --region "$REGION"
5. Contrat de courtier de messages
Le worker Celery et le beat de Plane nécessitent un courtier AMQP, et Plane_Common encode le contrat : RABBITMQ_USER et RABBITMQ_VHOST sont plane, RABBITMQ_PASSWORD est une valeur aléatoire par déploiement dans Secret Manager (secret-<prefix>-<app>-rabbitmq-password) que l'encapsuleur transmet également au courtier comme RABBITMQ_DEFAULT_PASS, et l'hôte est fourni par la variante de plateforme — un sidecar rabbitmq:3.13-management-alpine dans le pod à 127.0.0.1:5672 sur Cloud Run (AMQP est un protocole non-HTTP que la mise en réseau de service à service de Cloud Run ne peut pas transporter). L'état du courtier est éphémère ; les files d'attente durables sont un TODO de renforcement documenté.
6. Stockage d'objets (TODO)
Un bucket Cloud Storage storage (gcs-<service-name>-storage) est déclaré ici et provisionné par la fondation, et l'environnement pointe AWS_S3_ENDPOINT_URL vers https://storage.googleapis.com avec USE_MINIO=0. Cependant, Plane parle l'API S3, et l'interopérabilité S3 de GCS nécessite des clés HMAC qui ne sont pas encore provisionnées — les téléchargements de fichiers (pièces jointes, avatars) échouent donc jusqu'à ce que de vraies informations d'identification soient fournies via le module de plateforme environment_variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, AWS_S3_BUCKET_NAME, AWS_S3_ENDPOINT_URL). Les problèmes, projets, cycles et modules fonctionnent sans cela.
gcloud storage buckets list --project "$PROJECT" --filter="name~plane"
7. Comportement de la sonde de santé
Les sondes par défaut ciblent /health via le proxy Caddy interne sur le port 80 :
- Sonde de démarrage — HTTP
/health, délai initial 30 s, période 10 s, seuil d'échec 30. Cela donne au conteneur AIO jusqu'à 30 + (30 × 10) = 330 secondes à partir du démarrage — une marge délibérée pour l'étape de migration du premier démarrage, qui doit se terminer avant que Caddy ne réponde. - Sonde de vivacité — HTTP
/health, délai initial 30 s, période 30 s, seuil d'échec 3.
Ne pas réduire le seuil d'échec du démarrage : tuer le conteneur en pleine migration produit une boucle de redémarrage.
Pour la configuration spécifique à Plane et destinée à l'utilisateur (variables par groupe, sorties et comment explorer chaque service depuis la Console et la CLI), consultez le guide de la plateforme : Plane_CloudRun.
Guides associés
- Plane sur Google Cloud Run — cette configuration déployée sur Cloud Run.
- Plane sur GKE Autopilot — cette configuration déployée sur GKE.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.