k8s-docs/k8s/xiongxiao.me/update/rancher/update.md

Rancher 更新指南

当前版本 2.13.0 最新版本2.13.1

1. 备份当前 Rancher

# 备份 Rancher Deployment 配置
kubectl get deployment rancher -n cattle-system -o yaml > rancher-backup.yaml

# 备份重要数据 (如果是 PVC 存储)
kubectl get pvc -n cattle-system

2. 添加/更新 Rancher Helm 仓库

# 添加 Rancher Helm 仓库
helm repo add rancher-latest https://releases.rancher.com/server-charts/latest

# 更新 Helm 仓库
helm repo update

# 查看可用的 Rancher 版本
helm search repo rancher-latest/rancher -l | head -20

3. 执行更新

# 执行更新 (将 v2.x.x 替换为目标版本)
helm upgrade rancher rancher-latest/rancher \
  --namespace cattle-system \
  --set hostname=rancher.xiongxiao.me \
  --set replicas=3 \
  --set bootstrapPassword="your-secure-password"

# 如果有自定义 values.yaml 文件
# helm upgrade rancher rancher-latest/rancher -f values.yaml --namespace cattle-system

4. 验证更新状态

# 监控 Pod 状态
kubectl get pods -n cattle-system -w

# 检查 Deployment 滚动更新状态
kubectl rollout status deployment/rancher -n cattle-system

# 查看日志确认正常启动
kubectl logs -f deploy/rancher -n cattle-system

5. 验证 Rancher 功能

• 访问 https://rancher.xiongxiao.me
• 检查集群状态
• 检查用户、角色、设置是否正常

注意事项

• 版本兼容性: 确保新版本与 Kubernetes 集群版本兼容
• 升级路径: Rancher 升级需要按版本逐步升级 (如 2.6 → 2.7 → 2.8)
• 备份: 升级前务必备份 Rancher 数据
• 自定义配置: 使用自定义 values.yaml 时确保包含所有必要配置
• 回滚: 如遇到问题，可使用 helm rollback rancher <revision> --namespace cattle-system