Skip to main content

安装您的第一张许可证

新安装的 SupKube 默认没有任何许可证，此时创建备份或计划会被拒绝；本文带您完成许可证安装的最小闭环。

前置条件​

  • SupKube 已部署在命名空间 supkube（标准安装方式，见在线安装）。
  • 已获得厂商签发的许可证文件（一个包含数字签名的 YAML 文件）。

为什么要先做这一步​

SupKube 的许可证消费端默认处于 missing（未找到许可证）状态，此时新建备份、新建计划策略、手动触发一次计划都会收到 HTTP 402 拒绝。这是刚装好 SupKube 的用户最容易碰到的"卡点"，建议作为安装后的第一个操作完成。

想先不装许可证也能看效果？

Applications 页面的一键 Snapshot 按钮、以及所有的还原（Restore）操作都不受许可证状态限制，可以先用它们体验产品。

步骤一：创建许可证 Secret​

kubectl create secret generic supkube-license \
  -n supkube \
  --from-file=license=/path/to/your-license.yaml

步骤二：等待状态刷新​

许可证控制器每 5 分钟轮询一次，也会在后端 Pod 启动时立即检查一次。可以直接重启后端 Pod 让它立刻生效：

kubectl rollout restart deployment/supkube-backend -n supkube

步骤三：确认状态​

kubectl logs -n supkube deploy/supkube-backend | grep '\[license\]'

看到类似 state=licensed 的日志即表示生效：

[license] state=licensed id=... product=SupKube edition=... nodes=3/10 excluded=1 daysLeft=365 violations=[]

验证方法​

在 UI 中打开 Backups 页面，点击"创建备份"并提交。若不再出现许可证相关的错误提示，即说明许可证已生效。

相关文档​