Verificar o status da implantação

Como verificar o status da implantação por destino (AWS CLI)

• Execute o comando a seguir para recuperar o status da implantação mais recente de um destino. Substitua targetArn pelo nome do recurso da Amazon (ARN) da coisa ou grupo de coisas do AWS IoT que a implantação tem como destino.

  aws greengrassv2 list-deployments --target-arn targetArn

  A resposta contém uma lista com a implantação mais recente do destino. Esse objeto de implantação inclui o status da implantação.

Como verificar o status da implantação por ID (AWS CLI)

• Execute o comando a seguir para recuperar o status de uma implantação. Substitua deploymentId pelo ID da implantação a ser consultada.

  aws greengrassv2 get-deployment --deployment-id deploymentId

  A resposta contém o status da implantação.

Como verificar o status do trabalho de implantação de um dispositivo principal (AWS CLI)

• Execute o comando a seguir para recuperar o status de todos os trabalhos de implantação de um dispositivo principal. Substitua coreDeviceName pelo nome do dispositivo principal que será consultado.

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

  A resposta contém a lista de trabalhos de implantação do dispositivo principal. É possível identificar o trabalho para uma implantação pelo deploymentId ou targetArn do trabalho. Cada trabalho de implantação contém o status do trabalho no dispositivo principal.

Como verificar o status de implantação de um grupo de coisas (AWS CLI)

1. Execute o comando a seguir para recuperar o ID de uma implantação existente. Substitua targetArn pelo ARN do grupo de coisas de destino.

   aws greengrassv2 list-deployments --target-arn targetArn

   A resposta contém uma lista com a implantação mais recente do destino. Copie o deploymentId da resposta para usar na próxima etapa.

   nota

   Também é possível listar uma implantação diferente da implantação mais recente do destino. Especifique o argumento --history-filter ALL para listar todas as implantações do destino. Em seguida, copie o ID da implantação cujo status você quer verificar.

2. Execute o comando a seguir para obter os detalhes da implantação. Substitua deploymentID pelo ID da etapa anterior.

   aws greengrassv2 get-deployment --deployment-id deploymentId

   A resposta contém informações sobre a implantação. Copie o iotJobId da resposta para usar na etapa a seguir.

3. Execute o comando a seguir para descrever a execução do trabalho de um dispositivo principal para a implantação. Substitua iotJobId e coreDeviceThingName pelo ID do trabalho da etapa anterior e pelo dispositivo principal do qual você deseja verificar o status.

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

   A resposta contém o status da execução do trabalho de implantação do dispositivo principal e detalhes sobre o status. O detailsMap contém as seguintes informações:

   • detailed-deployment-status: o status do resultado da implantação, que pode ter um dos seguintes valores:

     • SUCCESSFUL: a implantação foi bem-sucedida.

     • FAILED_NO_STATE_CHANGE: a implantação falhou enquanto o dispositivo principal se preparava para aplicar a implantação.

     • FAILED_ROLLBACK_NOT_REQUESTED: a implantação falhou e a implantação não especificou a reversão para uma configuração de trabalho anterior, portanto, o dispositivo principal pode não estar funcionando corretamente.

     • FAILED_ROLLBACK_COMPLETE: a implantação falhou e o dispositivo principal foi revertido com sucesso para uma configuração de trabalho anterior.

     • FAILED_UNABLE_TO_ROLLBACK: a implantação falhou e o dispositivo principal não conseguiu reverter para uma configuração de trabalho anterior, portanto, o dispositivo principal pode não estar funcionando corretamente.

     Se a implantação falhar, verifique o valor deployment-failure-cause e os arquivos de log do dispositivo principal para identificar o problema. Para obter mais informações sobre como acessar os arquivos de log do dispositivo principal, consulte Monitore AWS IoT Greengrass logs.

   • deployment-failure-cause: uma mensagem de erro que fornece detalhes adicionais sobre o motivo da falha na execução do trabalho.

   A resposta é semelhante ao exemplo a seguir.

   {
     "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 Conta da 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
     }
   }