Gestor de aplicaciones Docker - AWS IoT Greengrass

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Gestor de aplicaciones Docker

El componente administrador de aplicaciones de Docker (aws.greengrass.DockerApplicationManager) AWS IoT Greengrass permite descargar imágenes de Docker de registros de imágenes públicos y registros privados alojados en Amazon Elastic Container Registry (Amazon). ECR También permite AWS IoT Greengrass gestionar las credenciales automáticamente para descargar imágenes de forma segura desde repositorios privados en AmazonECR.

Cuando desarrolle un componente personalizado que ejecute un contenedor de Docker, incluya el administrador de aplicaciones de Docker como dependencia para descargar las imágenes de Docker especificadas como artefactos en su componente. Para obtener más información, consulte Ejecute un contenedor Docker.

Versiones

Este componente tiene las siguientes versiones:

  • 2.0.x

Tipo

Este componente es un componente genérico () aws.greengrass.generic. El núcleo de Greengrass ejecuta los scripts del ciclo de vida del componente.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

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

  • Linux

  • Windows

Requisitos

Este componente tiene los siguientes requisitos:

  • 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 (AmazonECR)

    • Repositorio público de Docker Hub

    • Registro público de confianza de Docker

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

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

    • ECRImagen pública de Amazon: 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 artefacto URI de una imagen, el administrador de aplicaciones de Docker extrae la última versión disponible de esa imagen al implementar tu componente 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 artefacto. URI

  • 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, puede añadir un usuario al docker grupo para que no ejecute docker comandos. sudo

    • 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 tus imágenes de Docker están almacenadas en un registro ECR privado de Amazon, debes incluir el componente del servicio de intercambio de fichas como una dependencia en el componente contenedor de Docker. Además, el rol de dispositivo de Greengrass debe permitir las ecr:GetDownloadUrlForLayer accionesecr:GetAuthorizationToken, yecr:BatchGetImage, como se muestra en el siguiente ejemplo IAM de política.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "ecr:GetAuthorizationToken", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ], "Resource": [ "*" ], "Effect": "Allow" } ] }
  • Se admite que el componente del administrador de aplicaciones de docker se ejecute en un. VPC Para implementar este componente en unVPC, se requiere lo siguiente.

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

      • *.dkr.ecr.region.amazonaws.com(VPCpunto finalcom.amazonaws.region.ecr.dkr)

      • api.ecr.region.amazonaws.com(VPCpunto finalcom.amazonaws.region.ecr.api)

Puntos finales y puertos

Este componente debe poder realizar solicitudes salientes a los siguientes puntos finales y puertos, además de a los puntos finales y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte Permitir el tráfico del dispositivo a través de un proxy o firewall.

punto de enlace Puerto Obligatoria Descripción

ecr.region.amazonaws.com

443 No

Obligatorio si descargas imágenes de Docker de AmazonECR.

hub.docker.com

registry.hub.docker.com/v1

443 No

Obligatorio si descargas imágenes de Docker desde Docker Hub.

Dependencias

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementarlo correctamente. En esta sección se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola.AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.

2.0.12

La siguiente tabla muestra las dependencias de la versión 2.0.12 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.14.0 Flexible
2.0.11

La siguiente tabla muestra las dependencias de la versión 2.0.11 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.13.0 Flexible
2.0.10

La siguiente tabla muestra las dependencias de la versión 2.0.10 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.12.0 Flexible
2.0.9

La siguiente tabla muestra las dependencias de la versión 2.0.9 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.11.0 Flexible
2.0.8

La siguiente tabla muestra las dependencias de la versión 2.0.8 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.10.0 Flexible
2.0.7

La siguiente tabla muestra las dependencias de la versión 2.0.7 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.9.0 Flexible
2.0.6

La siguiente tabla muestra las dependencias de la versión 2.0.6 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.8.0 Flexible
2.0.5

La siguiente tabla muestra las dependencias de la versión 2.0.5 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.7.0 Flexible
2.0.4

La siguiente tabla muestra las dependencias de la versión 2.0.4 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.6.0 Flexible
2.0.3

La siguiente tabla muestra las dependencias de la versión 2.0.3 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.5.0 Flexible
2.0.2

La siguiente tabla muestra las dependencias de la versión 2.0.2 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.4.0 Flexible
2.0.1

La siguiente tabla muestra las dependencias de la versión 2.0.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.3.0 Flexible
2.0.0

La siguiente tabla muestra las dependencias de la versión 2.0.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.2.0 Flexible

Para obtener más información sobre las dependencias de los componentes, consulta la referencia de recetas de componentes.

Configuración

Este componente no tiene ningún parámetro de configuración.

Archivo de registro local

Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver los registros de este componente
  • Ejecute el siguiente comando en el dispositivo principal para ver el archivo de registro de este componente en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 con la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Registros de cambios

En la siguiente tabla se describen los cambios en cada versión del componente.

Versión

Cambios

2.0.12

Versión actualizada para la versión 2.13.0 de Greengrass nucleus.

2.0.11

Versión actualizada para la versión 2.12.0 de Greengrass nucleus.

2.0.10

Versión actualizada para la versión 2.11.0 de Greengrass nucleus.

2.0.9

Versión actualizada para la versión 2.10.0 de Greengrass nucleus.

2.0.8

Versión actualizada para la versión 2.9.0 de Greengrass nucleus.

2.0.7

Versión actualizada para la versión 2.8.0 de Greengrass nucleus.

2.0.6

Versión actualizada para la versión 2.7.0 de Greengrass Nucleus.

2.0.5

Versión actualizada para la versión 2.6.0 de Greengrass nucleus.

2.0.4

Versión actualizada para la versión 2.5.0 de Greengrass nucleus.

2.0.3

Versión actualizada para la versión 2.4.0 de Greengrass nucleus.

2.0.2

Versión actualizada para la versión 2.3.0 de Greengrass nucleus.

2.0.1

Versión actualizada para el lanzamiento de la versión 2.2.0 de Greengrass nucleus.

2.0.0

Versión inicial.

Véase también