Airflow KubernetesExecutor环境变量与Secret未传递至任务Pod问题咨询

结论 #

Airflow 2.x（包括2.9.2版本）已经废弃了通过AIRFLOW__KUBERNETES_ENVIRONMENT_VARIABLES__和AIRFLOW__KUBERNETES_SECRETS__前缀自动注入环境变量/Secret到任务Pod的功能，这不是你的配置错误，而是官方主动移除的旧特性。

原因说明 #

Airflow从2.3版本开始重构了KubernetesExecutor的Pod生成逻辑，放弃了隐式的前缀注入机制，转而采用更透明、可控的显式配置方式：

• 旧的前缀注入方式容易导致配置冲突、隐式依赖难以排查；
• 官方推荐通过Pod模板（Pod Template）或Helm Chart的专属配置项来定义任务Pod的环境变量和Secret，配置逻辑更清晰。

你查看pod_generator.py发现仅生成单个环境变量，正是因为代码中已经移除了处理这类前缀配置的逻辑，旧文档下架也佐证了该特性的废弃状态。

正确配置方式 #

1. 环境变量传递

可以通过以下两种方式配置：

• Helm Chart直接定义：在values.yaml中使用workers.extraEnv字段：

  workers:
    extraEnv:
      - name: MY_CUSTOM_VAR
        value: "custom_value"
      - name: ANOTHER_VAR
        valueFrom:
          configMapKeyRef:
            name: my-configmap
            key: var_key
  

• 自定义Pod模板：在Pod模板的spec.containers[].env中直接添加环境变量：

  apiVersion: v1
  kind: Pod
  spec:
    containers:
      - name: airflow-task
        env:
          - name: MY_CUSTOM_VAR
            value: "custom_value"
  

2. Secret传递

同样支持两种配置方式：

• Helm Chart挂载Secret：在values.yaml中使用workers.extraSecretMounts：

  workers:
    extraSecretMounts:
      - name: db-secret
        secretName: my-db-secret
        mountPath: /etc/secrets/db
        readOnly: true
  

• Pod模板引用Secret键值：在Pod模板的env中通过valueFrom.secretKeyRef引用：

  apiVersion: v1
  kind: Pod
  spec:
    containers:
      - name: airflow-task
        env:
          - name: DB_PASSWORD
            valueFrom:
              secretKeyRef:
                name: my-db-secret
                key: password
  

迁移建议 #

如果之前依赖旧的前缀配置方式，需要将对应的环境变量和Secret迁移到上述显式配置中，这是Airflow 2.x版本的标准化配置路径，能更好地适配后续版本的迭代。

内容的提问来源于stack exchange，提问作者J.C Guzman