Để chạy được một ứng dụng trên máy chủ, cần đúng môi trường chạy (Node.js, Python, Go...) với phiên bản phù hợp. OneDash cho phép cài và quản lý các môi trường này tập trung. Ngoài ra, thư viện ứng dụng mẫu giúp cài nhanh các phần mềm thông dụng lên máy chủ chỉ bằng vài cú bấm. Bài này hướng dẫn cả hai.

Khi nào dùng

• Môi trường chạy: khi muốn chuẩn bị sẵn các phiên bản Node.js, Python, Go... trên máy chủ trước khi tạo dự án, hoặc muốn xem máy chủ đang có những phiên bản nào, phiên bản nào đang được dự án sử dụng, và dọn bớt phiên bản không dùng.
• Ứng dụng mẫu: khi muốn cài nhanh một phần mềm thông dụng lên máy chủ mà không cần tự tìm và chạy lệnh cài đặt thủ công.

Trước khi bắt đầu

• Có máy chủ đã thêm vào OneDash, đã cài agent và agent đang trực tuyến.
• Môi trường chạy chỉ áp dụng cho máy chủ Linux. Danh sách máy chủ ở mục Môi trường Runtime chỉ liệt kê các máy chủ Linux có agent.
• Một số phiên bản được biên dịch từ mã nguồn (ví dụ Python) nên có thể mất vài phút khi cài, nhất là trên máy chủ cấu hình thấp.

---

Phần 1 — Môi trường chạy

Cách mở trang Môi trường Runtime

1. Vào mục Projects.
2. Trên thanh công cụ, bấm Môi trường Runtime.
3. Trang hiển thị danh sách các máy chủ đủ điều kiện. Dùng ô tìm kiếm để lọc theo tên hoặc địa chỉ máy chủ, rồi bấm vào một máy chủ để xem chi tiết.

Cách xem và quản lý môi trường trên một máy chủ

Trong trang chi tiết của máy chủ, các môi trường được nhóm theo loại (Node.js, Python, Go...). Mỗi nhóm hiển thị số phiên bản đã cài và phiên bản nào đang đặt làm Mặc định. Mỗi dòng phiên bản kèm thông tin có phải bản LTS hay không và số dự án đang dùng phiên bản đó.

Các thao tác có sẵn:

• Đồng bộ lại: cập nhật lại danh sách phiên bản từ máy chủ. Nếu dữ liệu đã quá cũ, hệ thống sẽ hiện cảnh báo gợi ý đồng bộ.
• Đặt mặc định: chọn một phiên bản làm mặc định cho loại môi trường đó trên máy chủ.
• Gỡ cài: xoá một phiên bản khỏi máy chủ. Nếu còn dự án đang dùng phiên bản đó, OneDash sẽ chặn và cho biết số dự án đang phụ thuộc — cần đổi phiên bản cho các dự án đó hoặc xoá chúng trước.

Cách cài một phiên bản môi trường mới

1. Trong trang chi tiết môi trường của máy chủ, bấm Cài version mới.
2. Chọn Runtime muốn cài (Node.js, Python, Go...).
3. Chọn Phiên bản: gõ để tìm trong danh sách gợi ý; các bản LTS được đánh dấu riêng. Bật tuỳ chọn hiển thị bản pre-release nếu cần các bản thử nghiệm (rc, beta, alpha).
4. Nếu phiên bản đã gõ không có trong danh sách gợi ý, OneDash hiện cảnh báo và cho phép tích chọn vẫn thử cài (force install).
5. Bấm Cài đặt. Quá trình có thể mất từ vài chục giây đến vài phút; với môi trường biên dịch từ mã nguồn có thể lâu hơn. Cửa sổ sẽ hiển thị tiến trình và nhật ký nếu có lỗi.

---

Phần 2 — Ứng dụng mẫu

Cách duyệt thư viện ứng dụng mẫu

1. Vào mục Ứng dụng ở thanh điều hướng.
2. Trang hiển thị danh sách ứng dụng mẫu dạng lưới hoặc danh sách (chuyển đổi bằng nút ở góc phải).
3. Dùng ô Tìm kiếm ứng dụng để tìm theo tên hoặc mô tả, và lọc theo Danh mục bằng các thẻ phía trên.
4. Mỗi ứng dụng hiển thị tên, mô tả ngắn và số máy chủ đã từng cài.

Cách xem chi tiết một ứng dụng

Bấm vào một ứng dụng để mở cửa sổ chi tiết, gồm hai phần:

• Chi tiết: mô tả đầy đủ, phiên bản, danh mục, ngày cập nhật và danh sách hệ điều hành tương thích.
• Lịch sử cài đặt: các lần đã cài ứng dụng này, kèm máy chủ, thời gian và kết quả (Thành công / Thất bại / Đã hủy).

Từ cửa sổ này, bấm Cài đặt lên máy chủ để bắt đầu cài.

Cách cài một ứng dụng lên máy chủ

1. Từ thẻ ứng dụng bấm Cài đặt, hoặc từ cửa sổ chi tiết bấm Cài đặt lên máy chủ.

2. Cửa sổ Chọn máy chủ để cài đặt hiện ra. Dùng ô tìm kiếm để lọc máy chủ, rồi chọn một máy chủ. Máy chủ có agent đang ngoại tuyến sẽ bị mờ và không chọn được.

   

3. Bấm Cài đặt.

4. Cửa sổ tiến trình hiển thị 4 bước: Tải script → Xác thực → Thực thi → Hoàn tất, kèm nhật ký đầu ra theo thời gian thực. Trong khi đang chạy có thể bấm Hủy cài đặt.

5. Khi hoàn tất, cửa sổ báo Cài đặt hoàn tất!. Nếu thất bại, cửa sổ hiển thị thông báo lỗi và nhật ký để xem; bấm Thử lại để cài lại.

Xử lý sự cố