

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.

# Paso 6: Implementación de su componente
<a name="deploy-first-component"></a>

Con AWS IoT Greengrass, puede implementar componentes en dispositivos individuales o grupos de dispositivos. Al implementar un componente, AWS IoT Greengrass instala y ejecuta el software de ese componente en cada dispositivo de destino. Usted especifica los componentes que se van a implementar y la actualización de configuración que se va a implementar para cada componente. También puede controlar cómo se lleva a cabo la implementación en los dispositivos a los que se dirige la implementación. Para obtener más información, consulte [Implemente AWS IoT Greengrass componentes en los dispositivos](manage-deployments.md).

En esta sección, vuelva a implementar el componente Hello World en su dispositivo principal de Greengrass.

## Implementación de su componente (consola)
<a name="deploy-first-component-console"></a>

1. En el menú de navegación de la [consola de AWS IoT Greengrass](https://console.aws.amazon.com/greengrass), elija **Componentes**.

1. En la página **Componentes**, en la pestaña **Mis componentes**, elija **com.example.HelloWorld**.

1. En la página **com.example.HelloWorld**, elija **Implementar**.

1. En **Agregar a la implementación**, elija **Crear nueva implementación** y, a continuación, elija **Siguiente**. 

1. En la página **Especificar detalles**, haga lo siguiente:

   1. En el cuadro **Name (Nombre)**, introduzca **Deployment for MyGreengrassCore**.

   1. Para el **Destino de la implementación**, elija **Dispositivo principal** y el nombre del objeto de AWS IoT del dispositivo principal. El valor predeterminado de este tutorial es *MyGreengrassCore*.

   1. Elija **Siguiente**.

1. En la página **Seleccionar componentes**, en **Mis componentes**, compruebe que el componente **com.example.HelloWorld** esté seleccionado y elija **Siguiente**.

1. En la página **Configurar componentes**, elija **com.example.HelloWorld** y haga lo siguiente: 

   1. Seleccione **Configurar componente**. 

   1. En **Actualización de la configuración**, en **Configuración para fusionar**, introduzca la siguiente configuración.

      ```
      {
        "Message": "universe"
      }
      ```

      Esta actualización de configuración establece el parámetro `Message` de Hello World en `universe` para el dispositivo de esta implementación.

   1. Seleccione **Confirmar**.

   1. Elija **Siguiente**.

1. En la página **Configurar ajustes avanzados**, mantenga los ajustes de configuración predeterminados y seleccione **Siguiente**.

1. En la página **Revisar**, elija **Implementar**.

1. <a name="getting-started-verify-cloud-deployment-step"></a>Compruebe que la implementación se complete correctamente. La implementación puede tardar varios minutos en completarse. Consulte el registro de Hello World para comprobar el cambio. Ejecute el siguiente comando en su dispositivo principal de Greengrass.

------
#### [ Linux or Unix ]

   ```
   sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
   ```

------
#### [ PowerShell ]

   ```
   gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait
   ```

------

   Debería ver mensajes similares al del siguiente ejemplo.

   ```
   Hello, universe! Greetings from your first Greengrass component.
   ```
**nota**  
Si los mensajes de registro no cambian, la implementación ha fallado o no ha llegado al dispositivo principal. Esto puede ocurrir si el dispositivo principal no está conectado a Internet o no tiene permisos para recuperar artefactos del bucket de S3. Ejecute el siguiente comando en su dispositivo principal para ver el archivo de registro del software AWS IoT Greengrass Core. Este archivo incluye registros del servicio de implementación del dispositivo principal de Greengrass.  

   ```
   sudo tail -f /greengrass/v2/logs/greengrass.log
   ```

   ```
   type C:\greengrass\v2\\logs\\greengrass.log
   ```
<a name="windows-cmd-type-observe-logs"></a>El comando `type` escribe el contenido del archivo en la terminal. Ejecute este comando varias veces para observar los cambios en el archivo.

   ```
   gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait
   ```
Para obtener más información, consulte [Solución de problemas AWS IoT Greengrass V2](troubleshooting.md).

## Implementación de su componente (AWS CLI)
<a name="deploy-first-component-cli"></a>

**Implementación de su componente Hello World**

1. En su computadora de desarrollo, cree un archivo llamado `hello-world-deployment.json` y copie el siguiente JSON en el archivo. Este archivo define los componentes y las configuraciones que se van a implementar.

   ```
   {
     "components": {
       "com.example.HelloWorld": {
         "componentVersion": "1.0.0",
         "configurationUpdate": {
           "merge": "{\"Message\":\"universe\"}"
         }
       }
     }
   }
   ```

   Este archivo de configuración especifica que se debe implementar la versión `1.0.0` del componente Hello World que desarrolló y publicó en el procedimiento anterior. La `configurationUpdate` especifica combinar la configuración del componente en una cadena codificada en JSON. Esta actualización de configuración establece el parámetro `Message` de Hello World en `universe` para el dispositivo de esta implementación.

1. Ejecute el siguiente comando para implementar el componente de su dispositivo principal de Greengrass. Puede realizar la implementación en objetos, que son dispositivos individuales, o en grupos de objetos, que son grupos de dispositivos. Reemplace *MyGreengrassCore* por el nombre del objeto AWS IoT del dispositivo principal.

------
#### [ Linux or Unix ]

   ```
   aws greengrassv2 create-deployment \
     --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \
     --cli-input-json file://hello-world-deployment.json
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   aws greengrassv2 create-deployment ^
     --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^
     --cli-input-json file://hello-world-deployment.json
   ```

------
#### [ PowerShell ]

   ```
   aws greengrassv2 create-deployment `
     --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" `
     --cli-input-json file://hello-world-deployment.json
   ```

------

   El comando devuelve una respuesta similar al siguiente ejemplo.

   ```
   {
     "deploymentId": "deb69c37-314a-4369-a6a1-3dff9fce73a9",
     "iotJobId": "b5d92151-6348-4941-8603-bdbfb3e02b75",
     "iotJobArn": "arn:aws:iot:region:account-id:job/b5d92151-6348-4941-8603-bdbfb3e02b75"
   }
   ```

1. <a name="getting-started-verify-cloud-deployment-step"></a>Compruebe que la implementación se complete correctamente. La implementación puede tardar varios minutos en completarse. Consulte el registro de Hello World para comprobar el cambio. Ejecute el siguiente comando en su dispositivo principal de Greengrass.

------
#### [ Linux or Unix ]

   ```
   sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
   ```

------
#### [ PowerShell ]

   ```
   gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait
   ```

------

   Debería ver mensajes similares al del siguiente ejemplo.

   ```
   Hello, universe! Greetings from your first Greengrass component.
   ```
**nota**  
Si los mensajes de registro no cambian, la implementación ha fallado o no ha llegado al dispositivo principal. Esto puede ocurrir si el dispositivo principal no está conectado a Internet o no tiene permisos para recuperar artefactos del bucket de S3. Ejecute el siguiente comando en su dispositivo principal para ver el archivo de registro del software AWS IoT Greengrass Core. Este archivo incluye registros del servicio de implementación del dispositivo principal de Greengrass.  

   ```
   sudo tail -f /greengrass/v2/logs/greengrass.log
   ```

   ```
   type C:\greengrass\v2\\logs\\greengrass.log
   ```
<a name="windows-cmd-type-observe-logs"></a>El comando `type` escribe el contenido del archivo en la terminal. Ejecute este comando varias veces para observar los cambios en el archivo.

   ```
   gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait
   ```
Para obtener más información, consulte [Solución de problemas AWS IoT Greengrass V2](troubleshooting.md).