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应用程序部署作业的状态。将应用程序部署到设备的典型工作流是:
- 用户通过一个用户界面选择一个已发布的应用程序版本。
- 关联的条款和条件文档将呈现给用户。
- 用户必须接受条款和条件。您可以使用Edge App Deployment Service存储和查询这些信息。
- 在接受条款和条件后,用户可以通过用界面触发Edge应用程序部署。
- Edge App Deployment Service会自动验证用户的设备是否属于正确的设备类型,并将作业发送到该设备。
- 设备接收作业。
- 设备在向Edge App Deployment Service发送状态消息的同时执行应用程序安装。与此同时,您可以通过用户界面更新或取消作业。
- Edge App Deployment Service接收作业的结果并在设备上记录实际应用程序的版本信息。
状态机¶
Firmware Deployment Service使用一个状态机去追踪Edge应用程序部署过程。详细信息请参考基础知识。
应用程序移除¶
Edge App Deployment Service允许用户从设备上移除应用程序并追踪应用程序移除作业的状态。将应用程序部署到设备的典型工作流是:
- 用户通过一个用界面触发应用程序移除作业。
- Edge App Deployment Service将作业发送到设备。
- 设备接收作业。
- 设备在向Edge App Deployment Service发送状态消息的同时执行应用程序移除。与此同时,您可以通过用户界面更新或取消作业。
- 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记录,因此用户在之后下载相同的软件到其他设备时就不会被再次询问。