Überprüfen Sie den Bereitstellungsstatus

Um den Bereitstellungsstatus nach Ziel (AWS CLI) zu überprüfen

• Führen Sie den folgenden Befehl aus, um den Status der letzten Bereitstellung für ein Ziel abzurufen. targetArnErsetzen Sie es durch den Amazon-Ressourcennamen (ARN) der AWS IoT Sache oder der 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 (AWS CLI) zu überprüfen

• Führen Sie den folgenden Befehl aus, um den Status einer Bereitstellung abzurufen. deploymentIdErsetzen Sie ihn durch die ID der Bereitstellung, die abgefragt werden soll.

  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 ihn durch den Namen des abzufragenden Kerngeräts.

  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 Job für eine Bereitstellung anhand des Auftrags 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. Ersetze es targetArn 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 die deploymentId aus der Antwort, um sie 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 es durch die ID aus dem vorherigen Schritt.

   aws greengrassv2 get-deployment --deployment-id deploymentId

   Die Antwort enthält Informationen über die Bereitstellung. Kopieren Sie die iotJobId aus der Antwort, um sie 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. Die detailsMap enthält die folgenden Informationen:

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

     • SUCCESSFUL— Die Bereitstellung war erfolgreich.

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

     • FAILED_ROLLBACK_NOT_REQUESTED— Die Bereitstellung schlug fehl, und bei der Bereitstellung wurde nicht angegeben, zu einer früheren funktionierenden Konfiguration zurückzukehren, 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 ordnungsgemäß funktioniert.

     Wenn die Bereitstellung fehlgeschlagen ist, überprüfen Sie den deployment-failure-cause Wert und die Protokolldateien des Kerngerä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
     }
   }