K8s中Docker容器启动阶段HOSTNAME环境变量为空的问题咨询

DevOps 小满

2026-7-12

问题解答

这是预期行为吗？

是的，这完全符合容器与Kubernetes的运行逻辑：

镜像构建阶段（Dockerfile执行脚本时）：此时容器还未被Kubernetes调度，K8s不会注入任何集群相关配置。HOSTNAME变量来自你使用的Debian基础镜像的默认设置（也就是你看到的debuerreotype），和最终运行时的K8s环境无关。
容器运行阶段（SSH进入时）：Kubernetes在启动Pod时会自动覆盖容器的主机名，将其设置为Pod的名称（Pod名称通常包含所属Deployment的标识），同时HOSTNAME环境变量会同步更新为这个新的主机名，所以此时能拿到正确的值。

要在脚本中获取到K8s相关的主机名或Deployment名称，可通过以下方式处理：

将脚本移到容器启动阶段执行：把原本在Dockerfile里执行的脚本改为容器的CMD或ENTRYPOINT。这样脚本会在K8s完成容器配置后运行，此时HOSTNAME环境变量已经被正确设置。
直接注入Deployment名称（更可靠）：通过Kubernetes的Downward API，将Deployment名称直接作为环境变量注入容器，避免依赖主机名解析。在Deployment的YAML中添加如下配置：
```
env:
  - name: DEPLOYMENT_NAME
    valueFrom:
      fieldRef:
        fieldPath: metadata.name # 直接获取当前Deployment的名称
```
之后在Python中可以直接通过os.getenv("DEPLOYMENT_NAME")拿到准确的Deployment名称。
从Pod主机名提取Deployment名称：如果依赖HOSTNAME，Pod名称通常格式为{deployment-name}-{随机后缀}，可以通过字符串截取获取前缀，比如Python代码：
```
import os
hostname = os.getenv("HOSTNAME")
deployment_name = "-".join(hostname.split("-")[:-2]) # 适配多数K8s Pod命名格式，若Deployment名含连字符需调整
```

Kubernetes在启动Pod容器时，会修改容器的主机名配置，覆盖基础镜像自带的/etc/hostname内容。你SSH进入的是已经被K8s初始化完成的运行中容器，看到的是K8s设置后的主机名；而Dockerfile构建时的临时容器没有经过K8s的调度配置，所以保留了基础镜像的默认主机名。

内容的提问来源于stack exchange，提问作者Felipe