Astro Docker容器启动失败：`airflow create_user`命令已移除求助

问题原因 #

报错里的airflow create_user是Airflow旧版命令，在Airflow 2.x版本中已被替换为airflow users create。你虽未在自己的Dockerfile或入口文件显式调用该命令，但问题大概率来自以下场景：

• 本地Astro CLI版本与astro-runtime:9.14.0镜像不兼容，CLI启动容器时注入了旧命令逻辑
• 项目根目录的config.yaml或自定义启动脚本中隐含了旧命令调用
• Docker缓存残留了旧镜像层或配置

解决方案 #

• 检查并升级Astro CLI版本
  运行astro version查看当前CLI版本，确保其与astro-runtime:9.14.0匹配（9.x系列runtime要求CLI版本至少为1.19.0）。若版本过低，执行astro upgrade升级到兼容版本。

• 排查项目配置文件

  1. 查看项目根目录的config.yaml，检查airflow.users相关配置，确认未使用旧命令格式
  2. 检查项目中是否存在自定义entrypoint.sh或启动脚本，若有调用airflow create_user的代码，替换为airflow users create

• 清理旧容器与缓存

  1. 停止并清理现有Astro项目容器：

     astro dev stop
     astro dev clean
     

  2. 删除旧镜像并重新拉取：

     docker rmi quay.io/astronomer/astro-runtime:9.14.0-python-3.11-base
     astro dev start
     

• 显式配置正确的用户创建逻辑（可选）
  若需自定义初始用户，可在Dockerfile中添加正确命令：

  FROM quay.io/astronomer/astro-runtime:9.14.0-python-3.11-base
  RUN airflow users create \
      --username admin \
      --firstname Admin \
      --lastname User \
      --role Admin \
      --email admin@example.com \
      --password admin
  

  或在config.yaml中配置：

  airflow:
    users:
      - username: admin
        firstname: Admin
        lastname: User
        role: Admin
        email: admin@example.com
        password: admin
  

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