Eclipse Che 在 Kubernetes 中通过 Helm 安装失败的解决方案

问题背景

在使用 Helm 安装 Eclipse Che 时，许多用户可能会遇到 Operator 启动失败的问题，表现为 Pod 进入 CrashLoopBackOff 状态。这通常是由于缺少必要的依赖组件导致的。

错误现象

当尝试通过 Helm 安装 Eclipse Che 时，Operator 日志中会出现以下关键错误信息：

no matches for kind "DevWorkspaceRouting" in version "controller.devfile.io/v1alpha1"
no matches for kind "DevWorkspaceOperatorConfig" in version "controller.devfile.io/v1alpha1"

这些错误表明系统缺少 DevWorkspace Operator (DWO) 的相关自定义资源定义(CRD)。

根本原因

Eclipse Che 依赖于 DevWorkspace Operator 来管理工作区。当通过 Helm 安装时，默认不会自动安装这个依赖项，这与使用 chectl 工具安装不同，后者会自动处理所有依赖关系。

解决方案

要成功通过 Helm 安装 Eclipse Che，需要先手动安装 DevWorkspace Operator：

1. 首先应用 DevWorkspace Operator 的部署清单：

kubectl apply -f https://raw.githubusercontent.com/devfile/devworkspace-operator/v0.26.0/deploy/deployment/kubernetes/combined.yaml

2. 确认 DevWorkspace Operator 已成功安装并运行：

kubectl get pods -n devworkspace-controller

3. 然后继续执行 Helm 安装命令：

helm install my-eclipse-che eclipse-che/eclipse-che --version 7.83.0 -n eclipse-che

补充说明

对于使用 Keycloak 作为 OIDC 提供者的情况，还需要确保正确配置了以下参数：

• OIDC 颁发者 URL
• OIDC 客户端 ID
• 用户名声明字段

这些配置可以通过 CheCluster CRD 或 Helm 的 values 文件进行设置。

最佳实践建议

1. 在生产环境中，建议将 DevWorkspace Operator 的 YAML 文件下载到本地进行版本控制，而不是直接从远程 URL 应用。

2. 对于 Minikube 环境，可以考虑使用 chectl 工具进行安装，因为它能自动处理所有依赖关系和配置。

3. 定期检查 Eclipse Che 和 DevWorkspace Operator 的版本兼容性，确保使用经过测试的组合。

通过遵循上述步骤，您应该能够成功在 Kubernetes 集群中通过 Helm 安装 Eclipse Che，并避免因缺少依赖组件而导致的安装失败问题。