Thanh toán

Billing bao gồm những gì

Mỗi project trong Mikademy Cloud đều có một hạn ngạch (quota) — giới hạn cứng về lượng tài nguyên mà các workload của nó được phép sử dụng. Billing là dịch vụ đo lường mức bạn thực sự dùng so với hạn ngạch đó, tự động thực thi giới hạn khi bạn vượt mức, và cho phép chủ sở hữu nâng cấp hạn ngạch bằng cách đăng ký một gói cước.

Hạn ngạch gồm ba chiều:

Mục này trong console nằm ở /<project>/billing với ba trang con: Usage & Quota, Events và Purchase. Bất kỳ thành viên nào của project đều có thể xem billing; chỉ chủ sở hữu (hoặc cloud-admin) mới có thể đăng ký hoặc mua gói.

Mức sử dụng được đo như thế nào

Một vòng lặp billing chạy nền trong backend thức dậy khoảng mỗi 60 giây (giá trị BILLING_INTERVAL) và, với mỗi project, lấy một phép đo mới về mức sử dụng thực tế trên cả ba chiều. Sau đó nó ghi lại một mẫu để bạn có lịch sử sử dụng, và xử lý hạn ngạch (xem phần thực thi bên dưới).

Những gì được tính vào mỗi chiều:

• CPU và bộ nhớ là tổng mức sử dụng thực tế của mọi Kinetic, Dev Box và Engine đang chạy trong project. Các workload đã dừng hoặc đã bị tạm ngưng đóng góp bằng không.
• Disk là tổng dung lượng lưu trữ của tất cả Bucket, các volume bền vững làm nền cho Dev Box và Engine của bạn, và các image đã đẩy lên Registry.

Trang Usage & Quota

/<project>/billing là trang đích. Nó hiển thị một thanh hạn ngạch so với mức sử dụng cho CPU, bộ nhớ và disk — mỗi thanh chuyển sang màu đỏ khi mức sử dụng chạm hoặc vượt giới hạn — theo sau là một biểu đồ lịch sử sử dụng cho từng chiều.

Một bộ chọn khoảng thời gian điều khiển biểu đồ lịch sử nhìn lại bao xa. Các cửa sổ thời gian có sẵn là:

Khoảng thời gian được lưu trong tham số URL ?range=, nên một liên kết sâu vẫn giữ nguyên cửa sổ của nó. Các mẫu chỉ được lưu trong một khoảng thời gian giới hạn (BILLING_USAGE_RETENTION), nên những khoảng dài nhất có thể hiển thị ít điểm hơn trên một project hoàn toàn mới.

Thực thi khi vượt hạn ngạch

Khi một phép đo cho thấy mức sử dụng vượt hạn ngạch, vòng lặp billing sẽ tự động hành động để đưa project trở lại dưới giới hạn của nó.

Đối với việc vượt hạn ngạch CPU hoặc bộ nhớ, nó liên tục chọn workload có mức sử dụng cao nhất (Kinetic, Dev Box hoặc Engine) và tạm ngưng nó — trừ đi mức sử dụng của nó — cho đến khi cả hai chiều lại nằm trong giới hạn. Một workload bị tạm ngưng sẽ được thu nhỏ về không và ngừng phục vụ traffic. Mỗi lần tạm ngưng được ghi lại như một sự kiện.

Khi có chỗ trống trở lại sau đó (bạn đã nâng hạn ngạch, hoặc các tài nguyên khác đã dừng), vòng lặp sẽ khôi phục các workload bị tạm ngưng theo thứ tự mức sử dụng thấp nhất trước, thêm lại từng cái chỉ khi nó vẫn vừa với giới hạn, để khôi phục được nhiều nhất có thể mà không lại vượt mức.

Đối với việc vượt hạn ngạch disk, vòng lặp sẽ chuyển tất cả Bucket thành chỉ đọc — các lệnh ghi bị từ chối, lệnh đọc vẫn hoạt động — cho đến khi dung lượng lưu trữ giảm xuống dưới giới hạn.

Trang Events

/<project>/billing/events là nhật ký kiểm toán của mọi lần tự động tạm ngưng và khôi phục. Ở trên cùng, một banner tóm tắt có bao nhiêu tài nguyên đang bị tạm ngưng bởi vòng lặp billing (và nêu tên chúng); bên dưới nó, một bảng phân trang liệt kê từng sự kiện theo thứ tự mới nhất trước với các cột sau:

