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

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

2025-05-31 06:03:02作者:侯霆垣

背景介绍

在企业级开发环境中,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 的端点域名策略,企业可以实现更符合自身网络架构的开发环境,同时确保安全性和易用性的平衡。

登录后查看全文
热门项目推荐
相关项目推荐