如何解决 Airflow 中的 DeprecationWarning 警告

本文详解如何消除 airflow cli 运行时出现的 kubernetes 配置项弃用警告（deprecationwarning），核心是将 airflow.cfg 中已迁移的配置节从 `[kubernetes]` 正确更新为 `[kubernetes_executor]`。

Airflow 自 2.0 版本起逐步重构 Kubernetes 相关配置结构，原属于 [kubernetes] 配置节下的 namespace 等关键参数（如 namespace、worker_container_repository、worker_container_tag 等）已被正式迁移至独立的 [kubernetes_executor] 节。若 airflow.cfg 中仍保留旧配置节，Airflow 会在启动或执行 CLI 命令（如 airflow info、airflow db migrate）时触发如下警告：

DeprecationWarning: The namespace option in [kubernetes] has been moved to the namespace option in [kubernetes_executor] - the old setting has been used, but please update your config.

该警告虽不影响功能运行，但会干扰日志可读性，并可能在后续版本中升级为错误。

✅ 解决步骤如下：

1. 定位并打开 airflow.cfg 文件
   通常位于 $AIRFLOW_HOME/airflow.cfg（默认为 ~/airflow/airflow.cfg）。可通过以下命令确认路径：

   airflow config get-value core airflow_home

2. 查找并迁移配置节
   使用文本编辑器搜索 [kubernetes] 配置节（常见于文件约第 1086 行附近），将其整体重命名为 [kubernetes_executor]。例如：

   ❌ 旧配置（触发警告）：

   [kubernetes]
   namespace = default
   worker_container_repository = apache/airflow
   worker_container_tag = 2.9.0

   ✅ 新配置（推荐写法）：

   [kubernetes_executor]
   namespace = default
   worker_container_repository = apache/airflow
   worker_container_tag = 2.9.0

3. 删除或注释旧节（重要！）
   若同时存在 [kubernetes] 和 [kubernetes_executor] 两个节，Airflow 会优先读取旧节并继续报警告。请确保旧 [kubernetes] 节完全移除或注释掉（如加 # 前缀），避免冲突。

4. 验证修复效果
   重启 Airflow（如需）后执行任意 CLI 命令，警告应不再出现：

   airflow info | head -n 10

⚠️ 注意事项：

• 修改 airflow.cfg 后，需确保所有 Airflow 组件（Webserver、Scheduler、Workers）均使用更新后的配置；若使用容器部署，请同步更新配置挂载或环境变量注入逻辑。
• 若通过环境变量（如 AIRFLOW__KUBERNETES__NAMESPACE）设置参数，也需同步改为 AIRFLOW__KUBERNETES_EXECUTOR__NAMESPACE。
• 推荐参考 Airflow 官方配置文档 获取最新支持参数列表。

完成上述迁移后，DeprecationWarning 将彻底消失，配置更符合当前版本规范，也为未来升级铺平道路。

# apache  # ai  # 环境变量  # kubernetes  # Namespace  # 重构  # 节下  # 已被  # 会在  # 将其  # 能在  # 并可  # 也为  # 可通过  # 如需  # 重启 

相关文章： 网站网页制作专业公司,怎样制作自己的网页？  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  nginx修改上传文件大小限制的方法  如何在云主机快速搭建网站站点？  行程制作网站有哪些,第三方机票电子行程单怎么开？  济南企业网站制作公司,济南社保单位网上缴费步骤？  韩国服务器如何优化跨境访问实现高效连接？  网站微信制作软件,如何制作微信链接？  中山网站推广排名,中山信息港登录入口？  北京制作网站的公司排名,北京三快科技有限公司是做什么？北京三快科技？  青浦网站制作公司有哪些,苹果官网发货地是哪里？  建站主机无法访问？如何排查域名与服务器问题  Android自定义listview布局实现上拉加载下拉刷新功能  网站制作与设计教程,如何制作一个企业网站，建设网站的基本步骤有哪些？  广州营销型建站服务商推荐：技术优势与SEO优化解析  建站之星价格显示格式升级，你的预算足够吗？  如何快速生成可下载的建站源码工具？  潮流网站制作头像软件下载,适合母子的网名有哪些？  我的世界制作壁纸网站下载,手机怎么换我的世界壁纸？  如何规划企业建站流程的关键步骤？  如何通过二级域名建站提升品牌影响力？  建站之星如何开启自定义404页面避免用户流失？  建站之星导航配置指南：自助建站与SEO优化全解析  临沂网站制作公司有哪些,临沂第四中学官网？  高性价比服务器租赁——企业级配置与24小时运维服务  儿童网站界面设计图片,中国少年儿童教育网站-怎么去注册？  建站之星微信建站一键生成小程序+多端营销系统  简单实现Android文件上传  网站按钮制作软件,如何实现网页中按钮的自动点击？  重庆市网站制作公司,重庆招聘网站哪个好？  c# F# 的 MailboxProcessor 和 C# 的 Actor 模型  清单制作人网站有哪些,近日“兴风作浪的姑奶奶”引起很多人的关注这是什么事情？  如何通过商城自助建站源码实现零基础高效建站？  建站之星多图banner生成与模板自定义指南  网站制作的步骤包括,正确网址格式怎么写？  建站之星CMS建站配置指南：模板选择与SEO优化技巧  如何用VPS主机快速搭建个人网站？  Thinkphp 中 distinct 的用法解析  哈尔滨网站建设策划,哈尔滨电工证查询网站？  宝塔面板如何快速创建新站点？  上海网站制作网页,上海本地的生活网站有哪些？最好包括生活的各个方面的？  c++怎么用jemalloc c++替换默认内存分配器【性能】  建站之家VIP精选网站模板与SEO优化教程整合指南  高防服务器：AI智能防御DDoS攻击与数据安全保障  内网网站制作软件,内网的网站如何发布到外网？  如何生成腾讯云建站专用兑换码？  建站之星后台搭建步骤解析：模板选择与产品管理实操指南  网站好制作吗知乎,网站开发好学吗？有什么技巧？  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用？  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？