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.
Temas
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 ejecutedocker
comandos.sudo
-
En los dispositivos Windows, puede añadir un usuario al
docker-users
grupo para que invoquedocker
comandos sin privilegios de administrador.
-
-
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.
(VPCpunto finalregion
.amazonaws.com.rproxy.goskope.comcom.amazonaws.
)region
.ecr.dkr -
api.ecr.
(VPCpunto finalregion
.amazonaws.com.rproxy.goskope.comcom.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 |
---|---|---|---|
|
443 | No |
Obligatorio si descargas imágenes de Docker de AmazonECR. |
|
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
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.
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
o/greengrass/v2
C:\greengrass\v2
con la ruta a la carpeta AWS IoT Greengrass raíz.
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. |