Maszyny deweloperskie

Izolowane środowiska programistyczne do budowania i testowania. Pełne środowiska Linux zasilane przez Proyecta Cloud.

Proyecta przydziela dedykowaną maszynę deweloperską (runtime) dla każdego projektu. Jest to izolowany kontener z pełnym środowiskiem Linux, w którym Twoja aplikacja działa podczas developmentu.

Jak działają maszyny deweloperskie?

Gdy otwierasz projekt, Proyecta:

1. Tworzy izolowany kontener (pod) w chmurze
2. Klonuje Twój kod z GitHub
3. Instaluje zależności i konfiguruje środowisko
4. Uruchamia serwer deweloperski Twojej aplikacji
5. Wyświetla podgląd na żywo w builderze

Postęp inicjalizacji możesz śledzić na pasku Runtime Status Bar znajdującym się poniżej paska narzędzi.

Kroki inicjalizacji

Pasek statusu wyświetla następujące kroki podczas uruchamiania:

Krok	Opis
Creating pod	Uruchamianie izolowanego kontenera
Health check	Weryfikacja, czy kontener działa prawidłowo
Git init	Klonowanie repozytorium
Environment setup	Instalowanie zależności (npm, pip itp.)
Starting services	Uruchamianie aplikacji i infrastruktury
Ready	Maszyna deweloperska jest w pełni gotowa

Moja maszyna deweloperska ma problemy. Jak je naprawić?

Jeśli podgląd się nie ładuje lub maszyna wydaje się zawieszona:

1. Sprawdź pasek Runtime Status Bar pod kątem komunikatów o błędach
2. Użyj Terminal, aby przejrzeć logi
3. Jeśli nic nie pomaga, poproś AI o pomoc w debugowaniu problemu

Usługi infrastrukturalne

Twoja maszyna deweloperska może zawierać kontenery pomocnicze (sidecar) dla baz danych i usług:

• PostgreSQL — Relacyjna baza danych (port 5432)
• PostGIS — PostgreSQL z rozszerzeniami geoprzestrzennymi (port 5432)
• Redis — Pamięć podręczna w pamięci RAM (port 6379)
• MongoDB — Dokumentowa baza danych (port 27017)
• MySQL — Relacyjna baza danych (port 3306)
• MailHog — Serwer do testowania e-maili z interfejsem webowym (port SMTP 1025, port UI 8025)

Uruchomione usługi i ich status możesz przeglądać w panelu Services.

Stany cyklu życia

Maszyny deweloperskie przechodzą przez następujące stany cyklu życia:

Stan	Opis
Pending	Oczekuje na utworzenie
Initializing	Konfigurowanie środowiska
Running	Aktywna i działająca prawidłowo
Suspended	Wstrzymana w celu oszczędzania zasobów (wznawiana szybko)
Archived	Przechowywana w archiwum (przywracanie trwa dłużej)
Restoring	Przywracana z archiwum
Failed	Inicjalizacja lub operacja zakończyła się niepowodzeniem — maszynę można ponownie zainicjalizować
Terminated	Trwale zatrzymana

Maszyny są automatycznie wstrzymywane po 60 minutach bezczynności i archiwizowane po 24 godzinach od wstrzymania.

FAQ

Co się dzieje z moją opublikowaną aplikacją, gdy maszyna deweloperska przestaje działać?

Backend Twojej aplikacji (funkcje serverless Convex oraz baza danych) działa na własnej infrastrukturze chmurowej Convex i pozostaje dostępny niezależnie od stanu maszyny deweloperskiej. Natomiast pliki frontendu Twojej aplikacji są serwowane z maszyny deweloperskiej — jeśli jest ona wstrzymana lub zarchiwizowana, odwiedzający będą widzieć błąd 503, dopóki maszyna nie zostanie wznowiona. Miej to na uwadze w przypadku aplikacji, które mają być stale publicznie dostępne; wznowienie maszyny przywraca działanie strony.

Czy mogę uzyskać szybszą maszynę deweloperską?

Wszystkie maszyny deweloperskie działają obecnie z taką samą alokacją zasobów. Jeśli potrzebujesz większej wydajności dla dużego projektu, skontaktuj się z pomocą techniczną.

Czy mogę uzyskać bezpośredni dostęp do maszyny deweloperskiej?

Tak. Użyj wbudowanego Terminal, aby uzyskać pełny dostęp do powłoki swojego środowiska programistycznego.