KubeClipper 1.7.0 发布：Operation 优化与 Kubernetes 1.37 支持
内容提要
KubeClipper 1.7.0发布，引入Operation v2机制，通过API和etcd管理集群操作，支持任务查询、重试和取消。新版本支持Kubernetes 1.37，新增kcctl status和doctor诊断命令，优化Registry管理和离线镜像加载，提升部署稳定性。该工具轻量易用，可快速创建和管理多集群。
延伸解读
Operation v2 带来的运维变化
1.7.0 将集群操作统一为 API 驱动的 Operation v2，并存入 etcd。这意味着集群创建、扩容、删除等任务的状态可查询、可重试、可取消，甚至支持重启恢复。相比旧版，运维人员能更清晰地掌握操作进度，失败后也无需从头再来，提升了多集群管理的可控性。
诊断命令的实用价值
新增的 kcctl status 和 kcctl doctor 命令，让平台健康检查变得简单。status 快速查看 kc-server、kc-etcd、kc-agent 的整体状态，doctor 则深入检查配置和服务，并给出排查信息。注意 doctor 只诊断不修复，定位问题后仍需手动处理，适合作为日常巡检和故障排查的第一步。
镜像管理方式的调整
新版本将镜像仓库配置改为引用 Registry 资源，创建集群时直接指定名称即可，简化了配置。同时修复了 HTTP Registry 协议丢失问题，离线模式支持加载节点本地镜像。升级后需注意旧的 repository/local registry 字段已移除，使用旧配置的脚本可能需要调整。
升级前需关注的兼容性
1.7.0 默认 Kubernetes 版本升至 v1.37.0，同时支持 v1.36.4 和 v1.35.8。若现有集群使用旧版本，升级前需确认兼容性。此外，部署预检查新增端口占用检查，若节点端口被占用会明确提示，建议提前清理环境，避免部署失败。
Q&A
KubeClipper 1.7.0 有哪些主要新特性？
KubeClipper 1.7.0 的主要新特性包括：引入 API 驱动的 Operation v2 机制，支持任务状态查询、重试、取消和重启恢复；新增 kcctl status 和 kcctl doctor 平台诊断命令；支持 Kubernetes 1.37（默认 v1.37.0），并同步更新 v1.35 和 v1.36 至最新维护版本；优化 Registry 管理，支持离线镜像加载；增加部署预检查（如端口占用检查）和稳定性修复。
KubeClipper 1.7.0 的 Operation v2 机制是什么？相比旧版有什么改进？
Operation v2 是 KubeClipper 1.7.0 引入的 API 驱动的集群操作管理机制。它将 Operation 和 OperationTask 作为 API 资源保存到 etcd，支持查看任务状态、重试、取消、超时处理和重启恢复。集群创建、扩缩容、删除、备份恢复等操作统一使用该机制。相比旧版，它移除了 NATS 投递链路，修复了状态持久化、并发更新冲突、操作清理等问题，并优化了关键状态读取和事件分发效率，使集群操作更加可靠。
kcctl status 和 kcctl doctor 命令有什么作用？
kcctl status 用于查看 kc-server、kc-etcd 和 kc-agent 的整体健康状态；kcctl doctor 用于进一步检查平台配置和服务状态，在异常时给出排查信息。doctor 只做诊断，不会自动修改或重启服务。
KubeClipper 1.7.0 支持哪些 Kubernetes 版本？
KubeClipper 1.7.0 支持 Kubernetes v1.37.0（默认）、v1.36.4 和 v1.35.8，同时配套 Calico v3.31.5 和 Containerd v2.2.4。
KubeClipper 1.7.0 在镜像仓库管理和离线镜像方面做了哪些优化？
1.7.0 将 Cluster.imageRegistry 调整为引用已配置的 Registry 资源，创建或升级集群时直接传入资源名称，KubeClipper 会自动读取 Registry 的地址、协议、认证和证书配置。旧的 image repository/local registry 字段和 CLI 别名已移除。同时修复了 HTTP Registry 协议丢失的问题。离线模式且未指定 Registry 时，会直接加载离线安装包中随包分发到节点的镜像；在线模式未指定 Registry 时，各组件继续使用自己的默认镜像仓库。
KubeClipper 1.7.0 在部署和运行稳定性方面做了哪些改进？
部署方面：新增服务端口占用检查，预检查异常会明确显示节点 IP 和角色；部署 kc-server 前会等待 etcd Endpoint 通过健康检查；支持通过 --temp-dir 指定安装包暂存目录。运行方面：修复了操作历史清理、Agent 命令输出缓冲、子进程管道阻塞和 watch 事件恢复等问题。
如何快速安装 KubeClipper 1.7.0 并创建第一个 Kubernetes 集群？
快速体验步骤：1. 安装 kcctl：curl -sfLk https://oss.kubeclipper.io/get-kubeclipper.sh | bash -；2. 部署服务：kcctl deploy；3. 创建集群：kcctl create cluster --name demo --master YOUR_IP --untaint-master；4. 打开控制台：访问 http://YOUR_IP，默认账号 admin/Thinkbig1。部署完成后可用 kcctl status 和 kcctl doctor 检查平台状态。
KubeClipper 1.7.0 的环境要求是什么？
环境要求：CPU 2核及以上，内存 4GB及以上，操作系统推荐 Ubuntu 22.04/24.04，网络需节点间互通并可通过 SSH 连接，基础工具需 sudo/curl/wget/tar，架构支持 amd64/arm64。主机最好保持相对干净，避免已有容器运行时或系统配置冲突。
