如何为 Azure 认知服务中的现有 docker 容器创建 IoT Edge 模块？答案

【问题标题】：How do I create an IoT Edge Module for an existing docker container from Azure Cognitive Services?如何为 Azure 认知服务中的现有 docker 容器创建 IoT Edge 模块？
【发布时间】：2020-05-30 12:42:08
【问题描述】：

我目前拥有 Azure Cognitive Services for Speech-To-Text 作为 docker 容器的公共预览访问权限。这允许容器在 IoT Edge 设备上运行，而不是访问云来执行此服务。此公开预览版附带installation instructions，表明我可以下载其中一个容器的现有 docker 映像并使用“docker run”从 CLI 运行它。

但我不想在我的 IoT Edge 设备上手动运行 docker 容器。我希望它自动部署到我的 IoT Edge 设备并自动开始运行。为了做到这一点，我认为它需要作为物联网边缘模块存在。我的理解正确吗？

所以我的问题更像是一个指导性问题。我是否需要创建自己的 IoT Edge 模块来利用此 ACS docker 容器，或者是否有其他方法可以自动将其部署到我的 IoT Edge 设备并让它自动开始运行？

我无法在线找到将现有 docker 容器部署到 IoT Edge 设备的任何文档或示例。任何指导将不胜感激！

【问题讨论】：

标签： speech-to-text azure-cognitive-services azure-iot-edge

【解决方案1】：

好的，经过大量挖掘，我找到了解决方案。无论您做什么，都不要在网上搜索“从 docker 容器创建 iot 模块”或类似的任何完全有意义的内容。相反，我必须在 docker run 上搜索 Azure 认知服务接受 EULA 的特定内容（即，我必须搜索“iot edge module docker \"eula\"”）。请注意 eula 周围的引号，以确保它在搜索结果中。我遇到了this article。

使用本文的指导，我将详细重复我在此处所做的操作，以防链接失效。

在 VS Code 中，创建新的 IoT Edge 解决方案
在您的解决方案中，添加新的 IoT Edge 模块一种。当提示输入要创建的模块类型时，选择“选择现有模块（输入完整 URL）”
如果您查看您的deployment.template.json 文件，您现在会看到“registryCredentials”的一个新元素已添加到您的edgeAgent 详细信息中。相应地填写地址、用户名和密码。
如果您尚未这样做，请在线创建认知服务资源以获取端点 URL 和 ApiKey。记下这些值。

在 deployment.template.json 文件中，在新模块的配置设置下，添加以下内容。

"settings": {
  "image": "containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest",
  "createOptions": 
  {                       
    "Cmd": [
        "Eula=accept",
      "Billing={enter-your-EndpointURL}",
        "ApiKey={enter-your-ApiKey}"
    ],
    "HostConfig": {
      "PortBindings": {
      "5000/tcp": [
      {
        "HostPort": "5000"
      }
      ] 
      }
      }
    }

这相当于从命令行运行“docker run”，参数如下：

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \ containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text \ Eula=accept \ Billing={BILLING_ENDPOINT_URI} \ ApiKey={BILLING_KEY}

现在“构建并推送您的 IoT Edge 解决方案”，然后是“为单个设备创建部署”。在您的目标 IoT Edge 设备上，您现在应该会看到通过 CLI“iotedge list”安装并运行的模块。

更新：2020/05/01

在向 MSFT 提交更好文档的请求后，他们更新了他们的文档站点，以包含有关如何修改 deployment.template.json 文件以匹配 docker 命令行参数的信息：https://docs.microsoft.com/en-us/azure/iot-edge/how-to-use-create-options

【讨论】：

【解决方案2】：

这是上面链接中的精华（https://docs.microsoft.com/en-us/azure/iot-edge/how-to-use-create-options）：

一旦你的模块按照你想要的方式工作（即：在 docker 容器），运行 docker inspect 。这个命令以 JSON 格式输出模块详细信息。找到参数你配置好了，然后复制 JSON。

【讨论】：