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

背景介绍

在企业级开发环境中，Eclipse Che 作为云原生开发平台，经常需要根据企业网络架构进行定制化配置。其中最常见的一个需求就是自定义工作区端点的域名配置。默认情况下，Eclipse Che 会使用 OpenShift 集群的默认基础域名来生成工作区端点，这可能导致与企业现有的域名体系不一致。

问题描述

当管理员为 Eclipse Che 配置自定义主机名（如 che.devs.mycompany.com）时，虽然仪表板和 IDE 访问会使用这个自定义域名，但开发者在 DevWorkspace 中定义的公共端点仍会使用集群默认的基础域名（如 apps.）。这种不一致性会给企业网络管理和 DNS 配置带来不便。

解决方案

自定义工作区端点域名后缀

通过修改 CheCluster 自定义资源，可以指定工作区端点使用的域名后缀：

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

配置后，工作区端点将使用统一的企业域名体系，如：https://<user>-<workspace>-<endpoint-name>.devs.mycompany.com

端点重写支持

对于希望所有端点都通过 Che 主网关访问的场景，可以在端点定义中添加 urlRewriteSupported 属性：

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

启用此功能后，端点将通过以下格式访问：https://<che_url>/<user>-<workspace>-<endpoint-name>

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

进阶配置建议

1. 全局路由策略控制：当前端点重写需要在每个端点单独配置，企业用户可考虑开发自定义控制器来实现全局策略控制。

2. 认证控制：根据企业安全策略，可以结合 OpenShift 的认证机制来控制端点的访问权限。

3. DNS 管理：对于大规模部署，建议使用通配符 DNS 记录来简化端点域名的管理。

最佳实践

1. 对于企业内部使用，建议统一使用企业域名后缀，保持一致性。

2. 对于需要频繁共享端点的场景，不建议启用 urlRewriteSupported，以避免认证带来的不便。

3. 定期检查端点暴露情况，确保不会意外暴露敏感服务。

通过合理配置 Eclipse Che 的端点域名策略，企业可以实现更符合自身网络架构的开发环境，同时确保安全性和易用性的平衡。