什么是syself-autopilot-hetzner
syself-autopilot-hetzner 是一个专为 Hetzner 云平台上的 SySelf Autopilot 托管 Kubernetes 集群设计的管理工具链。它聚焦于通过官方支持的 ClusterStack 流程，实现从管理集群访问、Hetzner 账户准备到工作负载集群创建和后续运维的全生命周期自动化操作。该工具特别适用于需要结合 HCloud 云控制平面与裸金属（bare metal）物理服务器作为 Worker 节点的混合架构场景，是 SySelf 托管平台下标准部署路径的核心执行层。
使用 syself-autopilot-hetzner 的前提是用户已接入 SySelf 托管的 Autopilot 环境，并拥有相应组织命名空间权限。整个流程严格遵循官方文档定义的操作边界，强调使用声明式 Kubernetes 资源（如 HetznerBareMetalHost、ClusterStack、Cluster）而非底层基础设施直接干预。同时，所有涉及 Hetzner HCloud API 的操作均依赖 companion skill `hetzner-cloud` 来确保安全性和合规性，例如避免凭证泄露、在执行变更前请求确认、展示精确 hcloud 命令等。
此工具不适用于自管理的 CAPH（Cluster API Provider Hetzner）引导流程，也不支持未经官方验证的基础设施设计或实验性行为。其核心职责在于提供可靠、可重复且受支持的操作指导，覆盖从初始配置到日常维护的所有关键环节，同时明确标识出 SySelf 官方不支持的技术假设（如 UEFI-only 服务器、Hetzner 防火墙/vSwitch 依赖），防止用户在超出支持范围的情况下盲目调试。
核心功能特点
- 管理 kubeconfig 配置与组织命名空间设置，确保对 SySelf 托管管理集群的安全访问
- 组织命名空间与 Hetzner 账户准备：集成 HCloud Token、Robot 凭据及 SSH 密钥管理
- 注册裸金属主机（HetznerBareMetalHost）：支持基于标签的节点选择、WWN 磁盘识别与硬件预检
- 应用 ClusterStack 与 Cluster 清单：驱动受控版本发布与工作负载集群自动化部署
- 执行 day-2 运维操作：包括横向扩展、HA 调整、特定节点移除、裸金属维护及问题排查
适用场景
syself-autopilot-hetzner 最适合在采用 SySelf 托管 Autopilot 模式的企业环境中使用，尤其是那些希望在 Hetzner 基础设施上构建高可用、可扩展的 Kubernetes 集群，并充分利用裸金属服务器性能优势的场景。典型用例包括金融、游戏或高性能计算领域，其中部分关键服务需运行在本地 SSD 存储的裸金属节点上，而控制平面则部署在弹性可靠的 HCloud 实例中以实现成本与稳定性的平衡。
该工具特别擅长处理混合节点类型集群的部署与管理——即由 HCloud 虚拟机组成控制平面，同时接入多组物理裸金属机器作为 Worker 节点。这种架构既能满足合规性要求（如数据本地化），又能利用公有云自动扩缩容能力应对突发流量。此外，对于已有裸金属资产的企业，syself-autopilot-hetzner 提供了标准化的接入流程，无需自行搭建 bootstrap 集群即可完成节点注册与加入。
在日常运维方面，该技能支持多种常见任务：例如根据业务增长动态增加裸金属或云 Worker；提升控制平面高可用性至 3 或 5 副本；针对故障节点进行 graceful 下线与维护后重新上线；以及结合 Cluster Autoscaler 实现智能资源调度。所有操作均在 SySelf 官方支持范围内进行，避免引入不可逆的配置偏差或触发不受支持的修复手段。