Docker 应用程序管理器

• 2.0.x

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

• Linux

• Windows

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

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

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

  • Amazon Elastic Container Registry (Amazon ECR)

  • 公共 Docker Hub Hu

  • 公共 Docker 可信注册表

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

  • Amazon 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 容器组件的系统用户必须具有 root 或管理员权限，或者您必须将 Docker 配置为以非 root 用户或非管理员用户身份运行该组件。

  • 在 Linux 设备上，您可以将用户添加到docker要呼叫的群组docker命令sudo.

  • 在 Windows 设备上，您可以将用户添加到docker-users要呼叫的群组docker没有管理员权限的命令。

  Linux or Unix

  添加ggc_user，或者你用来运行 Docker 容器组件的非 root 用户，dockergroup，运行以下命令。

  sudo usermod -aG docker ggc_user

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

  Windows Command Prompt (CMD)

  添加ggc_user，或者你用来运行 Docker 容器组件的用户，docker-usersgroup，以管理员身份运行以下命令。

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  添加ggc_user，或者你用来运行 Docker 容器组件的用户，docker-usersgroup，以管理员身份运行以下命令。

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• 如果您配置Amazon IoT GreengrassCore Passenger Passenger，你必须配置 Docker 使用相同的代理服务器.

• 如果您的 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"
      }
    ]
  }

• 运行 Docker 容器