Guandata-Server 配置 HostAlias 解析本地域名

1. 文档说明

本文档面向社区用户，解决连接时因域名解析失败报错的问题文中以trino服务配置IP与域名为例可替换实际需配置服务，核心提供基于 guandata-server-controller.yaml 与values.yaml配置文件、Helm 部署环境下的 HostAlias 配置方案，适用于 guandata-server容器场景，优先保障 guandata-server-controller配置的准确性。

2. 前置条件

l  已登录 guandata-server 部署节点，具备 root / 管理员权限；

l  明确需解析的本地域名（如 trino.local）和对应目标 IP 地址（如 192.168.1.100）；

l  持有 guandata-server-controller.yaml 配置文件的编辑权限；

l  若为 Helm 部署，无需持有 guandata-server-controller.yaml 配置文件；

3. 核心配置方案

方案选择按以下方式检查：

在/home/guandata/Development/guandata-server检查是否存在guandata-server-controller.yaml或通过命令helm list来进行检查

当存在guandata-server-controller.yaml或helm list命令无响应则使用方案一

当guandata-server-controller.yaml不存在或helm list命令响应如图则使用方案二

3.1 方案一：修改 guandata-server-controller.yaml（K8s 原生配置）

方案适用于非Helm环境，如/home/guandata/Development/guandata-server未存在guandata-server-controller.yaml文件请参考方案二

适用于直接通过 Kubernetes YAML 配置文件部署 guandata-server 的场景，在 guandata-server-controller.yaml 中添加 hostAliases 字段实现域名解析。

3.1.1 进入/home/guandata/Development/guandata-server

3.1.2 在如下示例插入数据，通过 hostAliases 注入

3.1.3 应用修改

3.1.4 重启部署

3.1.5 检查部署正常启动，为ready1/1 即可

3.2 方案二：修改 values.yaml（Helm配置）

       适用于 Kubernetes 集群中通过 Helm 部署 guandata-server 的场景，通过修改 Helm Values 关联文件（关联 values.yaml）配置 hostAliases。

结合 guandata-server-controller Deployment 模板（含 {{- include "guandata_server_host_aliases.name" . }} 引用），详细说明如何在 values.yaml 中配置 hostAliases 实现本地域名解析

3.2.1 进入/home/guandata/Development/guandata-server

3.2.2 在如下示例插入数据，通过 hostAliases 注入

3.2.3 执行变更应用

3.2.4 检查部署正常启动，为ready1/1 即可