lfedge/edge-home-orchestration-go

Edge Orchestration（边缘编排）

镜像概述

Edge Orchestration项目旨在实现支持Docker容器的设备间分布式计算。家庭边缘网络中的所有设备（如电视、冰箱、洗衣机等）被视为家庭边缘设备，其中具备充足硬件资源且能运行容器化应用的设备称为家庭边缘节点。家庭边缘编排器软件负责管理网络内设备的任务（称为家庭边缘应用），并根据设备性能评分分配任务到最优节点执行。若未找到评分更高的节点，则在本地执行应用。

核心功能

1. 设备扫描与性能评分：持续扫描家庭边缘网络，生成设备列表并计算性能评分，作为任务分配的依据。
2. 容器化应用调度：根据性能评分将容器化应用分配到最优家庭边缘节点执行。
3. 分布式应用支持：支持由多个交互的Docker容器实例组成的分布式应用。
4. REST API交互：通过REST API接收服务执行请求，并返回执行状态。

使用场景

• 家庭智能设备间的协同计算任务（如媒体处理、数据分析）。
• 边缘应用的本地部署与调度，减少云端依赖，提升响应速度。
• 多设备资源的高效利用，将任务分配到性能最优的节点。

配置说明

前提条件

1. 至少一台支持的设备（作为家庭边缘设备，建议多台）。
2. 所有家庭边缘设备需处于同一网络。
3. 所有设备的/var/edge-orchestration/user/orchestration_userID.txt文件中需包含相同的认证密钥。

部署步骤

1. 安装Docker CE

需安装17.09或更高版本的Docker CE，安装方法参考https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/。

2. 拉取镜像

从Docker Hub拉取最新镜像：

shell
docker pull docker.xuanyuan.run/lfedge/edge-home-orchestration-go:latest

3. 运行容器

shell
docker run -it -d --privileged --network="host" --name edge-orchestration \
  -v /var/edge-orchestration/:/var/edge-orchestration/:rw \
  -v /var/run/docker.sock:/var/run/docker.sock:rw \
  -v /proc/:/process/:ro \
  docker.xuanyuan.run/lfedge/edge-home-orchestration-go:latest

4. 发送服务执行请求

通过REST API发送请求（替换IP为实际主机IP）： 请求方式：POST
URL：IP:56001/api/v1/orchestration/services
请求体：

json
{
  "ServiceName": "hello-world",
  "ServiceInfo": [
    {
      "ExecutionType": "container",
      "ExecCmd": [
        "docker",
        "run",
        "-v", "/var/run:/var/run:rw",
        "hello-world"
      ]
    }
  ],
  "StatusCallbackURI": "http://localhost:8888/api/v1/services/notification"
}

Curl示例：

shell
curl -X POST "IP:56001/api/v1/orchestration/services" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{ \"ServiceName\": \"hello-world\", \"ServiceInfo\": [{ \"ExecutionType\": \"container\", \"ExecCmd\": [ \"docker\", \"run\", \"-v\", \"/var/run:/var/run:rw\", \"hello-world\"]}], \"StatusCallbackURI\": \"http://localhost:8888/api/v1/services/notification\"}"

查看执行日志

shell
docker logs -f edge-orchestration

不支持的Docker Run选项

以下Docker Run选项暂不支持：
--detach, -d, --detach-keys, --disable-content-trust, --sig-proxy, --name, --platform, --help, --cpu-percent（仅Windows）, --cpu-count（仅Windows）, --io-maxbandwidth（仅Windows）, --io-maxiops（仅Windows）。

更多信息

• 主页：https://www.lfedge.org/projects/homeedge
• GitHub：https://github.com/lf-edge/edge-home-orchestration-go
• Wiki：https://wiki.lfedge.org/display/HOME/Home+Edge+Project

许可证

Edge Orchestration源代码基于https://opensource.org/licenses/Apache-2.0开源许可分发。