Machines de développement

Environnements de développement isolés pour construire et tester vos applications. Environnements Linux complets propulsés par Proyecta Cloud.

Proyecta provisionne une machine de développement (runtime) dédiée pour chaque projet. Il s’agit d’un conteneur isolé avec un environnement Linux complet dans lequel ton application s’exécute pendant le développement.

Comment fonctionnent les machines de développement ?

Lorsque tu ouvres un projet, Proyecta :

1. Crée un conteneur isolé (pod) dans le cloud
2. Clone ton code depuis GitHub
3. Installe les dépendances et configure l’environnement
4. Démarre le serveur de développement de ton application
5. Affiche un aperçu en direct dans le builder

Tu peux suivre la progression du provisionnement dans la Runtime Status Bar située sous la barre d’outils.

Étapes de provisionnement

La barre de statut affiche les étapes suivantes au démarrage :

Étape	Description
Creating pod	Démarrage du conteneur isolé
Health check	Vérification que le conteneur est opérationnel
Git init	Clonage de ton dépôt
Environment setup	Installation des dépendances (npm, pip, etc.)
Starting services	Lancement de ton application et de l’infrastructure
Ready	Ta machine de développement est entièrement en ligne

Ma machine de développement rencontre des problèmes. Comment y remédier ?

Si l’aperçu ne se charge pas ou si la machine semble bloquée :

1. Consulte la Runtime Status Bar pour identifier les messages d’erreur
2. Utilise le Terminal pour inspecter les logs
3. En dernier recours, demande à l’IA de t’aider à déboguer le problème

Services d’infrastructure

Ta machine de développement peut inclure des conteneurs sidecar pour les bases de données et les services :

• PostgreSQL — Base de données relationnelle (port 5432)
• PostGIS — PostgreSQL avec extensions géospatiales (port 5432)
• Redis — Cache en mémoire (port 6379)
• MongoDB — Base de données orientée documents (port 27017)
• MySQL — Base de données relationnelle (port 3306)
• MailHog — Serveur de test d’e-mails avec interface web (port SMTP 1025, port UI 8025)

Consulte les services en cours d’exécution et leur statut dans le panneau Services.

États du cycle de vie

Les machines de développement passent par les états de cycle de vie suivants :

État	Description
Pending	En attente de création
Initializing	Configuration de l’environnement en cours
Running	Active et opérationnelle
Suspended	Mise en pause pour économiser des ressources (reprise rapide)
Archived	Stockée à froid (restauration plus longue)
Restoring	En cours de restauration depuis le stockage archivé
Failed	Échec du provisionnement ou d’une opération — la machine peut être reprovisionnée
Terminated	Arrêtée définitivement

Les machines sont automatiquement suspendues après 60 minutes d’inactivité et archivées après 24 heures de suspension.

FAQ

Si la machine de développement tombe en panne, qu’advient-il de mon application publiée ?

Le backend de ton application (les fonctions serverless Convex et la base de données) s’exécute sur l’infrastructure cloud de Convex et reste disponible quel que soit l’état de ta machine de développement. En revanche, les fichiers frontend de ton application sont servis depuis la machine de développement — si celle-ci est suspendue ou archivée, les visiteurs verront une erreur 503 jusqu’à la reprise de la machine. Garde cela à l’esprit pour les applications que tu souhaites maintenir accessibles au public ; la reprise de la machine restaure le site.

Puis-je obtenir une machine de développement plus puissante ?

Toutes les machines de développement fonctionnent actuellement avec la même allocation de ressources. Si tu as besoin de plus de capacité pour un projet de grande envergure, contacte le support.

Puis-je accéder directement à la machine de développement ?

Oui. Utilise le Terminal intégré pour bénéficier d’un accès shell complet à ton environnement de développement.