Dev Machines
Isolierte Entwicklungsumgebungen zum Bauen und Testen. Vollständige Linux-Umgebungen, betrieben von Proyecta Cloud.
Proyecta stellt für jedes Projekt eine dedizierte Development Machine (Laufzeitumgebung) bereit. Dabei handelt es sich um einen isolierten Container mit einer vollständigen Linux-Umgebung, in der deine App während der Entwicklung läuft.
Wie funktionieren Dev Machines?
Abschnitt betitelt „Wie funktionieren Dev Machines?“Wenn du ein Projekt öffnest, führt Proyecta folgende Schritte aus:
- Erstellt einen isolierten Container (Pod) in der Cloud
- Klont deinen Code von GitHub
- Installiert Abhängigkeiten und richtet die Umgebung ein
- Startet den Entwicklungsserver deiner App
- Zeigt eine Live-Vorschau im Builder an
Den Fortschritt der Bereitstellung kannst du in der Runtime Status Bar unterhalb der Toolbar verfolgen.
Bereitstellungsschritte
Abschnitt betitelt „Bereitstellungsschritte“Die Status Bar zeigt während des Starts folgende Schritte an:
| Schritt | Beschreibung |
|---|---|
| Creating pod | Starten des isolierten Containers |
| Health check | Überprüfen, ob der Container läuft |
| Git init | Klonen deines Repositories |
| Environment setup | Installieren von Abhängigkeiten (npm, pip, etc.) |
| Starting services | Starten deiner App und der Infrastruktur |
| Ready | Deine Dev Machine ist vollständig online |
Meine Dev Machine hat Probleme. Wie behebe ich sie?
Abschnitt betitelt „Meine Dev Machine hat Probleme. Wie behebe ich sie?“Wenn die Vorschau nicht lädt oder die Machine hängt:
- Überprüfe die Runtime Status Bar auf Fehlermeldungen
- Nutze das Terminal, um Logs zu untersuchen
- Wenn alles andere scheitert, bitte die KI, beim Debuggen des Problems zu helfen
Infrastruktur-Dienste
Abschnitt betitelt „Infrastruktur-Dienste“Deine Dev Machine kann Sidecar-Container für Datenbanken und Dienste enthalten:
- PostgreSQL — Relationale Datenbank (Port 5432)
- PostGIS — PostgreSQL mit Geospatial-Erweiterungen (Port 5432)
- Redis — In-Memory-Cache (Port 6379)
- MongoDB — Dokumentendatenbank (Port 27017)
- MySQL — Relationale Datenbank (Port 3306)
- MailHog — E-Mail-Testserver mit Web-UI (SMTP-Port 1025, UI-Port 8025)
Laufende Dienste und deren Status findest du im Services-Panel.
Lebenszyklus-Zustände
Abschnitt betitelt „Lebenszyklus-Zustände“Dev Machines durchlaufen folgende Lebenszyklus-Zustände:
| Zustand | Beschreibung |
|---|---|
| Pending | Wartet auf Erstellung |
| Initializing | Umgebung wird eingerichtet |
| Running | Aktiv und funktionsfähig |
| Suspended | Pausiert, um Ressourcen zu sparen (wird schnell wieder aufgenommen) |
| Archived | In Kalt-Speicher abgelegt (Wiederherstellung dauert länger) |
| Restoring | Wird aus dem Archiv-Speicher wiederhergestellt |
| Failed | Bereitstellung oder Betrieb fehlgeschlagen — die Machine kann neu bereitgestellt werden |
| Terminated | Dauerhaft gestoppt |
Machines werden nach 60 Minuten Inaktivität automatisch suspendiert und nach 24 Stunden Suspension archiviert.
Was passiert mit meiner veröffentlichten App, wenn die Dev Machine ausfällt?
Das Backend deiner App (Convex Serverless-Funktionen und Datenbank) läuft auf der eigenen Cloud-Infrastruktur von Convex und bleibt unabhängig vom Zustand deiner Dev Machine verfügbar. Die Frontend-Dateien deiner App werden jedoch von der Dev Machine ausgeliefert — ist sie suspendiert oder archiviert, erhalten Besucher einen 503-Fehler, bis die Machine wieder läuft. Behalte das bei Apps im Hinterkopf, die öffentlich erreichbar bleiben sollen; das Fortsetzen der Machine stellt die Website wieder her.
Kann ich eine schnellere Dev Machine bekommen?
Alle Dev Machines laufen derzeit mit der gleichen Ressourcenzuweisung. Wenn du für ein großes Projekt mehr Kapazität benötigst, wende dich an den Support.
Kann ich direkt auf die Dev Machine zugreifen?
Ja. Nutze das integrierte Terminal für vollständigen Shell-Zugriff auf deine Entwicklungsumgebung.