Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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. # Módulo 2: Instalación del software AWS IoT Greengrass principal Este módulo le muestra cómo instalar el software AWS IoT Greengrass Core en el dispositivo que elija. En él, primero debe crear un grupo y un núcleo de Greengrass. A continuación, debe descargar, configurar e iniciar el software en el dispositivo principal. Para obtener más información acerca de la funcionalidad del software de AWS IoT Greengrass Core, consulte [Configurar el AWS IoT Greengrass núcleo](gg-core.md). Antes de comenzar, asegúrese de haber completado los pasos de configuración del [Módulo 1](module1.md) para el dispositivo elegido. **sugerencia** AWS IoT Greengrass también ofrece otras opciones para instalar el software AWS IoT Greengrass Core. Por ejemplo, puede usar la [configuración de dispositivos Greengrass](quick-start.md) para configurar su entorno e instalar la última versión del software AWS IoT Greengrass Core. O bien, en las plataformas Debian compatibles, puede utilizar el [administrador de paquetes APT](install-ggc.md#ggc-package-manager) para instalar o actualizar el software AWS IoT Greengrass Core. Para obtener más información, consulte [Instale el software AWS IoT Greengrass principal](install-ggc.md). Completar este módulo debería tomarle menos de 30 minutos. **Topics** + [Aprovisiona AWS IoT cualquier cosa para usarla como núcleo de Greengrass](provision-core.md) + [Crea un AWS IoT Greengrass grupo para el núcleo](create-group.md) + [Instalar y ejecutar AWS IoT Greengrass en el dispositivo principal](start-greengrass.md) # Aprovisiona AWS IoT cualquier cosa para usarla como núcleo de Greengrass Los *núcleos* Greengrass son dispositivos que ejecutan el software AWS IoT Greengrass Core para gestionar los procesos locales de IoT. Para configurar un núcleo de Greengrass, se crea un *objeto* AWS IoT que represente un dispositivo o entidad lógica que se conecte a AWS IoT. Cuando registras un dispositivo como una AWS IoT cosa, ese dispositivo puede usar un certificado digital y claves que le permiten acceder AWS IoT. Utiliza una [AWS IoT política](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) para permitir que el dispositivo se comunique con los AWS IoT Greengrass servicios AWS IoT y servicios. En esta sección, registras tu dispositivo como una AWS IoT cosa para usarlo como núcleo de Greengrass. **Para crear cualquier cosa AWS IoT** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot). 1. En **Administrar**, expanda **Todos los dispositivos** y, a continuación, elija **Objetos**. 1. En la página **Objetos**, seleccione **Crear objetos**. 1. En la página **Crear objetos**, elija **Crear un solo objeto**, y luego seleccione **Siguiente**. 1. En la página **Especificar propiedades del objeto**, haga lo siguiente: 1. En **Nombre del objeto**, introduzca un nombre que represente su dispositivo, como **MyGreengrassV1Core**. 1. Elija **Siguiente**. 1. En la página **Configurar el certificado del dispositivo**, seleccione **Siguiente**. 1. En la página **Adjuntar políticas al certificado**, realice uno de los siguientes procedimientos: + Seleccione una política existente que conceda los permisos que requieren los dispositivos principales y, a continuación, seleccione **Crear objeto**. Se abre un modal en el que puede descargar los certificados y las claves que el dispositivo utiliza para conectarse a la Nube de AWS. + Cree y adjunte una nueva política que conceda permisos al dispositivo principal. Haga lo siguiente: 1. Elija **Crear política**. La página **Create policy (Crear política)** se abre en una pestaña nueva. 1. En la página **Create policy (Crear política)**, haga lo siguiente: 1. En **Nombre de la política**, introduzca un nombre que describa la política, como **GreengrassV1CorePolicy**. 1. En la pestaña **Declaraciones de política**, en **Documento de política**, seleccione **JSON**. 1. Ingrese el siguiente documento de política. Esta política permite que el núcleo se comunique con el AWS IoT Core servicio, interactúe con los dispositivos ocultos y se comunique con el AWS IoT Greengrass servicio. Para obtener información sobre cómo restringir el acceso a esta política en función de su caso de uso, consulte [AWS IoT Política mínima para el dispositivo AWS IoT Greengrass principal](device-auth.md#gg-config-sec-min-iot-policy). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Subscribe", "iot:Connect", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "greengrass:*" ], "Resource": [ "*" ] } ] } ``` ------ 1. Elija **Create** (Crear) para crear la política. 1. Vuelva a la pestaña del navegador con la página **Adjuntar políticas al certificado** abierta. Haga lo siguiente: 1. En la lista **Políticas**, seleccione la política que ha creado, como **GreengrassV1CorePolicy**. Si no se puede ver la política, seleccione el botón de actualizar. 1. Elija **Crear objeto**. Se abre un modal en el que puede descargar los certificados y las claves que el núcleo utiliza para conectarse a AWS IoT. 1. Vuelva a la pestaña del navegador con la página **Adjuntar políticas al certificado** abierta. Haga lo siguiente: 1. En la lista **Políticas**, seleccione la política que ha creado, como **GreengrassV1CorePolicy**. Si no se puede ver la política, seleccione el botón de actualizar. 1. Elija **Crear objeto**. Se abre un modal en el que puede descargar los certificados y las claves que el núcleo utiliza para conectarse a AWS IoT. 1. En el modal **Descargar certificados y claves**, descargue los certificados del dispositivo. **importante** Descargue los recursos de seguridad antes de elegir **Listo**. Haga lo siguiente: 1. Para el **Certificado del dispositivo**, seleccione **Descargar** para descargar el certificado del dispositivo. 1. En **Archivo de clave pública**, seleccione **Descargar** para descargar la clave pública del certificado. 1. En **Archivo de clave privada**, seleccione **Descargar** para descargar el archivo de clave privada del certificado. 1. Revise la [Autenticación de servidor](https://docs.aws.amazon.com/iot/latest/developerguide/server-authentication.html) en la *Guía del desarrollador de AWS IoT * y seleccione el certificado de CA raíz adecuado. Le recomendamos que utilice los puntos de conexión de Amazon Trust Services (ATS) y los certificados de CA raíz de ATS. En **Certificados de CA raíz**, seleccione **Descargar** para obtener un certificado de CA raíz. 1. Seleccione **Listo**. Tome nota del identificador del certificado que comparten los nombres de archivo del certificado y las claves del dispositivo. Lo necesitará más adelante. # Crea un AWS IoT Greengrass grupo para el núcleo AWS IoT Greengrass *los grupos* contienen la configuración y otra información sobre sus componentes, como los dispositivos cliente, las funciones de Lambda y los conectores. Un grupo define la configuración de un núcleo, incluida la forma en que sus componentes pueden interactuar entre sí. En esta sección creará un grupo para el núcleo. **sugerencia** Para ver un ejemplo en el que se usa la AWS IoT Greengrass API para crear e implementar un grupo, consulte el repositorio [gg\$1group\$1setup](https://github.com/awslabs/aws-greengrass-group-setup) en. GitHub **Creación de un grupo para el núcleo** 1. Vaya a la [consola de AWS IoT](https://console.aws.amazon.com/iot). 1. En **Administrar**, expanda **los dispositivos Greengrass** y elija **Grupos (V1)**. **nota** Si no ve el menú de **dispositivos de Greengrass**, cámbielo a uno Región de AWS que sea compatible. AWS IoT Greengrass V1 Para ver una lista completa de las regiones compatibles, consulte [AWS IoT Greengrass V1 endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/greengrass.html) en la *Referencia general de AWS*. Debes [crearlo para AWS IoT tu núcleo](provision-core.md) en una región en la que AWS IoT Greengrass V1 esté disponible. 1. En la página de **grupos de Greengrass**, seleccione **Crear grupo**. 1. En la página **Crear grupo de Greengrass**, haga lo siguiente: 1. Para el **nombre del grupo Greengrass**, introduzca un nombre que describa el grupo, como por ejemplo **MyGreengrassGroup**. 1. Para el **núcleo de Greengrass**, elige AWS IoT lo que creaste anteriormente, como **MyGreengrassV1Core**. La consola selecciona automáticamente el certificado de dispositivo del dispositivo. 1. Elija **Crear grupo**. # Instalar y ejecutar AWS IoT Greengrass en el dispositivo principal **nota** Este tutorial proporciona instrucciones para ejecutar el software AWS IoT Greengrass Core en una Raspberry Pi, pero puede utilizar cualquier dispositivo compatible. En esta sección, configurará, instalará y ejecutará el software AWS IoT Greengrass Core en su dispositivo principal. **Para instalar y ejecutar AWS IoT Greengrass** 1. En la sección sobre el [software AWS IoT Greengrass principal](what-is-gg.md#gg-core-download-tab) de esta guía, descargue el paquete de instalación del software AWS IoT Greengrass principal. Elija el paquete que mejor se adapte a la arquitectura de la CPU, la distribución y el sistema operativo del dispositivo principal. + Para Raspberry Pi, descargue el paquete para la arquitectura de ARMv7L y el sistema operativo Linux. + Para una EC2 instancia de Amazon, descarga el paquete para la arquitectura x86\$164 y el sistema operativo Linux. + Para NVIDIA Jetson TX2, descarga el paquete para la arquitectura Armv8 (AArch64) y el sistema operativo Linux. + En el caso de Intel Atom, descargue el paquete para la arquitectura x86\$164 y el sistema operativo Linux. 1. En pasos anteriores, descargó cinco archivos en su equipo: + `greengrass-OS-architecture-1.11.6.tar.gz`— Este archivo comprimido contiene el software AWS IoT Greengrass principal que se ejecuta en el dispositivo principal. + `certificateId-certificate.pem.crt` – El certificado del dispositivo. + `certificateId-public.pem.key` – El archivo de clave pública del certificado del dispositivo. + `certificateId-private.pem.key` – El archivo de clave privada del certificado del dispositivo. + `AmazonRootCA1.pem` – El archivo de la entidad de certificación (CA) raíz de Amazon. En este paso, transfiere estos archivos del equipo al dispositivo del núcleo. Haga lo siguiente: 1. Si no conoce la dirección IP de su dispositivo de Greengrass Core, abra un terminal en el dispositivo central y ejecute el siguiente comando: **nota** Este comando podría no devolver la dirección IP correcta de algunos dispositivos. Consulte la documentación de su dispositivo para recuperar la dirección IP del mismo. ``` hostname -I ``` 1. Transfiera estos archivos desde el ordenador al dispositivo del núcleo. Los pasos de File Transfer varían según el sistema operativo de su equipo. Elija su sistema operativo para ver los pasos que muestran cómo transferir archivos a su dispositivo Raspberry Pi. **nota** En Raspberry Pi, el nombre de usuario y la contraseña predeterminados son **pi** y **raspberry**, respectivamente. En el caso de un dispositivo NVIDIA Jetson TX2, el nombre de usuario **nvidia** y la contraseña predeterminados son**nvidia**. ------ #### [ Windows ] Para transferir los archivos comprimidos desde el ordenador a un dispositivo principal de Raspberry Pi, utilice una herramienta adecuada, como [WinSCP](https://winscp.net/eng/download.php) o el comando **pscp** de [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html). Para utilizar el comando **pscp**, abra una ventana del símbolo de sistema en el equipo y ejecute lo siguiente: ``` cd path-to-downloaded-files pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** El número de versión de este comando debe coincidir con la versión del paquete de software AWS IoT Greengrass principal. ------ #### [ macOS ] Para transferir los archivos comprimidos desde un Mac a un dispositivo Raspberry Pi central, abra una ventana de terminal en el equipo y ejecute los comandos siguientes. Por lo general, *path-to-downloaded-files* es`~/Downloads`. **nota** Es posible que se le soliciten dos contraseñas. En tal caso, la primera contraseña es para el comando `sudo` de Mac y la segunda, para el Raspberry Pi. ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** El número de versión de este comando debe coincidir con la versión del paquete de software AWS IoT Greengrass principal. ------ #### [ UNIX-like system ] Para transferir los archivos comprimidos desde un equipo a un dispositivo Raspberry Pi central, abra una ventana de terminal en el equipo y ejecute los comandos siguientes: ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** El número de versión de este comando debe coincidir con la versión de su paquete de software AWS IoT Greengrass principal. ------ #### [ Raspberry Pi web browser ] Si descargó los archivos comprimidos a través del navegador web del Raspberry Pi, dichos archivos seguramente estén en la carpeta `~/Downloads` del dispositivo Pi, como por ejemplo `/home/pi/Downloads`. De lo contrario, los archivos comprimidos deben estar en la carpeta del Pi `~`, como por ejemplo `/home/pi`. ------ 1. En el dispositivo principal de Greengrass, abra una terminal y vaya a la carpeta que contiene el software y los AWS IoT Greengrass certificados principales. *path-to-transferred-files*Sustitúyala por la ruta a la que transfirió los archivos en el dispositivo principal. Por ejemplo, en un Raspberry Pi, ejecute `cd /home/pi`. ``` cd path-to-transferred-files ``` 1. Desempaquete el software AWS IoT Greengrass principal del dispositivo principal. Ejecute el siguiente comando para descomprimir el archivo de software que ha transferido al dispositivo del núcleo. Este comando usa el argumento `-C /` para crear la carpeta `/greengrass` en la carpeta raíz del dispositivo del núcleo. ``` sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C / ``` **nota** El número de versión de este comando debe coincidir con la versión del paquete de software AWS IoT Greengrass principal. 1. Mueva los certificados y las claves a la carpeta de software AWS IoT Greengrass principal. Ejecute los siguientes comandos para crear una carpeta de certificados y mover los certificados y las claves a ella. *path-to-transferred-files*Sustitúyalos por la ruta a la que transfirió los archivos del dispositivo principal y *certificateId* sustitúyalos por el identificador del certificado en los nombres de los archivos. Por ejemplo, en una Raspberry Pi, *path-to-transferred-files* sustitúyala por **/home/pi** ``` sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs ``` 1. El software AWS IoT Greengrass Core utiliza un archivo de configuración que especifica los parámetros del software. Este archivo de configuración especifica las rutas de los archivos de certificados y los Nube de AWS puntos finales que se van a utilizar. En este paso, creará el archivo de configuración del software AWS IoT Greengrass principal para su núcleo. Haga lo siguiente: 1. Obtenga el nombre de recurso de Amazon (ARN) para lo que más le interesa. AWS IoT Haga lo siguiente: 1. En la [consola AWS IoT](https://console.aws.amazon.com/iot), en **Administrar**, en **Dispositivos Greengrass**, elija **Grupos (V1)**. 1. En la página de **Grupos de Greengrass**, elija el grupo que creó anteriormente. 1. En **Descripción general**, seleccione el **Núcleo de Greengrass**. 1. En la página de detalles principales, copie el **ARN y AWS IoT guárdelo** para usarlo en el archivo de configuración AWS IoT Greengrass principal. 1. Obtenga el punto de conexión de datos del AWS IoT dispositivo correspondiente Cuenta de AWS a su región actual. Los dispositivos utilizan este punto final para conectarse AWS a otros AWS IoT dispositivos. Haga lo siguiente: 1. En la [consola de AWS IoT](https://console.aws.amazon.com/iot), elija **Configuración**. 1. En **Punto de conexión de datos de dispositivo**, copie el **punto de conexión** y guárdelo para usarlo en el archivo de configuración de AWS IoT Greengrass Core. 1. Cree el archivo de configuración del software AWS IoT Greengrass principal. Por ejemplo, puede ejecutar el comando siguiente para usar GNU nano para crear el archivo. ``` sudo nano /greengrass/config/config.json ``` Reemplace el contenido del archivo por el siguiente documento JSON: ``` { "coreThing" : { "caPath": "AmazonRootCA1.pem", "certPath": "certificateId-certificate.pem.crt", "keyPath": "certificateId-private.pem.key", "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core", "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com", "ggHost": "greengrass-ats.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes" } }, "managedRespawn": false, "crypto": { "caPath": "file:///greengrass/certs/AmazonRootCA1.pem", "principals": { "SecretsManager": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key" }, "IoTCertificate": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key", "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt" } } } } ``` A continuación, proceda del modo siguiente: + Si ha descargado un certificado de CA raíz de Amazon diferente al de Amazon Root CA 1, sustituya cada instancia de *AmazonRootCA1.pem* por el nombre del archivo de CA raíz de Amazon. + Sustituya cada instancia *certificateId* de por el ID del certificado en el nombre de los archivos de certificados y claves. + *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core*Sustitúyalo por el ARN de tu núcleo que guardaste anteriormente. + *MyGreengrassV1core*Sustitúyelo por el nombre del elemento principal. + *device-data-prefix-ats.iot.region.amazonaws.com*Sustitúyalo por el punto final de datos del AWS IoT dispositivo que guardaste anteriormente. + *region*Sustitúyalo por tu Región de AWS. Para obtener más información sobre las opciones de configuración que puede especificar en este archivo de configuración, consulte [AWS IoT Greengrass archivo de configuración principal](gg-core.md#config-json). 1. Asegúrese de que su dispositivo central esté conectado a internet. A continuación, inicie AWS IoT Greengrass en su dispositivo principal. ``` cd /greengrass/ggc/core/ sudo ./greengrassd start ``` Debería aparecer un mensaje `Greengrass successfully started`. Tome nota del PID. **nota** Para configurar el dispositivo principal para que se inicie al arrancar AWS IoT Greengrass el sistema, consulte[Configurar el sistema Init para que inicie el daemon de Greengrass](gg-core.md#start-on-boot). Puede ejecutar el siguiente comando para confirmar que el software AWS IoT Greengrass principal (daemon Greengrass) está funcionando. *PID-number*Sustitúyalo por tu PID: ``` ps aux | grep PID-number ``` Debería ver una entrada para el PID con una ruta al demonio de Greengrass en ejecución (por ejemplo, `/greengrass/ggc/packages/1.11.6/bin/daemon`). Si tiene problemas al iniciar AWS IoT Greengrass, consulte[Solución de problemas AWS IoT Greengrass](gg-troubleshooting.md).