Skip to content

Edge App Deployment Service

构想

此服务为激活Edge设备的Edge应用程序安装和移除作业提供一个接口。Edge设备负责轮询作业并执行所需的操作。

可扩展性

Edge App Deployment Service确保将遵循API规范中定义的合同条款，将返回指定的字段。但可能引入其他字段作为API向后兼容的扩展。

请确保您的客户可以很好地处理这些扩展。

信息

Edge App Deployment Service目前仅在Europe 1适用。

访问

要访问此服务，您需要具有Edge App Deployment Service角色和范围中列出的相应角色。

下载 URIs

在您下载安装作业中指定的URIs时，必须包含嵌入式凭证或引用公共资源。设备不使用MindSphere凭证直接访问URIs。

基础知识

应用程序部署

Edge App Deployment Service追踪Edge应用程序部署作业的状态。将应用程序部署到设备的典型工作流是：

  1. 用户通过一个用户界面选择一个已发布的应用程序版本。
  2. 关联的条款和条件文档将呈现给用户。
  3. 用户必须接受条款和条件。您可以使用Edge App Deployment Service存储和查询这些信息。
  4. 在接受条款和条件后，用户可以通过用界面触发Edge应用程序部署。
  5. Edge App Deployment Service会自动验证用户的设备是否属于正确的设备类型，并将作业发送到该设备。
  6. 设备接收作业。
  7. 设备在向Edge App Deployment Service发送状态消息的同时执行应用程序安装。与此同时，您可以通过用户界面更新或取消作业。
  8. Edge App Deployment Service接收作业的结果并在设备上记录实际应用程序的版本信息。

状态机

Firmware Deployment Service使用一个状态机去追踪Edge应用程序部署过程。详细信息请参考基础知识。

应用程序移除

Edge App Deployment Service允许用户从设备上移除应用程序并追踪应用程序移除作业的状态。将应用程序部署到设备的典型工作流是：

  1. 用户通过一个用界面触发应用程序移除作业。
  2. Edge App Deployment Service将作业发送到设备。
  3. 设备接收作业。
  4. 设备在向Edge App Deployment Service发送状态消息的同时执行应用程序移除。与此同时，您可以通过用户界面更新或取消作业。
  5. Edge App Deployment Service接收作业的结果并在设备上更新可用应用程序的信息。

状态机

Firmware Deployment Service使用一个状态机去追踪Edge应用程序移除过程。详细信息请参考基础知识。

定期轮询

设备需要使用以下端点定期轮询此服务中的开放作业：

GET /api/edgeappdeployment/v3/devices/{deviceId}/installation/jobs
GET /api/edgeappdeployment/v3/devices/{deviceId}/removal/jobs

功能

Edge App Deployment Service公开了实现以下任务的API：

  • 部署应用程序到设备上和从设备上移除应用程序
  • 管理Edge应用程序部署作业
  • 记录用户接受条款及条件的情况

限制

  • 超过90天的Edge应用程序部署和移除作业将自动清除。

受控内容

禁止上传、下载和发布受控内容到MindSphere。用户应对使用Edge Services发布的文件内容负责。

示例场景

向MindSphere上传数据的传感器生产商,希望定期向客户提供新版本的设备软件。他们为MindSphere开发了一个用户界面，此界面使用Edge App Deployment Service将软件上传到设备上。在部署之前，用户界面要求用户接受软件的条款和条件。用户的接受通过Edge App Deployment Service记录，因此用户在之后下载相同的软件到其他设备时就不会被再次询问。

相关链接

还有问题?

向社区提问

除非另行声明，该网站内容遵循MindSphere开发许可协议.

Last update: July 11, 2019