镜像本身静态不可变，环境感知依赖运行时机制：通过多架构清单统一入口、入口脚本读取环境变量或Downward API注入节点信息、ConfigMap/Secret挂载配置、initContainer预检适配，实现同一镜像在不同集群中自动加载对应配置与行为分支。
可以构建具备环境感知能力的镜像，但关键不在“镜像本身”去感知环境——Docker 镜像是静态的、不可变的。真正的环境感知必须由运行时机制（如启动脚本、配置注入、编排层决策）来完成。所谓“自动适配不同集群”，本质是让同一镜像在不同集群中启动时，能根据所在节点的实际环境（架构、资源、网络、角色等）动态加载对应配置或行为分支。
用多架构清单统一拉取入口
这是最基础也最关键的一步：避免为不同 CPU 架构维护多个 tag。
- 先构建并推送两个镜像：
xxx:stable-amd64和xxx:stable-arm64 - 启用实验性功能：
export DOCKER_CLI_EXPERIMENTAL=enabled - 创建清单：
docker manifest create xxx:stable xxx:stable-amd64 xxx:stable-arm64 - 标注平台：
docker manifest annotate xxx:stable xxx:stable-arm64 --arch arm64；同理标注 amd64 - 推送清单：
docker manifest push xxx:stable
之后用户执行 docker pull xxx:stable，Docker CLI 会自动选中匹配本地 uname -m 的镜像层。Kubernetes 调度时也会依据节点 node.status.nodeInfo.architecture 拉取对应变体。
在容器启动时注入运行时上下文
镜像内嵌一个轻量级入口脚本（如 entrypoint.sh），在 docker run 或 kubectl apply 启动时读取环境变量或挂载文件，实现逻辑分支。
- 利用 Kubernetes Downward API 将节点信息注入容器：
spec.containers.env中引用status.hostIP、metadata.labels、spec.nodeName等 - 在 Docker Compose 中通过
.env文件或environment:字段传入CLUSTER_ENV=prod、NETWORK_TYPE=5g等标识 - 入口脚本中判断：
if [ "$CLUSTER_ENV" = "edge" ]; then exec ./app --low-memory-mode; else exec ./app --full-features; fi
配合 ConfigMap/Secret 实现配置热分离
把与环境强相关的参数（如服务发现地址、限流阈值、日志级别、证书路径）从镜像中剥离，改用挂载方式注入。
- 为每个集群准备专属 ConfigMap，例如
config-prod、config-edge - 在 Pod YAML 中以 volume 形式挂载到固定路径，如
/etc/app/config.yaml - 应用启动时优先读取该路径配置；若不存在，则 fallback 到镜像内默认配置
- 更新配置无需重建镜像，只需更新 ConfigMap 并滚动重启 Pod
借助 initContainer 做集群适配预检
对强依赖环境的组件（如需绑定特定网卡、检查 GPU 驱动、探测本地存储类型），可用 initContainer 在主容器启动前完成校验和适配。
- 编写一个轻量 init 镜像，检测
/proc/cpuinfo、nvidia-smi、lsblk或自定义健康端点 - 将探测结果写入共享 emptyDir volume，如
/shared/env-info.json - 主容器启动时读取该文件，决定启用 CUDA 支持、切换存储驱动或跳过某模块
