Docker 应用程序管理器 - Amazon IoT Greengrass
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Docker 应用程序管理器

Docker 应用程序管理器组件 (aws.greengrass.DockerApplicationManager) 启用Amazon IoT Greengrass从公共映像注册表下载 Docker 映像。它还启用Amazon IoT Greengrass管理凭据,以便从 Amazon Elastic Container Registry (Amazon ECR) 中的私有存储库下载映像的凭据。

当您开发运行 Docker 容器的自定义组件时,请将 Docker 应用程序管理器作为依赖项包含,以下载在组件中指定为工件的 Docker 映像。有关更多信息,请参阅 运行 Docker 容器

Versions

此组件具有以下版本:

  • 2.x

Type

此组件是一个通用组件 (aws.greengrass.generic)。这些区域有:Greengrass 核心运行组件的生命周期脚本。

有关更多信息,请参阅 组件类型

Requirements

要部署组件,必须满足组件及其dependencies。此组件具有以下要求:

  • Docker 引擎1.9.1 或更高版本的 Greengrass 核心设备上安装并运行。版本 20.10 是经验证可与连接器一起使用的最新版本。在部署运行 Docker 容器的自定义组件之前,您必须直接在核心设备上安装 Docker。

  • 在部署此组件之前,Docker 守护进程在核心设备上启动并运行。

  • 存储在以下受支持的图像源之一中的 Docker 图像:

    • Amazon Elastic Container Registry (Amazon ECR) 中的公共和私有映像存储库

    • 公共 Docker Hub 存储库

    • 公共码头可信注册表

  • Docker 图像作为工件包含在您的自定义 Docker 容器组件中。使用以下 URI 格式指定您的 Docker 映像:

    • 亚马逊私人 ECR 图片:docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

    • 亚马逊公共 ECR 图片:docker:public.ecr.aws/repository/image[:tag|@digest]

    • 公共码头中心映像:docker:name[:tag|@digest]

    有关更多信息,请参阅 运行 Docker 容器

    注意

    如果未在图像的工件 URI 中指定图像标记或图像摘要,则 Docker 应用程序管理器会在部署自定义 Docker 容器组件时提取该映像的最新可用版本。为确保所有核心设备运行相同版本的映像,我们建议您在工件 URI 中包含图像标记或图像摘要。

  • 根用户权限或 Docker 配置为您将其作为非根用户。将用户添加到docker组允许您调用docker命令中的sudo。添加ggc_user,或用于运行Amazon IoT Greengrass,添加到docker组,运行sudo usermod -aG docker user-name

  • Docker 配置为使用代理服务器。只有在运行Amazon IoT Greengrass后面的网络代理。

  • 如果 Docker 映像存储在 Amazon ECR 私有注册表中,则必须将令牌交换服务组件作为依赖项包含在 Docker 容器组件中。另外,Greengrass 设备角色必须允许ecr:GetAuthorizationTokenecr:BatchGetImage, 和ecr:GetDownloadUrlForLayer操作,如以下 IAM 策略示例所示。

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "ecr:GetAuthorizationToken", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ], "Resource": [ "*" ], "Effect": "Allow" } ] }

Dependencies

部署组件时,Amazon IoT Greengrass还部署其依赖关系的兼容版本。您必须满足组件及其所有依赖关系的要求才能成功部署组件。本部分列出了已发布的版本以及定义每个依赖关系的组件版本的语义版本约束。您也可以在组件各个版本中查看组件的依赖关系。Amazon IoT Greengrass控制台。在组件详细信息页面上,查找依赖项列表。

下表列出了此组件 2.0.x 版本的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核心 ~ 2.1.0 软性

有关组件依赖项的更多信息,请参阅。组件配方参考

Changelog

下表描述了组件各个版本中的更改。

版本

更改

2.0.0

初始版本。

另请参阅