Eclipse Che 自定义工作空间端点域名配置指南

背景介绍

Eclipse Che 是一款开源的云原生集成开发环境(IDE)平台，它允许开发团队在 Kubernetes 或 OpenShift 集群上快速创建和管理开发环境。在实际生产部署中，企业通常需要根据自身需求定制 Che 服务器的访问域名。

问题描述

当管理员为 Eclipse Che 配置自定义主机名时（例如 che.devs.mycompany.com），虽然仪表板和 IDE 访问会使用这个自定义域名，但开发工作空间中定义的公共端点(Public Endpoints)仍然会使用集群默认的基础域名生成路由。这会导致端点访问地址不一致，例如：

https://<user>-<workspace>-<endpoint-name>.apps.<default base domain>

这种不一致性会给网络配置和管理带来不便，特别是当企业需要迁移到新集群但希望保持相同域名结构时。

解决方案

1. 统一工作空间端点域名

通过修改 CheCluster 自定义资源(CR)，可以指定工作空间端点使用与 Che 服务器相同的域名基础：

spec:
  components:
    cheServer:
      extraProperties:
        CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX: "devs.mycompany.com"

这个配置将确保所有工作空间端点都使用统一的基础域名，例如：

https://<user>-<workspace>-<endpoint-name>.devs.mycompany.com

2. 端点路由策略优化

除了统一域名外，Eclipse Che 还支持通过主网关代理工作空间端点，避免为每个端点创建独立路由。这可以通过在工作空间端点定义中添加特定属性实现：

endpoints:
- name: node
  targetPort: 4200
  exposure: public
  protocol: https
  attributes:
    urlRewriteSupported: true

启用此功能后，端点将通过主 Che 网关访问，格式为：

https://<che_url>/<user>-<workspace>-<endpoint-name>

注意：这种模式下所有端点将要求身份验证，不再适合直接与团队成员共享。

进阶配置建议

对于企业级部署，建议考虑以下配置策略：

1. 全局路由策略：目前端点路由策略需要在每个端点单独配置，未来版本可能会支持全局配置

2. 认证控制：根据安全需求，可以控制是否对生成端点实施认证

3. DNS 配置：使用网关代理模式可以简化 DNS 配置，只需为 Che 主域名设置记录，无需配置通配符记录

总结

通过合理配置 Eclipse Che 的工作空间端点域名和路由策略，企业可以实现：

• 统一的访问域名结构
• 简化的网络配置
• 灵活的安全控制
• 更便捷的集群迁移

这些配置选项使 Eclipse Che 能够更好地适应企业级部署场景，满足严格的网络和安全要求。