EdgeX Foundry App Service Configurable (ARM64) 镜像文档

镜像概述

主要用途

本镜像为 ARM64架构 的可配置应用服务，是EdgeX Foundry生态系统的核心组件之一。基于App Functions SDK构建，提供无需编译即可配置的数据处理管道，用于处理流经EdgeX的设备数据，实现边缘设备与IT系统间的高效数据交互。

核心功能与特性

• 基于App Functions SDK：集成EdgeX Foundry App Functions SDK，支持通过配置文件定义数据处理流程，无需编写和编译独立服务。
• 可配置管道函数：提供丰富的内置数据处理函数（如过滤、转换、聚合等），支持通过配置文件组合使用，快速构建自定义数据处理逻辑。
• 动态配置支持：支持运行时调整配置，无需重启服务即可更新数据处理流程。
• ARM64架构优化：专为ARM64架构设计，适配边缘计算场景下的嵌入式设备和边缘网关。
• 多版本兼容：支持EdgeX Foundry多个版本系列（如Napa、Minnesota、Levski等），满足不同部署环境需求。

支持的标签与版本

使用场景与适用范围

• 物联网边缘数据处理：适用于需要对边缘设备产生的原始数据进行实时过滤、转换、聚合的场景（如工业传感器数据清洗、环境监测数据格式化）。
• 快速原型验证：开发者可通过配置文件快速定义数据处理逻辑，无需编写代码，加速边缘计算应用原型开发。
• ARM64边缘设备部署：专为ARM64架构优化，适用于树莓派、边缘网关等低功耗嵌入式设备。

使用方法与配置说明

前提条件

• 已安装Docker（支持ARM64架构）。
• 已部署EdgeX Foundry基础服务（如Core Data、Metadata、Registry等），并确保网络互通。

Docker 运行命令示例

通过docker run启动服务，挂载自定义配置文件并指定EdgeX网络：

bash
docker run -d \
  --name edgex-app-service \
  --network edgex-network \  # 接入EdgeX服务网络
  -v /path/to/custom/config:/app/config \  # 挂载自定义配置文件目录
  -e EDGEX_PROFILE=custom-profile \  # 指定配置文件名称（无需.yml后缀）
  -e EDGEX_REGISTRY_HOST=service-registry \  # 服务注册地址（如Consul）
  edgexfoundry/app-service-configurable-arm64:3.1.0  # 使用Napa版本

Docker Compose 配置示例

在docker-compose.yml中集成服务：

yaml
version: '3.8'
services:
  app-service-configurable:
    image: edgexfoundry/app-service-configurable-arm64:3.1.0
    container_name: edgex-app-service
    networks:
      - edgex-network
    volumes:
      - ./app-config:/app/config  # 挂载本地配置目录
    environment:
      - EDGEX_PROFILE=my-pipeline  # 配置文件名称
      - EDGEX_SERVICE_KEY=app-service-1  # 服务唯一标识
      - EDGEX_CORE_DATA_HOST=core-data  # Core Data服务地址
    depends_on:
      - service-registry  # 依赖服务注册组件（如Consul）

networks:
  edgex-network:
    external: true  # 使用已创建的EdgeX网络

配置文件说明

核心配置文件（如custom-profile.yml）需定义数据处理管道，示例结构：

yaml
service:
  name: "app-service-configurable"
  port: 59700  # 服务端口

pipeline:
  functions:
    - name: "filterByDeviceName"  # 内置过滤函数
      parameters:
        deviceNames: ["sensor-01", "sensor-02"]  # 仅处理指定设备数据
    - name: "transformToJson"  # 数据格式转换函数
    - name: "exportToHttp"  # 数据导出函数
      parameters:
        url: "[***]"  # 目标HTTP服务地址

配置参数与环境变量

问题反馈与支持

• Issue提交：GitHub Issues
• 支持渠道：
  • EdgeX官网：edgexfoundry.org
  • 文档中心：docs.edgexfoundry.org
  • 社区Slack：edgexfoundry.***

许可证信息

本镜像包含的软件以Apache 2.0许可证授权（详见EdgeX许可证信息）。镜像可能包含其他开源软件（如Bash、基础系统库），其许可证需用户自行合规检查。镜像内Attribution.txt文件包含自动检测的第三方软件许可证信息。