Konfigurieren des AWS IoT Greengrass Core

So konfigurieren Sie MQTT über Port 443

Für diese Funktion ist AWS IoT Greengrass Core v1.7 oder höher erforderlich.

Dieses Verfahren ermöglicht es dem Greengrass-Core, Port 443 für MQTT-Messaging mit AWS IoT Core zu verwenden.

1. Führen Sie den folgenden Befehl aus, um den Greengrass-Daemon zu stoppen:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. Öffnen Sie greengrass-root/config/config.json zur Bearbeitung als su-Benutzer.

3. Fügen Sie im Objekt coreThing die Eigenschaft iotMqttPort hinzu und setzen Sie den Wert auf 443, wie im folgenden Beispiel gezeigt.

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotMqttPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600
       },
       ...
   }

4. Starten Sie den -Daemon.

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

So konfigurieren Sie HTTPS über Port 443

Für diese Funktion ist AWS IoT Greengrass Core v1.8 oder höher erforderlich.

Dieses Verfahren konfiguriert den Kern so, dass er Port 443 für die HTTPS-Kommunikation verwendet.

1. Führen Sie den folgenden Befehl aus, um den Greengrass-Daemon zu stoppen:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. Öffnen Sie greengrass-root/config/config.json zur Bearbeitung als su-Benutzer.

3. Fügen Sie im Objekt coreThing die Eigenschaften iotHttpPort und ggHttpPort hinzu, wie im folgenden Beispiel dargestellt.

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotHttpPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggHttpPort" : 443,
           "keepAlive" : 600
       },
       ...
   }

4. Starten Sie den -Daemon.

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

So konfigurieren Sie einen Netzwerk-Proxy

Für diese Funktion ist AWS IoT Greengrass Core v1.7 oder höher erforderlich.

Dieses Verfahren ermöglicht AWS IoT Greengrass, eine Internetverbindung über einen HTTP- oder HTTPS-Netzwerk-Proxy herzustellen.

1. Führen Sie den folgenden Befehl aus, um den Greengrass-Daemon zu stoppen:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. Öffnen Sie greengrass-root/config/config.json zur Bearbeitung als su-Benutzer.

3. Fügen Sie im Objekt coreThing das Objekt networkProxy hinzu, wie im folgenden Beispiel gezeigt.

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600,
           "networkProxy": {
               "noProxyAddresses" : "http://128.12.34.56,www.mywebsite.com",
               "proxy" : {
                   "url" : "https://my-proxy-server:1100",
                   "username" : "Mary_Major",
                   "password" : "pass@word1357"
               }
           }
       },
       ...
   }

4. Starten Sie den -Daemon.

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

So konfigurieren Sie ein Schreibverzeichnis

1. Führen Sie den folgenden Befehl aus, um den AWS IoT Greengrass-Daemon zu beenden:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. Öffnen Sie greengrass-root/config/config.json zur Bearbeitung als su-Benutzer.

3. Fügen Sie writeDirectory als einen Parameter hinzu und geben Sie, wie im folgenden Beispiel, den Pfad zum Zielverzeichnis an.

   {
       "coreThing": {
           "caPath": "root-CA.pem",
           "certPath": "hash.pem.crt",
           ...
       },
       ...
       "writeDirectory" : "/write-directory"
   }

   Anmerkung

   Sie können die writeDirectory-Einstellung so oft aktualisieren, wie Sie möchten. Nachdem die Einstellung aktualisiert wurde, verwendet AWS IoT Greengrass das neu angegebene Schreibverzeichnis beim nächsten Start. Allerdings wird kein Inhalt aus dem vorherigen Schreibverzeichnis migriert.

4. Nachdem Ihr Schreibverzeichnis konfiguriert ist, können Sie optional das greengrass-root-Verzeichnis auf schreibgeschützt einstellen. Anweisungen finden Sie unter So wird das Greengrass-Stammverzeichnis auf schreibgeschützt eingestellt.

   Andernfalls starten Sie den AWS IoT Greengrass-Daemon:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

So aktivieren Sie den Schreibschutz für das Greengrass-Stammverzeichnis

Führen Sie diese Schritte nur aus, wenn das Greengrass-Stammverzeichnis schreibgeschützt sein soll. Das Schreibverzeichnis muss vor Beginn konfiguriert werden.

