edgexfoundry/device-virtual

EdgeX Foundry 虚拟设备服务镜像文档

镜像概述

关于EdgeX Foundry

EdgeX Foundry是一个由Linux基金会托管的 vendor-neutral 开源项目，旨在构建物联网边缘计算的通用开放框架。该项目的核心是一个硬件和操作系统无关的互操作性框架，通过参考软件平台实现即插即用组件生态系统，从而统一市场并加速IoT解决方案的部署。

简而言之，EdgeX是边缘中间件，连接物理传感执行设备与信息技术(IT)系统。官方文档请访问docs.edgexfoundry.org。

!EdgeX Logo

镜像用途

本镜像包含EdgeX Foundry的虚拟设备服务，用于模拟各种类型的设备，向核心数据微服务生成事件和读数，并允许用户通过命令控制微服务发送命令和获取响应。

源代码地址：https://github.com/edgexfoundry/device-virtual-go

核心功能与特性

• 模拟多种类型的设备行为和数据生成
• 生成事件和读数并发送至EdgeX核心数据服务
• 支持通过命令控制微服务接收命令并返回响应
• 无需真实物理设备即可进行功能测试和性能评估
• 与EdgeX Foundry生态系统无缝集成

使用场景与适用范围

主要使用场景

• 功能测试：在没有真实设备的情况下验证EdgeX Foundry系统功能
• 性能测试：模拟大量设备和数据流量以测试系统性能
• 开发环境：为应用开发提供稳定的设备数据来源
• 演示环境：展示EdgeX Foundry功能而无需配置物理设备
• 培训环境：学习EdgeX Foundry设备服务交互

适用范围

• EdgeX Foundry生态系统开发者
• IoT边缘计算解决方案测试人员
• 需要模拟设备数据的应用开发者
• 学习和评估EdgeX Foundry的技术人员

快速参考信息

维护与支持

• 维护者：EdgeX Foundry（Linux Foundation项目）
• 获取帮助：
  • EdgeX网站
  • EdgeX文档
  • EdgeX Slack
  • EdgeX项目Wiki
• 问题反馈：https://github.com/edgexfoundry/device-virtual-go/issues
• 支持架构：intel/amd64

支持的标签与Dockerfile链接

注：Jakarta版本是长期支持(LTS)版本，详情请参见EdgeX LTS说明

使用方法与配置说明

Docker Run命令示例

bash
docker run -d \
  --name device-virtual \
  --network edgex-network \
  -p 59900:59900 \
  -e edgex_profile=docker \
  -e edgex_service_host=device-virtual \
  edgexfoundry/device-virtual:3.1.0

Docker Compose配置示例

yaml
version: '3.8'

services:
  device-virtual:
    image: edgexfoundry/device-virtual:3.1.0
    container_name: edgex-device-virtual
    hostname: edgex-device-virtual
    networks:
      - edgex-network
    ports:
      - "59900:59900"
    environment:
      - edgex_profile=docker
      - edgex_service_host=edgex-device-virtual
      - WRITABLE_LOGLEVEL=INFO
    depends_on:
      - core-data
      - core-metadata
      - core-command

networks:
  edgex-network:
    driver: bridge

核心配置参数

许可证信息

本镜像包含的软件许可信息请参见Apache 2.0许可。

与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版中的Bash等），这些软件可能具有其他许可。使用预构建镜像时，用户有责任确保对镜像的任何使用都符合其中包含的所有软件的相关许可。

镜像中包含的附加许可信息可在Attribution.txt文件中找到，该文件从相关源代码仓库复制而来。