本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Docker 应用程序管理器
Docker 应用程序管理器组件 (aws.greengrass.DockerApplicationManager
) 启用Amazon IoT Greengrass从公共映像注册表下载 Docker 映像。它还启用Amazon IoT Greengrass管理凭据,以便从 Amazon Elastic Container Registry (Amazon ECR) 中的私有存储库下载映像。
当您开发运行 Docker 容器的自定义组件时,请将 Docker 应用程序管理器作为依赖项包含,以下载在组件中指定为工件的 Docker 映像。有关更多信息,请参阅运行 Docker 容器。
Versions
此组件具有以下版本:
-
2.0.x
Type
此组件是一个通用组件 (aws.greengrass.generic
)。这些区域有:Greengrass 核心运行组件的生命周期脚本。
有关更多信息,请参阅组件类型。
Requirements
此组件有以下要求:
-
Docker 引擎
在 Greengrass 核心设备上安装并运行 1.9.1 或更高版本。版本 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 配置为您将其作为非 root 用户
. 将用户添加到 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:GetAuthorizationToken
、ecr: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控制台
有关组件依赖项的更多信息,请参阅。组件配方参考.
Configuration
此组件没有任何配置参数。
Changelog
下表介绍每一版的中的更改。
Version |
更改 |
---|---|
2.0.3 |
已更新适用于 Greengrass 原核 2.4.0 版发行。 |
2.0.2 |
已更新适用于 Greengrass 原核 2.3.0 版发行。 |
2.0.1 |
已更新适用于 Greengrass 原核 2.2.0 版发行。 |
2.0.0 |
初始版本。 |