1. Erteilen Sie Zugriffsberechtigungen für erforderliche Verzeichnisse:

   1. Dem config.json-Besitzer Lese- und Schreibberechtigung erteilen.

      sudo chmod 0600 /greengrass-root/config/config.json

   2. Machen Sie ggc_user zum Besitzer der Zertifikate und System-Lambda-Verzeichnisse.

      sudo chown -R ggc_user:ggc_group /greengrass-root/certs/
      sudo chown -R ggc_user:ggc_group /greengrass-root/ggc/packages/1.11.6/lambda/

      Anmerkung

      Die Konten ggc_user und ggc_group werden standardmäßig verwendet, um System-Lambda-Funktionen auszuführen. Wenn Sie die Standardzugriffsidentität auf Gruppenebene konfiguriert haben, um verschiedene Konten zu verwenden, sollten Sie stattdessen dem Benutzer (UID) und der Gruppe (GID) Berechtigungen erteilen.

2. Stellen Sie mit Ihrem bevorzugten Mechanismus den Schreibschutz für das greengrass-root-Verzeichnis ein.

   Anmerkung

   Sie können den Schreibschutz für das greengrass-root-Verzeichnis einstellen, indem Sie das Verzeichnis als schreibgeschützt mounten. Um jedoch over-the-air (OTA)-Updates auf die AWS IoT Greengrass -Core-Software in einem gemounteten Verzeichnis anzuwenden, muss das Verzeichnis zuerst entmountet und nach dem Update erneut gemountet werden. Sie können diese umount- und mount-Operationen für die ota_pre_update- und ota_post_update-Skripts hinzufügen. Weitere Informationen über OTA-Updates finden Sie unter Greengrass OTA-Update-Agent und Managed Respawn mit OTA-Updates.

3. Starten Sie den -Daemon.

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

   Wenn die Berechtigungen aus Schritt 1 nicht korrekt festgelegt wurden, wird der Daemon nicht gestartet.

1. Rufen Sie die IDs der Greengrass-Zielgruppen und die Gruppenversion ab. Bei diesem Verfahren wird davon ausgegangen, dass es sich um die neueste Gruppe und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   Anmerkung

   Sie finden diese Werte auch in der -AWS IoTKonsole. Die Gruppen-ID wird auf der Seite Einstellungen der Gruppe angezeigt. Gruppenversions-IDs werden auf der Registerkarte Bereitstellungen der Gruppe angezeigt.

2. Kopieren Sie die LatestVersionWerte und Id aus der Zielgruppe in die Ausgabe.

3. Rufen Sie die neueste Gruppenversion ab.

   • Ersetzen Sie group-id durch die kopierte Id.

   • Ersetzen Sie latest-group-version-id durch den LatestVersion, den Sie kopiert haben.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. Kopieren Sie aus dem Objekt Definition in der Ausgabe den CoreDefinitionVersionArn und die ARNs aller anderen Gruppenkomponenten außer FunctionDefinitionVersionArn. Diese Werte verwenden Sie, wenn Sie eine neue Gruppenversion erstellen.

5. Kopieren Sie die ID der Funktionsdefinition aus FunctionDefinitionVersionArn. Die ID ist die GUID, die dem functions-Segment im ARN folgt, wie im folgenden Beispiel gezeigt.

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   Anmerkung

   Sie können auch eine Funktionsdefinition erstellen, indem Sie den create-function-definition Befehl ausführen und dann die ID aus der Ausgabe kopieren.

6. Fügen Sie der Funktionsdefinition eine Funktionsdefinitionsversion hinzu.

   • Ersetzen Sie durch function-definition-id die Id, die Sie für die Funktionsdefinition kopiert haben.

   • Ersetzen Sie arbitrary-function-id durch einen Namen für die Funktion, z. B. spooler-function.

   • Fügen Sie dem functionsArray alle Lambda-Funktionen hinzu, die Sie in diese Version aufnehmen möchten. Sie können den get-function-definition-version Befehl verwenden, um die Greengrass-Lambda-Funktionen aus einer vorhandenen Funktionsdefinitionsversion abzurufen.

   Warnung

   Stellen Sie sicher, dass Sie einen Wert für GG_CONFIG_MAX_SIZE_BYTES angeben, der größer als oder gleich 262144 ist. Eine kleinere Größe verhindert, dass die AWS IoT Greengrass Core-Software gestartet wird.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_MAX_SIZE_BYTES":"2621440","GG_CONFIG_STORAGE_TYPE":"FileSystem"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   Anmerkung

   Wenn Sie zuvor die GG_CONFIG_SUBSCRIPTION_QUALITY-Umgebungsvariable so einstellen, dass sie persistente Sitzungen mit AWS IoT Core unterstützt, schließen Sie sie in diese Funktions-Instance ein.

