AI-POWERED DOCS
What do you want to know?
Bắt Đầu
Điều Kiện Tiên Quyết
-
Git — Tải xuống và cài đặt Git, sau đó bật LFS:
git lfs install -
VPN — Kết nối VPN của bạn (bắt buộc để truy cập các package registries bên ngoài và recipe server).
-
uv — Cài đặt uv.
Cài Đặt
Bước 1. Tải xuống tệp .whl mới nhất của OV Hub từ trang phát hành ov-hub-artifacts, sau đó cài đặt:
uv tool install --force ./ov_hub-<version>-py3-none-any.whl
Bước 2. Xác minh cài đặt:
ov-hub doctor
Ở bước này, một số kiểm tra hiển thị là không đạt là điều bình thường — xác thực chưa được cấu hình và sẽ được hoàn tất trong phần khởi tạo.
Khởi Tạo
Bước 1. Khởi động server OV Hub. Lựa chọn dựa trên vai trò của bạn:
-
Chỉ xem và đồng bộ recipes:
ov-hub serve -
Xuất bản các phiên bản recipe mới cho team:
ov-hub serve --allow-publish-new-version
Bước 2. Mở http://localhost:8080/ và vào trang Settings. Đặt Name và Email của bạn. Với SSH Key, dùng khóa do trưởng nhóm cung cấp.

Bước 3. Tạo một thư mục cục bộ để sử dụng làm thư mục gốc cho các repository recipe của bạn. Trong Settings, nhập đường dẫn vào trường Default Clone Directory.
Nâng Cấp
Các phiên bản mới của OV Hub được phân phối dưới dạng tệp .whl, giống như khi cài đặt lần đầu. Việc nâng cấp chỉ thay thế bản thân ứng dụng — mọi thứ trên trang Settings, khóa SSH và các repository recipe của bạn được lưu bên ngoài ứng dụng và được giữ nguyên, nên không cần cấu hình lại sau đó.
Bước 1. Đóng server OV Hub đang chạy: chuyển sang terminal đang chạy ov-hub serve và nhấn Ctrl+C.
Bước 2. Tải xuống tệp .whl mới nhất từ trang phát hành ov-hub-artifacts và xem release notes ở đó, sau đó cài đặt:
uv tool install --force ./ov_hub-<version>-py3-none-any.whl
Bước 3. Xác minh việc nâng cấp:
ov-hub --version
ov-hub doctor
ov-hub --version bây giờ phải hiển thị phiên bản mới, và ov-hub doctor phải hiển thị kết quả giống như trước khi nâng cấp.
Bước 4. Khởi động lại server bằng cùng lệnh như trước, sau đó mở lại http://localhost:8080/.
Lưu Ý
- Giữ terminal luôn mở. OV Hub phải luôn chạy trong khi bạn làm việc — bao gồm cả trong quá trình tải lên và tải xuống ở chế độ nền. Không đóng terminal đang chạy server.
- Đóng server trước khi nâng cấp. Trên Windows, quá trình nâng cấp có thể không hoàn tất nếu OV Hub vẫn đang chạy. Nếu đang có quá trình tải lên hoặc tải xuống recipe, hãy chờ hoàn tất trước.
Gỡ Cài Đặt
uv tool uninstall ov-hub
Lệnh này chỉ gỡ bỏ ứng dụng. Các cài đặt và khóa SSH của bạn (trong thư mục .ov-hub ở thư mục home) cùng các repository recipe vẫn còn trên đĩa — hãy xóa thủ công nếu bạn muốn gỡ bỏ hoàn toàn.