AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.
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.
Opcional: Configuración del contenedor Docker para IDT para AWS IoT Greengrass
AWS IoT Greengrass proporciona un Dockerfile y una imagen de Docker que facilitan la ejecución del software de AWS IoT Greengrass Core en un contenedor Docker. Después de configurar el contenedor de AWS IoT Greengrass, puede ejecutar pruebas IDT. Actualmente, solo se admiten arquitecturas Docker x86_64 para ejecutar IDT AWS IoT Greengrass.
Esta función requiere IDT v2.3.0 o posterior.
El proceso de configuración del contenedor Docker para ejecutar pruebas IDT depende de si se utiliza la imagen Docker o Dockerfile proporcionada por AWS IoT Greengrass.
Uso de la imagen de Docker. La imagen de Docker con el software de AWS IoT Greengrass Core y las dependencias instalados.
Utilice el archivo Dockerfile. El archivo Dockerfile contiene código fuente que puede usar para crear imágenes de contenedor de AWS IoT Greengrass personalizadas. La imagen se puede modificar para ejecutarla en arquitecturas de plataforma distintas o para reducir su tamaño.
nota
AWS IoT Greengrass no proporciona un Dockerfile o una imagen de Docker para la versión 1.11.1 del software principal AWS IoT Greengrass. Para ejecutar pruebas IDT en sus propias imágenes de contenedor personalizadas, la imagen debe incluir las dependencias definidas en el archivo Dockerfile proporcionado por AWS IoT Greengrass.
Las siguientes características no están disponibles cuando se ejecuta AWS IoT Greengrass en un contenedor Docker:
Conectores que se ejecutan en el modo Contenedor de Greengrass. Para ejecutar un conector en un contenedor de Docker, el conector debe ejecutarse en modo Sin contenedor. Para buscar conectores compatibles con el modo Sin contenedor, consulte conectores de Greengrass proporcionados por AWS. Algunos de estos conectores tienen un parámetro de modo de aislamiento que debe establecer en Sin contenedor.
Dispositivos locales y recursos de volumen. Las funciones de Lambda definidas por el usuario que se ejecutan en el contenedor de Docker deben obtener acceso directamente a los dispositivos y volúmenes del dispositivo principal.
Configuración de la imagen de Docker proporcionada por AWS IoT Greengrass
Siga estos pasos para configurar la imagen de Docker de AWS IoT Greengrass para ejecutar pruebas IDT.
Requisitos previos
Antes de empezar este tutorial, debe hacer lo siguiente.
-
Debe instalar el software y las versiones siguientes en su ordenador host en función de la versión de la AWS Command Line Interface (AWS CLI) que elija.
-
Para acceder a los recursos de Amazon Elastic Container Registry (Amazon ECR), debe conceder el siguiente permiso.
-
Amazon ECR requiere que los usuarios tengan permiso
ecr:GetAuthorizationTokenpara realizar llamadas a la API AWS Identity and Access Management a través de una política de IAM antes de que puedan autenticarse en un registro, así como insertar o extraer imágenes de cualquier repositorio de Amazon ECR. Para obtener más información, consulte los ejemplos de políticas de repositorios de Amazon ECR y el Acceso a un repositorio de Amazon ECR en la Guía del usuario de Amazon Elastic Container Registry.
-
Descargar la imagen de Docker y configurar el contenedor. Puede descargar la imagen preinstalada de Docker Hub
o Amazon Elastic Container Registry(Amazon ECR) y ejecutarla en plataformas de Windows, macOS y Linux (x86_64). Para descargar la imagen de Docker de Amazon ECR, complete todos los pasos de Paso 1: Obtener la imagen del contenedor AWS IoT Greengrass de Amazon ECR. A continuación, vuelva a este tema para continuar con la configuración.
-
Solo usuarios de Linux: asegúrese de que el usuario que ejecuta IDT tiene permiso para ejecutar comandos Docker. Para obtener más información, consulte Manage Docker as a non-root user
en la documentación de Docker. -
Para ejecutar el contenedor de AWS IoT Greengrass, utilice el comando para su sistema operativo:
importante
Al hacer pruebas con IDT, no incluya el argumento
--entrypoint /greengrass-entrypoint.sh \que se utiliza para ejecutar la imagen para el uso AWS IoT Greengrass en general. -
Siguiente paso: configure sus credenciales de AWS y el archivo device.json.
Configuración del archivo Dockerfile proporcionado por AWS IoT Greengrass
Siga estos pasos para configurar la imagen Docker creada desde Dockerfile de AWS IoT Greengrass para ejecutar pruebas IDT.
Desde AWS IoT Greengrass Software Docker, descargue el paquete Dockerfile en su equipo host y extráigalo.
Abrir
README.md. Los tres pasos siguientes hacen referencia a las secciones de este archivo.Asegúrese de que cumpla los requisitos de la sección Requisitos previos.
Solo usuarios de Linux: complete los pasos Habilitar protección de enlaces permanentes y simbólicos y Habilitar reenvío de red IPv4.
Para crear la imagen de Docker, complete todos los pasos del Paso 1. Cree la imagen de AWS IoT Greengrass Docker. A continuación, vuelva a este tema para continuar con la configuración.
-
Para ejecutar el contenedor de AWS IoT Greengrass, utilice el comando para su sistema operativo:
importante
Al hacer pruebas con IDT, no incluya el argumento
--entrypoint /greengrass-entrypoint.sh \que se utiliza para ejecutar la imagen para el uso AWS IoT Greengrass en general. -
Siguiente paso: configure sus credenciales de AWS y el archivo device.json.
Solución de problemas con la configuración del contenedor Docker en IDT para AWS IoT Greengrass
Utilice la información siguiente como ayuda para solucionar problemas relacionados con la ejecución de un contenedor de Docker para IDT para las pruebas de AWS IoT Greengrass.
ADVERTENCIA: Error al cargar el archivo de configuración:/home/user/.docker/config.json - stat /home/<user>/.docker/config.json: permiso denegado
Si obtiene este error al ejecutar comandos de docker en Linux, ejecute el siguiente comando. Sustituya<user> en el siguiente comando con el usuario que ejecuta IDT.
sudo chown<user>:<user>/home/<user>/.docker -R sudo chmod g+rwx /home/<user>/.docker -R
