Harvester项目中的Rancher UI扩展在离线环境下的部署指南

前言

在企业级Kubernetes管理场景中，离线环境(air-gapped)部署是一个常见需求。本文将详细介绍如何在离线环境中为Harvester项目配置Rancher UI扩展，帮助系统管理员和DevOps工程师顺利完成部署。

离线环境部署的核心挑战

Harvester从1.5版本开始引入了与Rancher v2.10.x的UI扩展集成。在标准网络环境下，UI扩展可以自动安装，但在离线环境中需要特殊配置。主要面临以下挑战：

1. 需要建立本地扩展仓库
2. Rancher UI对社区仓库的自动检测机制不适用于离线环境
3. 版本升级时的兼容性问题

离线环境部署方案

1. 建立本地扩展仓库

首先需要准备一个容器镜像仓库来托管Harvester UI扩展的Chart包。推荐使用Harbor或Nexus等企业级仓库解决方案。

关键步骤包括：

• 从Harvester官方仓库获取UI扩展Chart包
• 将Chart推送到本地仓库
• 配置适当的访问权限和认证

2. Rancher中的配置

在Rancher管理界面中，需要手动添加本地仓库作为扩展源：

1. 导航至"全局设置"→"扩展"
2. 添加新的扩展仓库，指定本地仓库地址
3. 验证仓库连接状态

3. 安装UI扩展

虽然Rancher UI会显示"Missing Repo"错误提示，但仍可通过以下方式手动安装：

1. 创建Extension自定义资源
2. 指定本地仓库中的Chart路径
3. 应用配置并等待扩展加载

技术细节与最佳实践

命名空间注意事项

在Rancher v2.10.2版本中，需要预先创建cattle-ui-plugin-system命名空间。这是Rancher UI扩展运行的基础环境，建议在部署Rancher时就创建好该命名空间。

版本兼容性

不同版本的Harvester需要对应特定版本的UI扩展：

• Harvester 1.3/1.4/1.5分别有对应的扩展版本
• 升级时需要同步更新扩展版本

自动化改进方向

当前方案存在以下可优化点：

1. 集成Rancher的useSystemBundledCharts机制
2. 自动检测离线环境状态
3. 简化本地仓库的构建流程

总结

离线环境下的Harvester UI扩展部署虽然需要额外步骤，但通过合理的规划和配置完全可以实现稳定运行。建议企业在实施前：

1. 详细规划仓库架构
2. 测试不同版本的兼容性
3. 建立完善的升级流程

随着Harvester项目的持续发展，预计未来版本会进一步简化离线部署流程，为企业用户提供更便捷的管理体验。