Gerenciador de aplicativos Docker

• 2.0.x

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

• Linux

• Windows

• Docker Engine 1.9.1 ou posterior instalado no dispositivo principal do Greengrass. A versão 20.10 é a versão mais recente verificada para funcionar com o software AWS IoT Greengrass Core. Você deve instalar o Docker diretamente no dispositivo principal antes de implantar componentes que executam contêineres do Docker.

• O daemon do Docker foi iniciado e executado no dispositivo principal antes de você implantar esse componente.

• Imagens do Docker armazenadas em uma das seguintes fontes de imagem compatíveis:

  • Repositórios de imagens públicos e privados no Amazon Elastic Container Registry (Amazon ECR)

  • Repositório público do Docker Hub

  • Registro confiável do Public Docker

• Imagens do Docker incluídas como artefatos em seus componentes personalizados do contêiner Docker. Use os seguintes formatos de URI para especificar suas imagens do Docker:

  • Imagem privada do Amazon ECR: docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

  • Imagem pública do Amazon ECR: docker:public.ecr.aws/repository/image[:tag|@digest]

  • Imagem pública do Docker Hub: docker:name[:tag|@digest]

  Para ter mais informações, consulte Execute um contêiner Docker.

  nota

  Se você não especificar a tag da imagem ou o resumo da imagem no URI do artefato de uma imagem, o gerenciador de aplicativos Docker extrairá a versão mais recente disponível dessa imagem quando você implanta seu componente de contêiner personalizado do Docker. Para garantir que todos os seus dispositivos principais executem a mesma versão de uma imagem, recomendamos que você inclua a tag da imagem ou o resumo da imagem no URI do artefato.

• O usuário do sistema que executa um componente de contêiner do Docker deve ter permissões de raiz ou administrador, ou você deve configurar o Docker para executá-lo como usuário não raiz ou não administrador.

  • Em dispositivos Linux, você pode adicionar um usuário ao docker grupo para chamar docker comandos semsudo.

  • Em dispositivos Windows, você pode adicionar um usuário ao docker-users grupo para chamar docker comandos sem privilégios de administrador.

  Linux or Unix

  Para adicionar ggc_user ou o usuário não root que você usa para executar componentes de contêiner do Docker ao docker grupo, execute o comando a seguir.

  sudo usermod -aG docker ggc_user

  Para obter mais informações, consulte Gerenciar o Docker como usuário não root.

  Windows Command Prompt (CMD)

  Para adicionar ggc_user ou o usuário que você usa para executar componentes de contêiner do Docker ao docker-users grupo, execute o comando a seguir como administrador.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Para adicionar ggc_user ou o usuário que você usa para executar componentes de contêiner do Docker ao docker-users grupo, execute o comando a seguir como administrador.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Se você configurar o software AWS IoT Greengrass Core para usar um proxy de rede, deverá configurar o Docker para usar o mesmo servidor proxy.

• Se suas imagens do Docker estiverem armazenadas em um registro privado do Amazon ECR, você deverá incluir o componente do serviço de troca de tokens como uma dependência no componente de contêiner do Docker. Além disso, a função de dispositivo do Greengrass deve permitir as ecr:GetDownloadUrlForLayer açõesecr:GetAuthorizationToken,ecr:BatchGetImage, e, conforme mostrado no exemplo de política do IAM a seguir.

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

• O componente docker application manager tem suporte para execução em uma VPC. Para implantar esse componente em uma VPC, é necessário o seguinte.

  • O componente docker application manager deve ter conectividade para baixar imagens. Por exemplo, se você usa o ECR, deve ter conectividade com os seguintes endpoints.

    • *.dkr.ecr.region.amazonaws.com(VPC endpoint) com.amazonaws.region.ecr.dkr

    • api.ecr.region.amazonaws.com(VPC endpoint) com.amazonaws.region.ecr.api

• Execute um contêiner Docker