Helm安装AirFlow时设置UI可见的变量与连接的实现方法

使用官方Airflow Helm Chart部署时，完全支持原生配置可在UI正常展示、管理的Variable与Connection，不需要使用非规范的变通方案，具体配置方法如下：

核心配置逻辑 #

官方Helm Chart内置了部署启动时的自动同步Job，会将你在values中声明的变量、连接信息自动持久化写入Airflow元数据库，同步完成后即可在Web UI的对应管理页面看到所有配置项，同时支持Helm版本升级、回滚时自动同步配置变更，比临时脚本、环境变量注入的方案更符合GitOps规范。

1. 配置Variables #

直接在values.yaml的variables字段下声明需要的变量即可，支持明文配置普通变量，也支持引用K8s Secret存储敏感变量：

• 普通非敏感变量配置示例：

variables:
  - variable_name: deploy_env
    variable_value: production
  - variable_name: default_s3_bucket
    variable_value: airflow-prod-artifacts

• 敏感变量（从Secret读取，UI自动隐藏值）配置示例：

variables:
  - variable_name: internal_api_key
    variable_value: ""
    secretName: airflow-sensitive-secrets
    secretKey: internal_api_key

配置完成部署后，所有变量都会出现在Web UI的Admin > Variables页面，可直接通过Variable.get("<variable_name>")正常调用。

2. 配置Connections #

Connections配置逻辑和Variables一致，在values.yaml的connections字段下声明即可，同样支持明文配置和Secret引用：

• 普通连接配置示例：

connections:
  - conn_id: aws_default
    conn_type: aws
    login: <你的AK>
    password: <你的SK>
    extra: '{"region_name": "cn-north-1"}'

• 敏感连接（凭证从Secret读取）配置示例：

connections:
  - conn_id: postgres_default
    conn_type: postgres
    host: postgres.prod.svc.cluster.local
    port: 5432
    login: airflow
    schema: airflow
    password: ""
    secretName: airflow-db-credentials
    secretKey: postgres_password

部署完成后所有连接会出现在Web UI的Admin > Connections页面，可直接在DAG中通过conn_id调用。

补充说明两种临时方案的局限：

• 以AIRFLOW_VAR_<variable_name>格式注入的环境变量属于运行时动态加载的变量，不会持久化到元数据库，因此不会在UI展示，仅适合不需要在UI统一管理的环境级临时变量；
• 手动执行bash脚本从JSON导入的方式属于一次性操作，后续配置变更、版本回滚时无法自动同步，缺少声明式配置的生命周期管理能力，不推荐生产环境使用。

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