Gestor de aplicaciones Docker

• 2.0.x

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:

• Linux

• Windows

• Docker Engine 1.9.1 o posterior instalado en el dispositivo principal de Greengrass. Se ha comprobado que la versión 20.10 es la última versión que funciona con el software Core. AWS IoT Greengrass Debe instalar Docker directamente en el dispositivo principal antes de implementar los componentes que ejecutan contenedores de Docker.

• El daemon de Docker se inició y se ejecutó en el dispositivo principal antes de implementar este componente.

• Imágenes de Docker almacenadas en una de las siguientes fuentes de imágenes compatibles:

  • Repositorios de imágenes públicos y privados en Amazon Elastic Container Registry (Amazon ECR)

  • Repositorio público de Docker Hub

  • Registro público de confianza de Docker

• Las imágenes de Docker se incluyen como artefactos en sus componentes de contenedor Docker personalizados. Usa los siguientes formatos de URI para especificar tus imágenes de Docker:

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

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

  • Imagen pública de Docker Hub: docker:name[:tag|@digest]

  Para obtener más información, consulte Ejecute un contenedor Docker.

  nota

  Si no especificas la etiqueta de la imagen o el resumen de la imagen en el URI del artefacto de una imagen, el administrador de aplicaciones de Docker extrae la última versión disponible de esa imagen al implementar tu componente de contenedor de Docker personalizado. Para asegurarte de que todos tus dispositivos principales ejecuten la misma versión de una imagen, te recomendamos que incluyas la etiqueta o el resumen de la imagen en el URI del artefacto.

• El usuario del sistema que ejecute un componente contenedor de Docker debe tener permisos de raíz o administrador, o bien debe configurar Docker para que se ejecute como un usuario no de raíz o no administrador.

  • En los dispositivos Linux, puedes añadir un usuario al docker grupo sin sudo el cual ejecutar docker comandos.

  • En los dispositivos Windows, puede añadir un usuario al docker-users grupo para que invoque docker comandos sin privilegios de administrador.

  Linux or Unix

  Para añadir ggc_user al docker grupo el usuario no root que utiliza para ejecutar los componentes del contenedor de Docker, ejecute el siguiente comando.

  sudo usermod -aG docker ggc_user

  Para obtener más información, consulta Administrar Docker como usuario no root.

  Windows Command Prompt (CMD)

  Para añadir ggc_user al docker-users grupo o el usuario que utiliza para ejecutar los componentes del contenedor de Docker, ejecute el siguiente comando como administrador.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Para añadir ggc_user al docker-users grupo o al usuario que utiliza para ejecutar los componentes del contenedor de Docker, ejecute el siguiente comando como administrador.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Si configura el software AWS IoT Greengrass Core para usar un proxy de red, debe configurar Docker para que use el mismo servidor proxy.

• Si sus imágenes de Docker están almacenadas en un registro privado de Amazon ECR, debe incluir el componente del servicio de intercambio de tokens como una dependencia en el componente contenedor de Docker. Además, el rol de dispositivo de Greengrass debe permitir las ecr:GetDownloadUrlForLayer acciones, y ecr:GetAuthorizationTokenecr:BatchGetImage, como se muestra en el siguiente ejemplo de política de IAM.

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

• Se admite la ejecución del componente docker Application Manager en una VPC. Para implementar este componente en una VPC, se requiere lo siguiente.

  • El componente docker application manager debe tener conectividad para descargar imágenes. Por ejemplo, si usa ECR, debe tener conectividad con los siguientes puntos finales.

    • *.dkr.ecr.region.amazonaws.com(punto final de VPC) com.amazonaws.region.ecr.dkr

    • api.ecr.region.amazonaws.com(punto final de VPC) com.amazonaws.region.ecr.api

• Ejecute un contenedor Docker