基于Docker部署Airflow时如何通过entrypoint.sh自动创建连接

两个失效场景的原因非常明确：

• Dockerfile中的RUN指令在镜像构建阶段执行，此时Airflow元数据库尚未初始化，docker-compose挂载的环境变量、airflow.cfg配置都未加载，执行airflow connections命令无法连接元数据库，必然报错，你之前的时序判断是准确的。
• 自定义entrypoint.sh不生效、echo无输出，通常是三个问题导致：一是改完脚本未重新构建镜像，容器内运行的还是旧版本脚本；二是你把自定义命令写在了entrypoint最后exec "$@"行的后面，该行执行后会替换当前进程为Airflow主服务，后续命令永远不会触发；三是脚本未配置可执行权限、或挂载路径错误导致自定义脚本根本没被加载。

按可靠性、维护成本从高到低排序：

方案1：使用Airflow原生环境变量注册连接（首推） #

Airflow原生支持通过环境变量自动加载连接，完全不需要写自定义脚本或命令，没有时序问题。直接在docker-compose.yml的公共环境变量配置段添加对应配置即可：

x-airflow-common:
  &airflow-common
  environment:
    &airflow-common-env
    AIRFLOW_CONN_MY_CON_ID: 'SSH://myuser@255.255.255.255:22'

注意规则：环境变量名固定为AIRFLOW_CONN_拼接全大写的连接ID，连接ID中的非字母、数字字符统一替换为下划线
该配置会在Airflow服务启动时自动识别加载，不会重复创建，重启服务也不会出现冲突。

方案2：在服务启动命令中追加初始化逻辑 #

如果需要用CLI命令创建，不需要修改原始entrypoint，直接在对应服务（一般选scheduler服务，它会随集群常驻启动）的command段追加逻辑，等待数据库初始化完成后再执行创建命令：

services:
  airflow-scheduler:
    <<: *airflow-common
    command:
      - bash
      - -c
      - |
        airflow db wait
        airflow connections add 'my_con_id' --conn-uri 'SSH://myuser@255.255.255.255:22' || true
        exec airflow scheduler

其中airflow db wait会阻塞直到元数据库完全可用、初始化完成，彻底规避时序问题；末尾加|| true是做幂等兼容，避免连接已存在时命令报错阻塞服务启动。

方案3：修正entrypoint.sh的配置逻辑 #

如果坚持通过entrypoint注入初始化命令，需要满足三个要求：

• 自定义命令必须写在entrypoint脚本最后一行exec "$@"的前面，绝对不能写在该行之后
• 本地修改完entrypoint.sh后，先执行chmod +x entrypoint.sh赋予可执行权限，再重新执行docker compose build重构镜像，确保容器内加载的是最新版本的脚本
• 命令后追加|| true做幂等处理，避免重复执行报错
  正确的脚本片段示例：

# --- 以上是entrypoint原有初始化逻辑 ---
echo "Loading custom connections"
airflow connections add 'my_con_id' --conn-uri 'SSH://myuser@255.255.255.255:22' || true

# 最后一行启动主进程
exec "$@"

• 禁止在Dockerfile构建阶段（即RUN指令中）执行任何需要访问Airflow元数据库、依赖运行时配置的命令，构建阶段没有运行态的服务、挂载配置、网络连通性，这类操作100%会失败
• 所有初始化类命令必须做幂等兼容，避免容器重启时重复执行导致报错，阻塞服务启动
• 修改容器内置脚本、配置后必须重新构建镜像，否则改动不会在运行的容器中生效

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