ubuntu/airflow Docker 镜像 - 轩辕镜像

airflow | Ubuntu

镜像概述和主要用途

Apache Airflow是一个用于程序化创作、调度和监控工作流的平台。此镜像基于Ubuntu构建，包含Python和多种提供程序，来自Canonical，接收安全更新并会滚动更新至新版本的Airflow或Ubuntu。本仓库可免费使用，不受每用户速率限制。

核心功能和特性

• 安全维护：LTS通道提供长达5年的免费安全维护，ESM通道通过Canonical的受限仓库提供长达10年的客户安全维护。
• 多架构支持：支持amd64架构。
• 预安装提供程序：内置多种常用提供程序（Amazon、GCP、Kubernetes、MySQL、Postgres等），常见集成可直接使用，无需在容器内执行pip install。
• 轻量级服务管理：使用Pebble（轻量级服务管理器）作为PID 1进程，监督Airflow服务。
• 独立模式运行：airflow standalone模式可初始化本地元数据库、创建默认管理员用户，并启动webserver、调度器等核心组件（适用于开发环境）。

标签和架构

!LTS
LTS通道提供长达5年的免费安全维护。

!ESM
ESM通道通过Canonical的受限仓库提供长达10年的客户安全维护。

通道标签按稳定性排序：stable、candidate、beta、edge。风险较高的通道默认可用（如列出beta，则可拉取edge；列出candidate，则可拉取beta和edge；列出stable，则四个通道均可用）。镜像会按edge→beta→candidate→stable的顺序更新。

商业使用和扩展安全维护通道

若需商业 redistribution，或需要ESM及未列出的通道/版本，请联系Canonical团队（或发送邮件至***）。

使用方法

本地启动镜像

sh
docker run -d --name airflow-container -e TZ=UTC -p 8080:8080 -e AIRFLOW_HOME=/opt/airflow -v /path/to/dags:/opt/airflow/dags -v /path/to/airflow.cfg:/opt/airflow/airflow.cfg ubuntu/airflow:3.1-24.04_edge

Entrypoint 和 Pebble

该镜像使用Pebble（轻量级服务管理器）作为PID 1进程，监督镜像中定义的Airflow服务。

Airflow服务配置

airflow服务配置如下：

command: /usr/bin/airflow standalone
startup: enabled

airflow standalone会初始化本地元数据库、创建默认管理员用户，并在一个进程组中启动webserver、调度器及其他核心组件（适用于开发环境）。

配置与状态

• 运行时状态（AIRFLOW_HOME）位于/opt/airflow，包含airflow.cfg、airflow.db（独立模式默认数据库）、日志和dags/。
• 需挂载卷以持久化数据或注入自定义DAG，例如：

  -v ./dags:/opt/airflow/dags  # 挂载自定义DAG目录
  -v ./airflow.cfg:/opt/airflow/airflow.cfg  # 挂载自定义配置文件
  

提供程序

镜像预安装多种提供程序（Amazon、GCP、Kubernetes、MySQL、Postgres等），常见集成可直接使用，无需在容器内执行pip install。

完整配置参考

Airflow支持通过环境变量或airflow.cfg进行大量配置。完整配置项可参考官方配置参考文档。

参数说明

测试/调试

查看容器日志：

sh
docker logs -f airflow-container

进入容器交互式shell：

sh
docker exec -it airflow-container /bin/bash

缺陷和功能请求

如发现镜像缺陷或需请求功能，请提交bug至：
[***]

bug标题格式为“airflow: <问题摘要>”，并需包含所用镜像的摘要，可通过以下命令获取：

sh
docker images --no-trunc --quiet ubuntu/airflow:<tag>

废弃的通道和标签

以下通道（标签）不再更新，请升级至较新通道；如无法升级，请联系我们。