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. # 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).