故障处理
先阅读错误信息和操作报告,确认哪些步骤已完成,再决定是否重试。发生错误不代表此前的变更已经撤销。
无法连接集群或权限不足
确认管理员 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 和其他凭据,不要把它们粘贴到公开问题或邮件中。