Hetzner-K3s 从1.1.5升级到2.0.8版本的经验总结

在将Hetzner-K3s集群从1.1.5版本升级到2.0.8版本的过程中，可能会遇到几个关键问题。本文将详细介绍这些问题的解决方案，帮助用户顺利完成升级。

升级前的准备工作

在开始升级前，需要完成以下准备工作：

1. 修改每个节点(包括master和worker)的/etc/k8s-resolv.conf文件，将其内容设置为nameserver 8.8.8.8
2. 删除本地原有的kubeconfig文件
3. 根据新版本要求更新配置文件结构
4. 确保启用了私有网络(private network)功能
5. 在配置文件中添加include_instance_type_in_instance_name: true选项

常见问题及解决方案

1. 控制平面无法就绪问题

升级过程中，控制平面可能无法正常启动。通过SSH连接到master节点后，检查k3s服务状态和日志，可能会发现如下错误：

flag provided but not defined: -embedded-registry

解决方案：在配置文件中显式禁用嵌入式registry镜像功能：

embedded_registry_mirror:
  enabled: false

这是因为较旧版本的k3s(v1.29.0+k3s1)不支持嵌入式registry功能。如果需要此功能，需要先升级k3s版本。

2. 节点标签和污点配置问题

升级后，原有的节点标签和污点配置可能会出现以下错误：

error: resource(s) were provided, but no name was specified

解决方案：这是一个已知问题，将在后续版本中修复。目前可以手动为节点添加标签和污点作为临时解决方案。

3. System Upgrade Controller问题

升级完成后，System Upgrade Controller可能会出现异常。通常重新运行hetzner-k3s create命令可以解决此问题。

升级后的验证

升级完成后，建议进行以下验证步骤：

1. 检查集群状态：使用kubectl get nodes确认所有节点状态为Ready
2. 验证核心组件：检查kube-system命名空间下的pod是否全部正常运行
3. 测试网络连接：验证节点间网络通信是否正常
4. 检查存储功能：验证CSI驱动是否正常工作

总结

Hetzner-K3s从1.x升级到2.x版本时，需要注意配置文件结构的变化和功能兼容性问题。特别是嵌入式registry功能和节点标签配置，在升级过程中需要特别关注。按照本文提供的解决方案，可以顺利完成升级并确保集群稳定运行。

对于生产环境，建议先在测试环境验证升级过程，确认无误后再进行正式升级。同时，升级前做好数据备份，以防万一出现问题时可以快速恢复。