Trang này chỉ đọc và được phân trang đầy đủ (25 dòng mỗi trang, phía máy chủ), nên lịch sử vẫn đáng tin cậy ngay cả trên các project bận rộn.

Gói cước & giá

Việc nâng cấp hạn ngạch được bán dưới dạng gói cước — một danh mục nhỏ được định nghĩa trong code. Đăng ký sẽ áp dụng hạn ngạch của gói cước cho project. Giá được tính bằng đồng Việt Nam (VND) và hiện tại chỉ là giá tạm thời.

Thanh toán theo năm trên các bậc trả phí cho bạn mười hai tháng với giá của mười tháng. Danh mục có thể mở rộng ở backend, nên các bậc mới có thể xuất hiện theo thời gian — luôn đọc GET /billing/plans để có danh sách trực tiếp.

Cách đăng ký

Mở /<project>/billing/purchase. Bạn sẽ thấy một thẻ cho mỗi gói cước với hạn ngạch và giá của nó, một nút chuyển theo tháng / theo năm, và đăng ký hiện tại của project (gói cước, kỳ hạn và ngày hết hạn). Chọn một kỳ thanh toán, rồi nhấp Subscribe trên gói cước bạn muốn. Hạn ngạch của gói cước sẽ được áp dụng cho project của bạn ngay lập tức.

Chỉ chủ sở hữu (hoặc cloud-admin) mới có thể đăng ký; các thành viên khác có thể xem trang nhưng lệnh gọi trả về 403 đối với họ.

curl -s -X POST \
  "$BASE/projects/demo-01/billing/subscription" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"planId":"starter","period":"monthly"}'

period phải là monthly hoặc yearly; một planId không xác định hoặc kỳ hạn sai sẽ trả về 400. Khi thành công, đăng ký mới được trả về và hạn ngạch của project được cập nhật.

Kiểm tra hạn ngạch & mức sử dụng qua API

Địa chỉ gốc của API là https://api.<base-domain> và mọi đường dẫn đều nằm dưới /api/v1. Xác thực với tư cách người dùng bằng token bearer OIDC, hoặc với tư cách service account bằng khóa mksa_. Các ví dụ giả định $BASE và $TOKEN đã được thiết lập. Tất cả các endpoint đọc đều mở cho mọi thành viên của project.

BASE=https://api.example.com/api/v1
TOKEN=<your-session-token>

Hạn ngạch, mức sử dụng & lịch sử hiện tại

curl -s "$BASE/projects/demo-01/billing?range=1h" \
  -H "Authorization: Bearer $TOKEN"

{
  "quota": { "cpu": "2", "memory": "4Gi", "disk": "20Gi",
             "cpuMilli": 2000, "memoryBytes": 4294967296 },
  "usage": { "cpuMilli": 1200, "memoryBytes": 1073741824 },
  "usageHistory": [
    { "ts": "2026-06-30T10:00:00Z", "cpuMilli": 1200, "memoryBytes": 1073741824 }
  ]
}

Sự kiện tạm ngưng & khôi phục

curl -s "$BASE/projects/demo-01/billing/events?limit=25&offset=0" \
  -H "Authorization: Bearer $TOKEN"

{
  "items": [
    { "ts": "2026-06-30T10:01:00Z", "name": "api", "type": "kinetic",
      "action": "terminated", "reason": "over quota",
      "cpuMilli": 900, "memoryBytes": 805306368 }
  ],
  "total": 1, "limit": 25, "offset": 0,
  "active": [
    { "name": "api", "type": "kinetic", "terminatedAt": "2026-06-30T10:01:00Z",
      "cpuMilli": 900, "memoryBytes": 805306368, "reason": "over quota" }
  ]
}

limit mặc định là 25 (tối đa 100); active là tập hợp các tài nguyên hiện đang bị billing tạm ngưng.

Danh mục gói cước & đăng ký

# The plan catalog (any authenticated caller; no project needed)
curl -s "$BASE/billing/plans" -H "Authorization: Bearer $TOKEN"

# The project's current subscription ({} when there is none)
curl -s "$BASE/projects/demo-01/billing/subscription" \
  -H "Authorization: Bearer $TOKEN"

{
  "planId": "starter",
  "planName": "Starter",
  "period": "monthly",
  "startedAt": "2026-06-30T10:00:00Z",
  "expiresAt": "2026-07-30T10:00:00Z",
  "status": "active"
}

Tránh & xử lý các lần tạm ngưng

Khắc phục sự cố