agilelabs-fx-docs main features/env-vars.md

环境变量速查

变量 说明
AG_APP_DATA 指定 app_data 目录（默认运行目录下的 app_data）。若在 Kubernetes/容器中并设置 DOTNET_RUNNING_IN_CONTAINER=true，会自动切换到根目录。
LOG_MINI_LEVEL 覆盖 LoggingLevelControl 的最小日志级别，示例：LOG_MINI_LEVEL=Warning。
LOG_FILE 设为 true 时强制写入文件日志（即使在非 Windows 环境）。
DISABLE_JOBS true 时禁用 services.AddHangfireServer()，适合多实例部署时控制 Job 节点。
DOTNET_RUNNING_IN_CONTAINER 由运行时提供，用于判断是否在容器中。
KUBERNETES_SERVICE_HOST Kubernetes 注入的 Service Host，AppData 会通过该变量或挂载目录判断。

应用场景

  • 统一日志目录：在容器部署中设置 AG_APP_DATA=/var/app_data，避免写到只读文件系统。
  • 灰度/压测：通过环境变量临时调整日志级别或禁用后台任务。
  • 多集群 Job 策略：结合 DISABLE_JOBS 与部署标签，控制哪个实例处理 Hangfire 队列。

更多运维内容参见 诊断工具 与 日志策略。