文档目录 +
文档/故障处理

故障处理

先阅读错误信息和操作报告,确认哪些步骤已完成,再决定是否重试。发生错误不代表此前的变更已经撤销。

无法连接集群或权限不足

确认管理员 kubeconfig、上下文和 API 服务器地址正确,并且当前机器能够访问集群。CLI 可显式使用 --kubeconfig 和 --context,TUI 可重新选择上下文。

出现 Forbidden 时,检查管理员权限要求。新增绑定可能需要额外的 RBAC 授权;试运行也需要相应权限。License 激活无法解决集群权限不足。

无法写入输出文件

kticket 不覆盖已有文件或符号链接。CLI 使用 --output 指定新的文件名;TUI 选择已有且可写的目录,并检查确认页显示的文件路径。接收者的 kubeconfig 应与管理员配置分开保存。

签发或权限变更部分失败

情况下一步
创建资源后签发失败阅读操作报告,用 kticket list 和 kticket access list 检查保留的账户与授权。
令牌已签发,后续步骤失败先核查报告;TUI 中标记为“需要处理”的账户不会自动重试。
批量签发中途停止同一会话中按 r 重新检查失败或待处理账户;成功账户不会重复执行。退出后无法恢复该批次。
部分授权变更失败重新加载账户并生成新计划;已完成的变更不会自动回滚。
凭据记录无法读取或已满保存错误信息,请集群管理员核查账户记录后再签发;不要通过删除记录来撤销令牌。

签发失败后,kticket 会尝试删除未完成的输出文件,并报告清理错误。已应用的账户、命名空间和授权变更仍可能保留。即使输出文件已删除,令牌也可能已经签发;如需撤销该账户的全部凭据,请使用账户撤销操作。

撤销后仍有访问或清理未完成

移除一项授权不会删除账户,也不会移除外部绑定提供的权限。使用 kticket access check 检查具体操作是否仍被允许。

撤销账户影响其全部凭据,但不会主动终止已建立的连接。如果提示账户已删除而绑定清理失败,使用管理员凭据检查残留的受管绑定,完成清理后再创建同名账户。不要直接删除共享角色或其他账户的绑定。

License 无法使用

先执行 kticket license status,查看状态、当前 Machine ID 和授权文件位置。

情况下一步
未收到邮件检查付款邮箱和垃圾邮件,准备订单信息后联系支持。
未找到 License用运行 kticket 的系统用户安装附件;检查 KTICKET_LICENSE_FILE 是否与安装时一致。
已有文件,无法安装确认要替换后使用 kticket license install --force FILE。
wrong machine对比当前 Machine ID 和购买时提交的值;设备变化时联系支持。
文件无效或损坏从原邮件恢复未修改的附件;仍失败时联系支持。
无法识别签名密钥升级 kticket 后重试;已是最新版时联系支持。

完整安装步骤见 License 购买与激活。

联系支持

通过支持页面提交 kticket 版本、操作系统、执行的命令和错误信息。付款或 License 问题可附上订单编号及 Machine ID。请移除令牌、管理员 kubeconfig 和其他凭据,不要把它们粘贴到公开问题或邮件中。