Tự host (Doanh nghiệp)

Giấy phép offline

Tệp giấy phép của bản tự host - nội dung, cách gắn bằng Secret, các trạng thái và ý nghĩa, ân hạn, chế độ chỉ đọc không khóa dữ liệu, gia hạn, lệnh license-status và chỉ số dx_license_days_left.

Bản tự host dùng giấy phép offline: một tệp license.json DataxLand cấp theo hợp đồng. Bản cài kiểm chữ ký của tệp bằng khóa công khai có sẵn trong ảnh, không gọi về DataxLand và chạy được trong mạng kín.

Nội dung tệp

Tệp JSON gồm định dạng (dataxland-license/1), mã khóa ký, phần nội dung và chữ ký số. Phần nội dung ghi:

TrườngÝ nghĩa
license_idMã giấy phép
customerTên khách hàng
edition, planPhiên bản và gói (Doanh nghiệp)
limits.workspacesSố workspace tối đa; null là không giới hạn
limits.seatsSố người dùng tối đa; null là không giới hạn
featuresDanh sách tính năng theo hợp đồng, hiện ở trang quản trị
issued_at, not_before, expires_atNgày cấp, ngày bắt đầu hiệu lực, ngày hết hạn
grace_daysSố ngày ân hạn sau khi hết hạn, mặc định 30
deploymentselfhost

Sửa phần nội dung làm chữ ký sai và giấy phép thành không hợp lệ. Cần đổi giới hạn hay thời hạn, liên hệ DataxLand để nhận tệp mới.

Gắn giấy phép

kubectl -n dataxland create secret generic dataxland-license --from-file=license.json=./license.json
license:
  existingSecret: dataxland-license
  key: license.json      # tên khóa trong Secret chứa tệp

Chart gắn tệp chỉ đọc vào /etc/dataxland/license/license.json của api, worker và mcp. Cài khi chưa có giấy phép thì Helm in cảnh báo kèm lệnh tạo Secret và nâng cấp.

Trạng thái

Bản cài kiểm giấy phép lúc khởi động, rồi lại mỗi giờ và mỗi khi tệp đổi.

Trạng tháiKhi nàoBản cài
validTrong thời hạnHoạt động đủ, áp giới hạn workspace và người dùng
graceĐã hết hạn, còn trong ân hạnNhư valid; trang quản trị hiện cảnh báo
expiredHết cả ân hạnChỉ đọc
not_yet_validChưa tới not_beforeChỉ đọc
invalidSai định dạng, sai chữ ký, khóa ký lạ, không dành cho bản tự hostChỉ đọc
missingChưa gắn tệpChỉ đọc

Chế độ chỉ đọc

Chế độ chỉ đọc không khóa dữ liệu của bạn:

  • Vẫn chạy: dashboard, hỏi Si, MCP, xuất dữ liệu, đăng nhập.
  • Bị chặn: tạo workspace, mời người dùng, chạy build hoặc làm mới dữ liệu. API trả lỗi 402 mã license_inactive.

Dữ liệu dừng ở lần build cuối cùng cho tới khi có giấy phép hợp lệ.

Giới hạn

  • Workspace: đếm các workspace đang hoạt động trên toàn bản cài, gồm cả workspace mẫu.
  • Người dùng: đếm các tài khoản chưa bị khóa trên toàn bản cài.

Đạt giới hạn thì không tạo thêm workspace hoặc không mời thêm người (lỗi 402 mã license_limit); những gì đang có vẫn dùng bình thường. Khóa tài khoản không còn dùng sẽ giải phóng chỗ.

Xem trạng thái

Trong ứng dụng: Quản trị → Vận hành, mục Triển khai và giấy phép hiện khách hàng, mã giấy phép, ngày hết hạn, số ngày còn lại (gồm ân hạn), mức dùng so với giới hạn và danh sách tính năng.

Từ dòng lệnh:

kubectl -n dataxland exec deploy/dataxland-worker -- python -m pipelines.cli license-status

Lệnh in JSON gồm trạng thái giấy phép, mức dùng, chế độ cách ly, và trả mã thoát 1 khi giấy phép không còn hiệu lực, nên dùng được trong script kiểm tra.

Theo dõi hạn

api xuất chỉ số Prometheus dx_license_days_left: số ngày còn lại tới khi chuyển sang chỉ đọc (gồm ân hạn), nhãn state là trạng thái hiện tại. Ví dụ luật cảnh báo:

- alert: DataxLandLicenseExpiring
  expr: dx_license_days_left < 45
  for: 1h
  annotations:
    summary: Giấy phép DataxLand còn dưới 45 ngày; liên hệ DataxLand để gia hạn

Gia hạn

  1. Liên hệ DataxLand để nhận tệp giấy phép mới.

  2. Thay nội dung Secret:

    kubectl -n dataxland create secret generic dataxland-license \
      --from-file=license.json=./license.json --dry-run=client -o yaml | kubectl apply -f -
  3. Kubernetes cập nhật tệp đã gắn vào pod sau ít phút; bản cài thấy tệp đổi và đọc lại, không cần khởi động lại. Kiểm bằng license-status hoặc trang quản trị.

Liên quan

Markdown