Chuyển đến nội dung chính
Để tiết kiệm thời gian và nhanh chóng dựng môi trường phát triển, chúng tôi cung cấp thêm một phiên bản cấu hình môi trường phát triển khác, đó là GitHub Codespace.

Hướng dẫn cấu hình

1

Tạo Codespaces

Nhấp vào nút sau để tạo một codespace trên đám mây phục vụ phát triển server-pro.Open in GitHub CodespacesBạn nên chọn Machine Type tối thiểu là 4-core. Để dùng loại máy lớn hơn, bạn có thể gửi yêu cầu đến đội ngũ hỗ trợ chính thức của GitHub bằng cách tạo ticket tại đây.
2

Chạy script thiết lập

Bạn cần kiên nhẫn chờ cho đến khi codespace được tạo xong. Khi đã truy cập được Terminal, hãy chạy lệnh sau:
bin/setup kéo các image và khởi động các dịch vụ; sau đó bin/i18n áp dụng bản dịch của các mô-đun Ayakaleaf Pro, vốn không có trong các tệp locale đã commit, xem Cập nhật bản dịch i18n.
Script này (bin/setup) cho phép bạn thiết lập môi trường phát triển trên commit mới nhất của nhánh server-pro trong thời gian ngắn nhất có thể. Nó có thể không áp dụng được cho các phiên bản cũ hơn hoặc các nhánh khác.Chúng tôi build Docker image phát triển hằng ngày bằng GitHub Action.
3

Truy cập Launchpad

Chuyển sang tab cổng, bạn sẽ thấy danh sách các cổng web khả dụng. Nhấp vào cổng 80 (OVERLEAF_PORT trong develop/dev.rc). Lúc này bạn sẽ thấy trang launchpad. Mailpit, Grafana, Mongo Express và RedisInsight nằm trên các đường dẫn của cùng cổng đó (/mailpit/, /grafana/, /mongo-express/ và /redis-insight/), và menu Dev tools của trang web liên kết tới chúng sau khi bạn đăng nhập. Bảng điều khiển RustFS ở cổng 9001 và Hoppscotch ở cổng 9170, xem Cổng.
Bạn sẽ thấy:
4

Tận hưởng việc phát triển

Giờ đến lượt bạn! Hãy bắt đầu xây dựng tính năng tuyệt vời của mình. bin/setup đã khởi động mọi dịch vụ ở chế độ phát triển (node --watch, giống bin/dev), nên thay đổi mã hiển thị mà không cần thêm lệnh nào.Sau khi thay đổi develop/dev.rc, hãy chạy lại bin/setup: lệnh này đi qua bin/docker-compose, công cụ thêm các tệp của những tính năng đang bật.
Đừng khởi động các dịch vụ thủ công bằng docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.image.yml up. Lệnh này bỏ qua các tệp tính năng của dev.rc, nên web, filestore và history-v1 được tạo lại mà không có cài đặt RustFS và quay về volume cục bộ, nơi thiếu lịch sử và tệp nhị phân của các dự án của bạn.
Lần sửa đổi cuối 20 tháng 11, 2026