Skip to main content

AI-POWERED DOCS

What do you want to know?

Bắt Đầu

Điều Kiện Tiên Quyết

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 NameEmail của bạn. Với SSH Key, dùng khóa do trưởng nhóm cung cấp.

Trang Settings của OV Hub hiển thị các trường User Identity và phần quản lý SSH Key

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.