7. Kopieren Sie den Arn der Funktionsdefinitionsversion aus der Ausgabe.

8. Erstellen Sie eine Gruppenversion, die die System-Lambda-Funktion enthält.

   • Ersetzen Sie group-id durch die Id für die Gruppe.

   • Ersetzen Sie durch core-definition-version-arn die CoreDefinitionVersionArn, die Sie aus der neuesten Gruppenversion kopiert haben.

   • Ersetzen Sie durch function-definition-version-arn die Arn, die Sie für die neue Version der Funktionsdefinition kopiert haben.

   • Ersetzen Sie die ARNs für andere Gruppenkomponenten (zum Beispiel SubscriptionDefinitionVersionArn oder DeviceDefinitionVersionArn), die Sie aus der neuesten Gruppe kopiert haben.

   • Entfernen Sie alle nicht verwendeten Parameter. Entfernen Sie zum Beispiel --resource-definition-version-arn, wenn Ihre Gruppenversion keine Ressourcen enthält.

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. Kopieren Sie die Version aus der Ausgabe. Dies ist die ID der neuen Gruppenversion.

10. Stellen Sie die Gruppe mit der neuen Gruppenversion bereit.

    • Ersetzen Sie group-id durch die kopierte Id für die Gruppe.

    • Ersetzen Sie durch group-version-id die Version, die Sie für die neue Gruppenversion kopiert haben.

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

1. Rufen Sie die IDs der Greengrass-Zielgruppen und die Gruppenversion ab. Bei diesem Verfahren wird davon ausgegangen, dass es sich um die neueste Gruppe und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   Anmerkung

   Sie finden diese Werte auch in der -AWS IoTKonsole. Die Gruppen-ID wird auf der Seite Einstellungen der Gruppe angezeigt. Gruppenversions-IDs werden auf der Registerkarte Bereitstellungen der Gruppe angezeigt.

2. Kopieren Sie die LatestVersionWerte und Id aus der Zielgruppe in die Ausgabe.

3. Rufen Sie die neueste Gruppenversion ab.

   • Ersetzen Sie group-id durch die kopierte Id.

   • Ersetzen Sie latest-group-version-id durch den LatestVersion, den Sie kopiert haben.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. Kopieren Sie aus dem Objekt Definition in der Ausgabe den CoreDefinitionVersionArn und die ARNs aller anderen Gruppenkomponenten außer FunctionDefinitionVersionArn. Diese Werte verwenden Sie, wenn Sie eine neue Gruppenversion erstellen.

5. Kopieren Sie die ID der Funktionsdefinition aus FunctionDefinitionVersionArn. Die ID ist die GUID, die dem functions-Segment im ARN folgt, wie im folgenden Beispiel gezeigt.

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   Anmerkung

   Sie können auch eine Funktionsdefinition erstellen, indem Sie den create-function-definition Befehl ausführen und dann die ID aus der Ausgabe kopieren.

6. Fügen Sie der Funktionsdefinition eine Funktionsdefinitionsversion hinzu.

   • Ersetzen Sie durch function-definition-id die Id, die Sie für die Funktionsdefinition kopiert haben.

   • Ersetzen Sie arbitrary-function-id durch einen Namen für die Funktion, z. B. spooler-function.

   • Fügen Sie dem functionsArray alle Lambda-Funktionen hinzu, die Sie in diese Version aufnehmen möchten. Sie können den get-function-definition-version Befehl verwenden, um die Greengrass-Lambda-Funktionen aus einer vorhandenen Funktionsdefinitionsversion abzurufen.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_SUBSCRIPTION_QUALITY":"AtLeastOncePersistent"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   Anmerkung

   Wenn Sie zuvor die Umgebungsvariablen GG_CONFIG_STORAGE_TYPE oder GG_CONFIG_MAX_SIZE_BYTES zum Definieren von Speichereinstellungen festlegen, schließen Sie sie in diese Funktions-Instance ein.

7. Kopieren Sie den Arn der Funktionsdefinitionsversion aus der Ausgabe.

