Docker 应用程序管理器

• 2.0.x

此组件可以安装在运行以下操作系统的核心设备上：

• Linux

• Windows

• Greengrass 核心设备上安装的 Docker Engine 1.9.1 或更高版本。版本 20.10 是经验证可与 Amazon IoT Greengrass 核心软件配合使用的最新版本。在部署运行 Docker 容器的组件之前，必须直接在核心设备上安装 Docker。

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

• 存储在以下支持的映像源之一中的 Docker 映像：

  • Amazon 弹性容器注册表 (AmazonECR) 中的公有和私有图像存储库

  • 公共 Docker Hub 存储库

  • 公共 Docker 可信注册表

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

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

  • Amazon 公开ECR图片：docker:public.ecr.aws/repository/image[:tag|@digest]

  • Docker Hub 公共映像：docker:name[:tag|@digest]

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

  注意

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

• 运行 Docker 容器组件的系统用户必须具有根或管理员权限，或者您必须将 Docker 配置为以非根用户或非管理员用户身份运行。

  • 在 Linux 设备上，您可向 docker 组中添加一个用户以调用 docker 命令，无需 sudo。

  • 在 Windows 设备上，您可将用户添加到 docker-users 组中以调用 docker 命令，无需管理员权限。

  Linux or Unix

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker 组中，请运行以下命令：

  sudo usermod -aG docker ggc_user

  有关更多信息，请参阅以非根用户身份管理 Docker。

  Windows Command Prompt (CMD)

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker-users 组中，请以管理员身份运行以下命令：

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker-users 组中，请以管理员身份运行以下命令：

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• 如果您将 Amazon IoT Greengrass Core 软件配置为使用网络代理，则必须将 Docker 配置为使用相同的代理服务器。

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

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

• 支持 docker 应用程序管理器组件在中运行。VPC要在中部署此组件VPC，需要满足以下条件。

  • Docker 应用管理器组件必须具备下载映像的连接功能。例如，如果您使用ECR，则必须连接到以下端点。

    • *.dkr.ecr.region.amazonaws.com（VPC端点com.amazonaws.region.ecr.dkr）

    • api.ecr.region.amazonaws.com（VPC端点com.amazonaws.region.ecr.api）

• 运行 Docker 容器