Überprüfen Sie den Bereitstellungsstatus

Um den Bereitstellungsstatus anhand des Ziels zu überprüfen (AWS CLI)

• Führen Sie den folgenden Befehl aus, um den Status der letzten Bereitstellung für ein Ziel abzurufen. targetArnErsetzen Sie durch den Amazon-Ressourcennamen (ARN) der AWS IoT Sache oder Dinggruppe, auf die die Bereitstellung abzielt.

  aws greengrassv2 list-deployments --target-arn targetArn

  Die Antwort enthält eine Liste mit der neuesten Bereitstellung für das Ziel. Dieses Bereitstellungsobjekt enthält den Status der Bereitstellung.

Um den Bereitstellungsstatus anhand der ID zu überprüfen (AWS CLI)

• Führen Sie den folgenden Befehl aus, um den Status einer Bereitstellung abzurufen. deploymentIdErsetzen Sie es durch die ID der abzufragenden Bereitstellung.

  aws greengrassv2 get-deployment --deployment-id deploymentId

  Die Antwort enthält den Status der Bereitstellung.

Um den Status eines Bereitstellungsauftrags für ein Kerngerät zu überprüfen (AWS CLI)

• Führen Sie den folgenden Befehl aus, um den Status aller Bereitstellungsaufträge für ein Kerngerät abzurufen. coreDeviceNameErsetzen Sie es durch den Namen des Kerngeräts, das abgefragt werden soll.

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

  Die Antwort enthält die Liste der Bereitstellungsaufträge für das Kerngerät. Sie können den Auftrag für eine Bereitstellung anhand des Befehls deploymentId oder identifizierentargetArn. Jeder Bereitstellungsauftrag enthält den Status des Auftrags auf dem Kerngerät.

Um den Bereitstellungsstatus für eine Dinggruppe zu überprüfen (AWS CLI)

1. Führen Sie den folgenden Befehl aus, um die ID einer vorhandenen Bereitstellung abzurufen. targetArnErsetzen Sie es durch den ARN der Ziel-Dinggruppe.

   aws greengrassv2 list-deployments --target-arn targetArn

   Die Antwort enthält eine Liste mit der neuesten Bereitstellung für das Ziel. Kopieren Sie das deploymentId aus der Antwort, um es im nächsten Schritt zu verwenden.

   Anmerkung

   Sie können auch eine andere Bereitstellung als die neueste Bereitstellung für das Ziel auflisten. Geben Sie das --history-filter ALL Argument an, um alle Bereitstellungen für das Ziel aufzulisten. Kopieren Sie dann die ID der Bereitstellung, deren Status Sie überprüfen möchten.

2. Führen Sie den folgenden Befehl aus, um die Details der Bereitstellung abzurufen. deploymentIDErsetzen Sie durch die ID aus dem vorherigen Schritt.

   aws greengrassv2 get-deployment --deployment-id deploymentId

   Die Antwort enthält Informationen zur Bereitstellung. Kopieren Sie das iotJobId aus der Antwort, um es im folgenden Schritt zu verwenden.

3. Führen Sie den folgenden Befehl aus, um die Auftragsausführung eines Kerngeräts für die Bereitstellung zu beschreiben. Ersetzen Sie iotJobId und coreDeviceThingName durch die Job-ID aus dem vorherigen Schritt und das Kerngerät, dessen Status Sie überprüfen möchten.

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

   Die Antwort enthält den Status der Ausführung des Bereitstellungsauftrags auf dem Kerngerät sowie Einzelheiten zum Status. Das detailsMap enthält die folgenden Informationen:

   • detailed-deployment-status— Der Status des Bereitstellungsergebnisses, der einen der folgenden Werte annehmen kann:

     • SUCCESSFUL— Die Bereitstellung war erfolgreich.

     • FAILED_NO_STATE_CHANGE— Die Bereitstellung schlug fehl, während sich das Kerngerät darauf vorbereitete, die Bereitstellung durchzuführen.

     • FAILED_ROLLBACK_NOT_REQUESTED— Die Bereitstellung ist fehlgeschlagen, und bei der Bereitstellung wurde kein Rollback zu einer früheren funktionierenden Konfiguration angegeben, sodass das Kerngerät möglicherweise nicht ordnungsgemäß funktioniert.

     • FAILED_ROLLBACK_COMPLETE— Die Bereitstellung ist fehlgeschlagen, und das Kerngerät wurde erfolgreich auf eine frühere funktionierende Konfiguration zurückgesetzt.

     • FAILED_UNABLE_TO_ROLLBACK— Die Bereitstellung ist fehlgeschlagen und das Kerngerät konnte nicht zu einer früheren funktionierenden Konfiguration zurückgesetzt werden, sodass das Kerngerät möglicherweise nicht richtig funktioniert.

     Anmerkung

     Die AWS IoT Greengrass Core-Software ignoriert die Richtlinie zur Fehlerbehandlung für Bootstrap-Bereitstellungen. Eine Bootstrap-Bereitstellung aktualisiert die Greengrass Nucleus-Version oder beinhaltet eine Komponente mit einem Bootstrap-Lebenszyklusschritt. Diese Bereitstellungen werden bei einem Ausfall immer rückgängig gemacht und melden oder. FAILED_ROLLBACK_COMPLETE FAILED_UNABLE_TO_ROLLBACK Weitere Informationen finden Sie unter Erstellen von Bereitstellungen.

     Wenn die Bereitstellung fehlgeschlagen ist, überprüfen Sie den deployment-failure-cause Wert und die Protokolldateien des Hauptgeräts, um das Problem zu identifizieren. Weitere Informationen zum Zugriff auf die Protokolldateien des Kerngeräts finden Sie unterAWS IoT Greengrass Protokolle überwachen.

   • deployment-failure-cause— Eine Fehlermeldung, die zusätzliche Informationen darüber enthält, warum die Auftragsausführung fehlgeschlagen ist.

   Die Antwort sieht dem folgenden Beispiel ähnlich.

   {
     "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 AWS-Konto 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
     }
   }