8. Erstellen Sie eine Gruppenversion, die die System-Lambda-Funktion enthält.

   • Ersetzen Sie group-id durch die Id für die Gruppe.

   • Ersetzen Sie durch core-definition-version-arn die CoreDefinitionVersionArn, die Sie aus der neuesten Gruppenversion kopiert haben.

   • Ersetzen Sie durch function-definition-version-arn die Arn, die Sie für die neue Version der Funktionsdefinition kopiert haben.

   • Ersetzen Sie die ARNs für andere Gruppenkomponenten (zum Beispiel SubscriptionDefinitionVersionArn oder DeviceDefinitionVersionArn), die Sie aus der neuesten Gruppe kopiert haben.

   • Entfernen Sie alle nicht verwendeten Parameter. Entfernen Sie zum Beispiel --resource-definition-version-arn, wenn Ihre Gruppenversion keine Ressourcen enthält.

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. Kopieren Sie die Version aus der Ausgabe. Dies ist die ID der neuen Gruppenversion.

10. Stellen Sie die Gruppe mit der neuen Gruppenversion bereit.

    • Ersetzen Sie group-id durch die kopierte Id für die Gruppe.

    • Ersetzen Sie durch group-version-id die Version, die Sie für die neue Gruppenversion kopiert haben.

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

11. (Optional) Erhöhen Sie die maxWorkItemCount-Eigenschaft in der Core-Konfigurationsdatei. Dies kann dem Core helfen, erhöhten MQTT-Datenverkehr und die Kommunikation mit lokalen Zielen zu bewältigen.

So konfigurieren Sie die Portnummer, die der Core für den lokalen MQTT-Datenverkehr verwendet

1. Führen Sie den folgenden Befehl aus, um den Greengrass-Daemon zu stoppen:

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. Öffnen Sie greengrass-root/config/config.json zur Bearbeitung als su-Benutzer.

3. Fügen Sie im coreThing-Objekt die ggMqttPort-Eigenschaft hinzu und legen Sie den Wert auf die Portnummer fest, die Sie verwenden möchten. Gültige Werte sind 1024 bis 65535. Im folgenden Beispiel wird die Portnummer auf 9000 festgelegt.

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggMqttPort" : 9000,
           "keepAlive" : 600
       },
       ...
   }

4. Starten Sie den -Daemon.

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

5. Wenn die automatische IP-Erkennung für den Core aktiviert ist, ist die Konfiguration abgeschlossen.

   Wenn die automatische IP-Erkennung nicht aktiviert ist, müssen Sie die Konnektivitätsinformationen für den Core aktualisieren. Auf diese Weise können Client-Geräte bei Erkennungsvorgängen die richtige Portnummer erhalten, um Kernkonnektivitätsinformationen zu erhalten. Sie können die AWS IoT Konsole oder AWS IoT Greengrass API verwenden, um die Kernkonnektivitätsinformationen zu aktualisieren. Für dieses Verfahren aktualisieren Sie nur die Portnummer. Die lokale IP-Adresse für den Core bleibt unverändert.

   So aktualisieren Sie die Konnektivitätsinformationen für den Core (Konsole)

   1. Wählen Sie auf der Seite Gruppenkonfiguration den Greengrass-Kern aus.

   2. Wählen Sie auf der Seite mit den Kerndetails die Registerkarte MQTT-Broker-Endpunkte aus.

   3. Wählen Sie Endpunkte verwalten und dann Endpunkt hinzufügen

   4. Geben Sie Ihre aktuelle lokale IP-Adresse und die neue Portnummer ein. Im folgenden Beispiel wird die Portnummer 9000 für die IP-Adresse 192.168.1.8 festgelegt.

   5. Entfernen Sie den veralteten Endpunkt und wählen Sie dann Aktualisieren aus.

   So aktualisieren Sie die Konnektivitätsinformationen für den Core (API)

   • Verwenden Sie die Aktion „UpdateConnectivityInfo“. Im folgenden Beispiel wird update-connectivity-info in der AWS CLI verwendet, um die Portnummer 9000 für die IP-Adresse 192.168.1.8 festzulegen.

     aws greengrass update-connectivity-info \
         --thing-name "MyGroup_Core" \
         --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":9000,\"HostAddress\":\"192.168.1.8\",\"Id\":\"localIP_192.168.1.8\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"}]"

   Anmerkung

   Sie können auch den Port konfigurieren, den der Core für das MQTT-Messaging mit AWS IoT Core verwendet. Weitere Informationen finden Sie unter Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy.

