分享|EdgeX 配置之环境变量 Environment Variables
以 v3.1 版本为例,针对常用的配置进行简单说明,并且,针对一些实际应用进行分析。

EdgeX Foundry (以下统一简称:EdgeX)环境变量贯穿于整个项目所有的微服务,所有的服务都有自己的配置文件,文件名为:configuration.yaml

本文,以 v3.1 版本为例,针对常用的配置进行简单说明,并且,针对一些实际应用进行分析。

EdgeX 官方文档

EdgeX 微服务环境变量

所有 EdgeX 服务都使用三种类型的环境变量。它们是标准的、命令行覆盖和配置覆盖。

标准环境变量(Standard)

所有标准环境变量都有 EDGEX_ 前缀

EDGEX_SECURITY_SECRET_STORE

顾名思义,就是开启 EdgeX 全局是否为安全模式。默认为 true 开启安全模式。

  • Docker 配置文件

    environment:
        EDGEX_SECURITY_SECRET_STORE: "false"
    
  • Linux 系统环境变量(仅在本地运行 EdgeX 相关二进制程序时生效)

    export EDGEX_SECURITY_SECRET_STORE=false
    

其他

配置方法一样。

  • EDGEX_DISABLE_JWT_VALIDATION:禁用入站 REST API 请求的授权 HTTP 头部验证。
  • EDGEX_STARTUP_DURATION:引导启动所允许的总持续时间,默认为 120 秒。
  • EDGEX_STARTUP_INTERVAL:引导失败重试间隔时间,默认为 1 秒。

值得注意的其他标准环境变量(Notable Other Standard)

介绍并非所有服务都通用的其他标准环境变量。

环境变量

  • EDGEX_ADD_SECRETSTORE_TOKENS:Secret Store 设置服务要为其生成 SecretStore 令牌的附加服务。
  • EDGEX_ADD_KNOWN_SECRETS:秘密存储设置服务哪些附加服务需要将哪些已知秘密添加到其秘密存储中。
  • EDGEX_ADD_REGISTRY_ACL_ROLES: Consul 服务入口点脚本哪些附加服务需要创建 ACL 角色。
  • EDGEX_ADD_PROXY_ROUTE:代理设置服务需要为附加服务添加哪些附加路由。
  • EDGEX_IKM_HOOK:秘密存储设置服务实现 IKM 接口的可执行文件的路径。

命令行覆盖(Command-line Overrides)

介绍大多数服务常见的命令行覆盖。这些覆盖允许在每次服务启动时覆盖特定命令行标志的使用。

  • EDGEX_CONFIG_DIR:配置文件所在目录。
  • EDGEX_CONFIG_FILE:全局配置文件所在位置。
  • EDGEX_CONFIG_PROVIDER:是否覆盖配置提供程序。
  • EDGEX_COMMON_CONFIG:公共配置文件所在位置。
  • EDGEX_PROFILE:profile 文件所在位置。
  • EDGEX_USE_REGISTRY:是否使用 registry
  • EDGEX_REMOTE_SERVICE_HOSTS:远程 Service 主机。

服务配置覆盖

服务的 configuration.yaml 文件中的任何配置设置都可以被环境变量覆盖。环境变量名称具有以下格式:

<SECTION-NAME>_<KEY-NAME>
<SECTION-NAME>_<SUB-SECTION-NAME>_<KEY-NAME>

对应如下例子:

替换 YAML 文件中的环境变量

Service configuration YAMLEnvironment variable说明
Writable:
 LogLevel: "INFO"
WRITABLE_LOGLEVEL=DEBUGINFO -> DEBUG
Service:
 Host:"localhost"
SERVICE_HOST=edgex-core-datalocalhost -> edgex-core-data

注意

私有配置覆盖仅适用于服务私有配置文件中存在的配置设置。

关于我们

亿琪软件

上海亿琪软件有限公司成立于 2016 年,专注于 5G 通信、AI 人工智能、边缘计算和大数据网络安全多项技术领域,致力于物联网领域前沿技术的创新,为用户提供全方位、智能化和安全的物联网解决方案。

2023 年,公司发布“YiFUSION |工业边缘智能融合一体机”产品,为工业客户提供一整套的边缘计算+AI 能力:高性能数据采集、多类型数据融合、AI 算法集成、云端业务对接。在边缘网关的基础上,集成了 IoT 平台的边缘协同能力、本地 Web SCADA 和 HMI 功能、本地数据存储、边缘 AI 视频分析、行业应用集成等。

2022 年,公司推出 “YiCLOUD |亿琪云”一站式物联网应用解决方案。公司的业务涵盖了智慧城市、智慧农业、智能工厂和智慧园区等多个领域,公司软硬件产品和解决方案获得华为技术认证,得到中国移动 OCP 认证,公司还是边缘计算产业联盟 ECC 成员。

关注我们

yiqisoftedgexfoundry

联系我们--商业服务

  • 网站:http://yiqisoft.cn
  • 邮件:support@yiqisoft.cn
  • 电话:021-68863086
  • 手机:186-1666-9123
开源|EdgeX 边缘计算之安全组件 Security
使用 JWT(Json Web Token)作为资源访问控制,利于各种系统的对接和二次开发。