Verificar el estado de implementación

Para comprobar el estado de la implementación por target (AWS CLI)

• Ejecute el siguiente comando para recuperar el estado de la implementación más reciente de un destino. Sustituya targetArn por el nombre de recurso de Amazon (ARN) de laAWS IoT cosa o el grupo de cosas al que se dirige la implementación.

  aws greengrassv2 list-deployments --target-arn targetArn

  La respuesta contiene una lista con la implementación más reciente para el objetivo. Este objeto de despliegue incluye el estado del despliegue.

Para comprobar el estado de la implementación por ID (AWS CLI)

• Ejecute el siguiente comando para recuperar el estado de una implementación. Sustituya DeploymentID por el ID de la implementación a consultar.

  aws greengrassv2 get-deployment --deployment-id deploymentId

  La respuesta contiene el estado de la implementación.

Para comprobar el estado de los trabajos de implementación de un dispositivo principal (AWS CLI)

• Ejecute el siguiente comando para recuperar el estado de todos los trabajos de implementación de un dispositivo de núcleo. coreDeviceNameSustitúyalo por el nombre del dispositivo principal que se va a consultar.

  aws greengrassv2 list-effective-deployments --core-device-thing-name coreDeviceName

  La respuesta contiene la lista de trabajos de implementación del dispositivo principal. Puede identificar el trabajo de una implementación por su nombredeploymentId otargetArn. Cada tarea de implementación contiene el estado de la tarea en el dispositivo principal.

Para comprobar los estados de implementación de un grupo de cosas (AWS CLI)

1. Ejecute el siguiente comando para recuperar el ID de una implementación existente. Reemplace targetArn por el ARN del grupo de cosas de destino.

   aws greengrassv2 list-deployments --target-arn targetArn

   La respuesta contiene una lista con la implementación más reciente para el objetivo. Copie eldeploymentId de la respuesta para usarlo en el siguiente paso.

   nota

   También puede incluir una implementación que no sea la implementación más reciente para el destino. Especifique el--history-filter ALL argumento para enumerar todas las implementaciones del objetivo. A continuación, copie el ID de la implementación cuyo estado desea comprobar.

2. Ejecute el siguiente comando para obtener los detalles de la implementación. Reemplace Dep por el ID del paso anterior.

   aws greengrassv2 get-deployment --deployment-id deploymentId

   La respuesta contiene información acerca de la implementación. Copie eliotJobId de la respuesta para usarlo en el paso siguiente.

3. Ejecute el siguiente comando para describir la ejecución del trabajo de un dispositivo principal para la implementación. Reemplace iotJobIdy asigne un coreDeviceThingnombre por el ID de trabajo del paso anterior y el dispositivo principal del que desea comprobar el estado.

   aws iot describe-job-execution --job-id iotJobId --thing-name coreDeviceThingName

   La respuesta contiene el estado de la ejecución del trabajo de despliegue del dispositivo principal y detalles sobre el estado. detailsMapContiene la siguiente información:

   • detailed-deployment-status— El estado del resultado de la implementación, que puede tener uno de los siguientes valores:

     • SUCCESSFUL— El despliegue se ha realizado correctamente.

     • FAILED_NO_STATE_CHANGE— La implementación falló mientras el dispositivo principal se preparaba para aplicar la implementación.

     • FAILED_ROLLBACK_NOT_REQUESTED— La implementación falló y la implementación no especificó volver a una configuración de trabajo anterior, por lo que es posible que el dispositivo principal no funcione correctamente.

     • FAILED_ROLLBACK_COMPLETE— Se produjo un error en la implementación y el dispositivo principal se restableció correctamente a una configuración de trabajo anterior.

     • FAILED_UNABLE_TO_ROLLBACK— La implementación falló y el dispositivo principal no pudo volver a una configuración de trabajo anterior, por lo que es posible que el dispositivo principal no funcione correctamente.

     Si la implementación falló, compruebe eldeployment-failure-cause valor y los archivos de registro del dispositivo principal para identificar el problema. Para obtener más información acerca de cómo acceder a los archivos de registro del dispositivo principal, consulteSupervisar AWS IoT Greengrass registros.

   • deployment-failure-cause— Un mensaje de error que proporciona detalles adicionales sobre el motivo del error en la ejecución del trabajo.

   La respuesta tiene un aspecto similar al siguiente ejemplo.

   {
     "execution": {
       "jobId": "2cc2698a-5175-48bb-adf2-1dd345606ebd",
       "status": "FAILED",
       "statusDetails": {
         "detailsMap": {
           "deployment-failure-cause": "No local or cloud component version satisfies the requirements. Check whether the version constraints conflict and that the component exists in your Cuenta de AWS with a version that matches the version constraints. If the version constraints conflict, revise deployments to resolve the conflict. Component com.example.HelloWorld version constraints: LOCAL_DEPLOYMENT requires =1.0.0, thinggroup/MyGreengrassCoreGroup requires =1.0.1.",
           "detailed-deployment-status": "FAILED_NO_STATE_CHANGE"
         }
       },
       "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
       "queuedAt": "2022-02-15T14:45:53.098000-08:00",
       "startedAt": "2022-02-15T14:46:05.670000-08:00",
       "lastUpdatedAt": "2022-02-15T14:46:20.892000-08:00",
       "executionNumber": 1,
       "versionNumber": 3
     }
   }