1. Rufen Sie die IDs der Greengrass-Zielgruppen und die Gruppenversion ab. Bei diesem Verfahren wird davon ausgegangen, dass es sich um die neueste Gruppe und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   Anmerkung

   Sie finden diese Werte auch in der -AWS IoTKonsole. Die Gruppen-ID wird auf der Seite Einstellungen der Gruppe angezeigt. Gruppenversions-IDs werden auf der Registerkarte Bereitstellungen der Gruppe angezeigt.

2. Kopieren Sie die LatestVersionWerte und Id aus der Zielgruppe in die Ausgabe.

3. Rufen Sie die neueste Gruppenversion ab.

   • Ersetzen Sie group-id durch die kopierte Id.

   • Ersetzen Sie latest-group-version-id durch den LatestVersion, den Sie kopiert haben.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. Kopieren Sie aus dem Objekt Definition in der Ausgabe den CoreDefinitionVersionArn und die ARNs aller anderen Gruppenkomponenten außer FunctionDefinitionVersionArn. Diese Werte verwenden Sie, wenn Sie eine neue Gruppenversion erstellen.

5. Kopieren Sie die ID der Funktionsdefinition sowie die Funktionsdefinitionsversion aus FunctionDefinitionVersionArn in der Ausgabe:

   arn:aws:greengrass:region:account-id:/greengrass/groups/function-definition-id/versions/function-definition-version-id

   Anmerkung

   Sie können optional eine Funktionsdefinition mit dem create-function-definition-Befehl erstellen, und anschließend die ID aus der Ausgabe kopieren.

6. Verwenden Sie den Befehl get-function-definition-version zum Abrufen des aktuellen Definitionsstatus. Verwenden Sie die , die function-definition-id Sie für die Funktionsdefinition kopiert haben. Zum Beispiel: 4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3.

   aws greengrass get-function-definition-version
   --function-definition-id function-definition-id
   --function-definition-version-id function-definition-version-id
                   

   Notieren Sie sich die aufgeführten Funktionskonfigurationen. Beim Erstellen einer neuen Funktionsdefinitionsversion müssen Sie diese angeben, um zu verhindern, dass Ihre aktuellen Definitionseinstellungen verloren gehen.

7. Fügen Sie der Funktionsdefinition eine Funktionsdefinitionsversion hinzu.

   • Ersetzen Sie durch function-definition-id die Id, die Sie für die Funktionsdefinition kopiert haben. Zum Beispiel: 4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3.

   • Ersetzen Sie arbitrary-function-id durch einen Namen für die Funktion, z. B. auto-detection-function.

   • Fügen Sie dem functionsArray alle Lambda-Funktionen hinzu, die Sie in diese Version aufnehmen möchten, z. B. alle im vorherigen Schritt aufgeführten Funktionen.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn":"arn:aws:lambda:::function:GGIPDetector:1","Id":"arbitrary-function-id","FunctionConfiguration":{"Pinned":true,"MemorySize":32768,"Timeout":3}}]'\
   --region us-west-2

8. Kopieren Sie den Arn der Funktionsdefinitionsversion aus der Ausgabe.

9. Erstellen Sie eine Gruppenversion, die die System-Lambda-Funktion enthält.

   • Ersetzen Sie group-id durch die Id für die Gruppe.

   • Ersetzen Sie durch core-definition-version-arn die CoreDefinitionVersionArn, die Sie aus der neuesten Gruppenversion kopiert haben.

   • Ersetzen Sie durch function-definition-version-arn die Arn, die Sie für die neue Version der Funktionsdefinition kopiert haben.

   • Ersetzen Sie die ARNs für andere Gruppenkomponenten (zum Beispiel SubscriptionDefinitionVersionArn oder DeviceDefinitionVersionArn), die Sie aus der neuesten Gruppe kopiert haben.

   • Entfernen Sie alle nicht verwendeten Parameter. Entfernen Sie zum Beispiel --resource-definition-version-arn, wenn Ihre Gruppenversion keine Ressourcen enthält.

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

10. Kopieren Sie die Version aus der Ausgabe. Dies ist die ID der neuen Gruppenversion.

11. Stellen Sie die Gruppe mit der neuen Gruppenversion bereit.

    • Ersetzen Sie group-id durch die kopierte Id für die Gruppe.

    • Ersetzen Sie durch group-version-id die Version, die Sie für die neue Gruppenversion kopiert haben.

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment