Máy Dev

Môi trường phát triển độc lập để xây dựng và kiểm thử. Môi trường Linux đầy đủ được cung cấp bởi Proyecta Cloud.

Proyecta cấp phát một máy dev (runtime) riêng biệt cho mỗi dự án. Đây là một container độc lập với môi trường Linux đầy đủ, nơi ứng dụng của bạn chạy trong quá trình phát triển.

Máy dev hoạt động như thế nào?

Khi bạn mở một dự án, Proyecta sẽ:

Tạo một container độc lập (pod) trên cloud
Clone code của bạn từ GitHub
Cài đặt các dependency và thiết lập môi trường
Khởi động development server của ứng dụng
Hiển thị bản xem trước trực tiếp trong Builder

Bạn có thể theo dõi tiến trình cấp phát trong Runtime Status Bar phía dưới thanh công cụ.

Các bước cấp phát

Thanh trạng thái hiển thị các bước sau trong quá trình khởi động:

Bước	Mô tả
Creating pod	Khởi tạo container độc lập
Health check	Xác minh container đang hoạt động
Git init	Clone repository của bạn
Environment setup	Cài đặt các dependency (npm, pip, v.v.)
Starting services	Khởi chạy ứng dụng và hạ tầng
Ready	Máy dev của bạn đã hoạt động đầy đủ

Máy dev của tôi đang gặp sự cố. Làm thế nào để khắc phục?

Nếu bản xem trước không tải được hoặc máy có vẻ bị treo:

Kiểm tra Runtime Status Bar để xem thông báo lỗi
Thử dùng Terminal để xem log
Nếu vẫn không được, hãy nhờ AI hỗ trợ debug vấn đề

Các dịch vụ hạ tầng

Máy dev của bạn có thể bao gồm các sidecar container cho cơ sở dữ liệu và dịch vụ:

PostgreSQL — Cơ sở dữ liệu quan hệ (cổng 5432)
PostGIS — PostgreSQL với các extension không gian địa lý (cổng 5432)
Redis — Bộ nhớ cache in-memory (cổng 6379)
MongoDB — Cơ sở dữ liệu dạng document (cổng 27017)
MySQL — Cơ sở dữ liệu quan hệ (cổng 3306)
MailHog — Server kiểm thử email với giao diện web (SMTP cổng 1025, UI cổng 8025)

Xem các dịch vụ đang chạy và trạng thái của chúng trong bảng Services.

Các trạng thái vòng đời

Máy dev trải qua các trạng thái vòng đời sau:

Trạng thái	Mô tả
Pending	Đang chờ được tạo
Initializing	Đang thiết lập môi trường
Running	Đang hoạt động và ổn định
Suspended	Tạm dừng để tiết kiệm tài nguyên (khôi phục nhanh)
Archived	Được lưu trong cold storage (mất nhiều thời gian hơn để khôi phục)
Restoring	Đang được khôi phục từ kho lưu trữ
Failed	Cấp phát hoặc vận hành thất bại — máy có thể được cấp phát lại
Terminated	Đã dừng vĩnh viễn

Máy sẽ tự động chuyển sang trạng thái suspended sau 60 phút không hoạt động và chuyển sang archived sau 24 giờ ở trạng thái suspended.

Câu hỏi thường gặp

Nếu máy dev bị ngừng hoạt động, điều gì xảy ra với ứng dụng đã publish của tôi?

Backend của ứng dụng (các serverless function và cơ sở dữ liệu Convex) chạy trên hạ tầng cloud riêng của Convex và vẫn hoạt động bình thường bất kể trạng thái máy dev của bạn. Tuy nhiên, các file frontend của ứng dụng được phục vụ từ máy dev — nếu máy bị suspended hoặc archived, người dùng sẽ thấy lỗi 503 cho đến khi máy được khôi phục. Hãy lưu ý điều này với các ứng dụng bạn muốn duy trì khả năng truy cập công khai; việc khôi phục máy sẽ đưa trang web trở lại hoạt động.

Tôi có thể sử dụng máy dev nhanh hơn không?

Tất cả máy dev hiện tại đều chạy với cùng mức phân bổ tài nguyên. Nếu bạn cần nhiều năng lực hơn cho một dự án lớn, hãy liên hệ với bộ phận hỗ trợ.

Tôi có thể truy cập trực tiếp vào máy dev không?

Có. Sử dụng Terminal tích hợp sẵn để có quyền truy cập shell đầy đủ vào môi trường phát triển của bạn.