Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# AWS IoT Greengrass Gruppen für einen AWS IoT Greengrass Kern bereitstellen
Verwenden Sie AWS IoT Greengrass Gruppen, um Entitäten in Ihrer Edge-Umgebung zu organisieren. Sie verwenden Gruppen auch, um zu steuern, wie die Entitäten in der Gruppe miteinander und mit den interagieren AWS Cloud. Beispielsweise werden nur die Lambda-Funktionen in der Gruppe für die lokale Ausführung bereitgestellt, und nur die Geräte in der Gruppe können über den lokalen MQTT-Server kommunizieren.
Eine Gruppe muss einen [Core](gg-core.md) enthalten, bei dem es sich um ein AWS IoT Gerät handelt, auf dem die AWS IoT Greengrass Core-Software ausgeführt wird. Der Core fungiert als Edge-Gateway und bietet AWS IoT Core Funktionen in der Edge-Umgebung. Abhängig von Ihren geschäftlichen Anforderungen können Sie auch die folgenden Entitäten zu einer Gruppe hinzufügen:
+ **Client-Geräte**. Dargestellt als Objekte in der AWS IoT -Registrierung. Diese Geräte müssen [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-lib-gg-connectivity.html) ausführen oder das [AWS IoT Device SDK](what-is-gg.md#iot-device-sdk) oder die [AWS IoT Greengrass Discovery-API](gg-discover-api.md) verwenden, um Verbindungsinformationen für den Core abzurufen. Nur Client-Geräte, die Mitglieder der Gruppe sind, können eine Verbindung zum Core herstellen.
+ **Lambda-Funktionen**. Benutzerdefinierte serverlose Anwendungen, die Code auf dem Kern ausführen. Lambda-Funktionen werden in einer Greengrass-Gruppe verfasst AWS Lambda und von dort aus referenziert. Weitere Informationen finden Sie unter [Führen Sie Lambda-Funktionen auf dem Kern aus AWS IoT Greengrass](lambda-functions.md).
+ **Konnektoren** Vordefinierte serverlose Anwendungen, die Code auf dem Kern ausführen. Konnektoren können eine integrierte Integration mit der lokalen Infrastruktur, Geräteprotokollen und anderen Cloud-Diensten ermöglichen. AWS Weitere Informationen finden Sie unter [Integrieren von Services und Protokollen mit Greengrass-Konnektoren](connectors.md).
+ **Abonnements** Definiert die Herausgeber, Abonnenten und MQTT-Themen (oder Themen), die für die MQTT-Kommunikation autorisiert sind.
+ **Ressourcen** Verweise auf lokale [Geräte und Volumes](access-local-resources.md), [Modelle für maschinelles Lernen](ml-inference.md) und [Geheimnisse](secrets.md), die von den Funktionen und Konnektoren von Greengrass Lambda für die Zugriffskontrolle verwendet werden.
+ **Protokolle.** Protokollierung von Konfigurationen für AWS IoT Greengrass Systemkomponenten und Lambda-Funktionen. Weitere Informationen finden Sie unter [Überwachung mit AWS IoT Greengrass Protokollen](greengrass-logs-overview.md).
Sie verwalten Ihre Greengrass-Gruppe im AWS Cloud und stellen sie dann in einem Core bereit. Die Bereitstellung kopiert die Gruppenkonfiguration in die `group.json`-Datei auf dem Core-Gerät. Diese Datei befindet sich unter `{{greengrass-root}}/ggc/deployments/group`.
**Anmerkung**
Während einer Bereitstellung stoppt der Greengrass-Daemon-Prozess auf dem Core-Gerät und startet dann neu.
## Gruppen von der Konsole aus bereitstellen AWS IoT
Sie können eine Gruppe über die Konfigurationsseite der Gruppe in der AWS IoT Konsole bereitstellen und ihre Bereitstellungen verwalten.
**Anmerkung**
Um diese Seite in der Konsole zu öffnen, wählen Sie **Greengrass-Geräte**, dann **Gruppen (V1)** und dann unter **Greengrass-Gruppen** Ihre Gruppe aus.
**Bereitstellen der aktuellen Version der Gruppe**
+ **Wählen Sie auf der Seite mit der Gruppenkonfiguration die Option Bereitstellen aus.**
**Anzeigen des Bereitstellungsverlaufs der Gruppe**
Der Bereitstellungsverlauf einer Gruppe enthält das Datum und die Uhrzeit, die Gruppenversion und den Status der einzelnen Bereitstellungsversuche.
1. Wählen Sie auf der Seite mit der Gruppenkonfiguration die Registerkarte **Bereitstellungen** aus.
1. Um weitere Informationen zu einer Bereitstellung, einschließlich Fehlermeldungen, zu sehen, wählen Sie in der AWS IoT Konsole unter **Greengrass-Geräte** die Option **Deployments** aus.
**Erneutes Bereitstellen einer Gruppenbereitstellung**
Sie können eine Bereitstellung erneut bereitstellen, wenn die aktuelle Bereitstellung fehlschlägt oder auf eine andere Gruppenversion zurückgesetzt wird.
1. Wählen Sie in der AWS IoT Konsole **Greengrass-Geräte** und dann **Gruppen (V1)** aus.
1. Wählen Sie die Registerkarte **Bereitstellen**.
1. **Wählen Sie die Bereitstellung aus, die Sie erneut bereitstellen möchten, und wählen Sie Erneut bereitstellen.**
**Zurücksetzen von Gruppenbereitstellungen**
Sie können Gruppenbereitstellungen zurücksetzen, um eine Gruppe zu verschieben oder zu löschen oder Bereitstellungsinformationen zu entfernen. Weitere Informationen finden Sie unter [Zurücksetzen von Bereitstellungen](reset-deployments-scenario.md).
1. Wählen Sie in der AWS IoT Konsole **Greengrass-Geräte** und dann **Gruppen (V1)** aus.
1. Wählen Sie die Registerkarte **Bereitstellen**.
1. Wählen Sie die Bereitstellung aus, die Sie zurücksetzen möchten, und wählen Sie **Bereitstellungen zurücksetzen**.
## Bereitstellen von Gruppen mit der API AWS IoT Greengrass
Die AWS IoT Greengrass API bietet die folgenden Aktionen zum Bereitstellen von AWS IoT Greengrass Gruppen und zum Verwalten von Gruppenbereitstellungen. Sie können diese Aktionen über die AWS CLI AWS IoT Greengrass API oder das AWS SDK aufrufen.
| Action | Description |
| --- | --- |
| [CreateDeployment](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) | Erstellt eine `NewDeployment`- oder `Redeployment`-Bereitstellung.
Möglicherweise möchten Sie eine Bereitstellung erneut bereitstellen, wenn die aktuelle Bereitstellung fehlschlägt. Sie können auch eine erneute Bereitstellung durchführen, um eine andere Gruppenversion wiederherzustellen. |
| [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html) | Gibt den Status einer Bereitstellung zurück: `Building`, `InProgress`, `Success` oder `Failure`.
Sie können Amazon EventBridge Events so konfigurieren, dass Sie Bereitstellungsbenachrichtigungen erhalten. Weitere Informationen finden Sie unter [Abrufen von Bereitstellungsbenachrichtigungen](deployment-notifications.md). |
| [ListDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | Gibt den Bereitstellungsverlauf für die Gruppe zurück. |
| [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) | Setzt die Bereitstellungen für die Gruppe zurück.
Sie können Gruppenbereitstellungen zurücksetzen, um eine Gruppe zu verschieben oder zu löschen oder Bereitstellungsinformationen zu entfernen. Weitere Informationen finden Sie unter [Zurücksetzen von Bereitstellungen](reset-deployments-scenario.md). |
**Anmerkung**
Weitere Informationen zu Massenbereitstellungsvorgängen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](bulk-deploy-cli.md).
### Abrufen der Gruppen-ID
Die Gruppen-ID wird häufig in API-Aktionen verwendet. Sie können die [ListGroups](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html)Aktion verwenden, um die ID der Zielgruppe aus Ihrer Gruppenliste zu finden. Verwenden Sie AWS CLI beispielsweise in der den `list-groups` Befehl.
```
aws greengrass list-groups
```
Sie können auch die `query`-Option zum Filtern der Ergebnisse einschließen. Beispiel:
+ So rufen Sie die zuletzt erstellte Gruppe ab:
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
+ So rufe Sie eine Gruppe anhand des Namens ab:
```
aws greengrass list-groups --query "Groups[?Name=='{{MyGroup}}']"
```
Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.
Nachfolgend finden Sie eine `list-groups`-Beispielantwort. Die Informationen für jede Gruppe beinhalten die ID der Gruppe (in der `Id`-Eigenschaft) und die ID der letzten Gruppenversion (in der `LatestVersion`-Eigenschaft). Um eine andere Version IDs für eine Gruppe zu erhalten, verwenden Sie die Gruppen-ID mit [ListGroupVersions](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html).
**Anmerkung**
Sie finden diese Werte auch in der AWS IoT Konsole. Die Gruppen-ID wird auf der Seite **Einstellungen** der Gruppe angezeigt. Die Gruppenversion IDs wird auf der Registerkarte **Bereitstellungen** der Gruppe angezeigt.
```
{
"Groups": [
{
"LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
"Name": "MyFirstGroup",
"LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
"LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
"CreationTimestamp": "2019-11-11T05:47:31.435Z",
"Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
"Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
},
{
"LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
"Name": "GreenhouseSensors",
"LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
"LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
"CreationTimestamp": "2020-01-07T19:58:36.774Z",
"Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
"Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
},
...
]
}
```
Wenn Sie keine angeben AWS-Region, verwenden AWS CLI Befehle die Standardregion aus Ihrem Profil. Um Gruppen in einer anderen Region zurückzugeben, fügen Sie die {{region}} Option hinzu. Beispiel:
```
aws greengrass list-groups --region us-east-1
```
## Überblick über das AWS IoT Greengrass Gruppenobjektmodell
Bei der Programmierung mit der AWS IoT Greengrass API ist es hilfreich, das Greengrass-Gruppenobjektmodell zu verstehen.
### Gruppen
In der AWS IoT Greengrass API besteht das `Group` Objekt der obersten Ebene aus Metadaten und einer Liste von `GroupVersion` Objekten. `GroupVersion`Objekte sind mit einer `Group` BY-ID verknüpft.
### Gruppenversionen
`GroupVersion`-Objekte definieren die Gruppenmitgliedschaft. Jede `GroupVersion` verweist auf eine `CoreDefinitionVersion` und andere Komponentenversionen nach ARN. Diese Referenzen bestimmen, welche Entitäten in die Gruppe aufgenommen werden sollen.
Um beispielsweise drei Lambda-Funktionen, ein Gerät und zwei Abonnements in die Gruppe aufzunehmen, lauten die `GroupVersion` Verweise:
+ Die `CoreDefinitionVersion`, die den erforderlichen Core enthält.
+ Die `FunctionDefinitionVersion`, die die drei Funktionen enthält.
+ Das`DeviceDefinitionVersion`, das das Client-Gerät enthält.
+ Die `SubscriptionDefinitionVersion`, die die beiden Abonnements enthält.
Die für ein Core-Gerät bereitgestellte `GroupVersion` bestimmt die Entitäten, die in der lokalen Umgebung verfügbar sind, und wie sie interagieren können.
### Gruppenkomponenten
Komponenten, die Sie Gruppen hinzufügen, haben eine dreistufige Hierarchie:
+ Eine *Definition*, die auf eine Liste von *DefinitionVersion*Objekten eines bestimmten Typs verweist. Beispielsweise verweist eine `DeviceDefinition` auf eine Liste von `DeviceDefinitionVersion`-Objekten.
+ A *DefinitionVersion*, die eine Menge von Entitäten eines bestimmten Typs enthält. Eine `DeviceDefinitionVersion` enthält beispielsweise eine Liste von `Device`-Objekten.
+ Einzelne Entitäten, die ihre Eigenschaften und Verhalten definieren. Beispielsweise `Device` definiert a den ARN des entsprechenden Client-Geräts in der AWS IoT Registrierung, den ARN seines Gerätezertifikats und ob sein lokaler Shadow automatisch mit der Cloud synchronisiert wird.
Sie können einer Gruppe die folgenden Arten von Entitäten hinzufügen:
+ [Konnektor](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connector.html)
+ [Core](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-core.html)
+ [Gerät](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-device.html)
+ [Funktion](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-function.html)
+ [Logger](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html)
+ [Ressource](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-resource.html)
+ [Abonnement](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-subscription.html)
Das folgende Beispiel einer `DeviceDefinition` verweist auf drei `DeviceDefinitionVersion`-Objekte, die jeweils mehrere `Device`-Objekte enthalten. Es wird nur jeweils eine `DeviceDefinitionVersion` in einer Gruppe verwendet.
### Aktualisieren von Gruppen
In der AWS IoT Greengrass API verwenden Sie Versionen, um die Konfiguration einer Gruppe zu aktualisieren. Versionen sind unveränderlich. Um Gruppenkomponenten hinzuzufügen, zu entfernen oder zu ändern, müssen Sie *DefinitionVersion*Objekte erstellen, die neue oder aktualisierte Entitäten enthalten.
Sie können neue *DefinitionVersions*Objekte neuen oder vorhandenen *Definitionsobjekten* zuordnen. Sie können beispielsweise die `CreateFunctionDefinition`-Aktion verwenden, um eine `FunctionDefinition` zu erstellen, die die `FunctionDefinitionVersion` als anfängliche Version enthält. Sie können auch die `CreateFunctionDefinitionVersion`-Aktion verwenden und auf eine vorhandene `FunctionDefinition` verweisen.
Nachdem Sie Ihre Gruppenkomponenten erstellt haben, erstellen Sie eine`GroupVersion`, die alle *DefinitionVersion*Objekte enthält, die Sie in die Gruppe aufnehmen möchten. Stellen Sie anschließend die `GroupVersion` bereit.
Um eine `GroupVersion` bereitzustellen, muss sie auf eine `CoreDefinitionVersion` verweisen, die genau einen `Core` enthält. Alle referenzierten Entitäten müssen Mitglieder der Gruppe sein. Außerdem muss Ihnen in dem Land, AWS-Konto in AWS-Region dem Sie die bereitstellen, [eine Greengrass-Servicerolle](service-role.md) zugeordnet sein. `GroupVersion`
**Anmerkung**
Die `Update`-Aktionen in der API werden verwendet, um den Namen einer `Group` oder eines *Komponentendefinitionsobjekts* zu ändern.
**Entitäten, die auf Ressourcen verweisen AWS , werden aktualisiert**
Greengrass Lambda-Funktionen und [geheime Ressourcen](secrets.md) definieren Greengrass-spezifische Eigenschaften und verweisen auch auf entsprechende Ressourcen. AWS Um diese Entitäten zu aktualisieren, können Sie anstelle Ihrer Greengrass-Objekte Änderungen an der entsprechenden AWS Ressource vornehmen. Lambda-Funktionen verweisen beispielsweise auf eine Funktion in AWS Lambda und definieren auch den Lebenszyklus und andere Eigenschaften, die für die Greengrass-Gruppe spezifisch sind.
+ Um den Lambda-Funktionscode oder die Paketabhängigkeiten zu aktualisieren, nehmen Sie Ihre Änderungen in AWS Lambda vor. Bei der nächsten Gruppenbereitstellung werden diese Änderungen aus Ihrer lokalen Umgebung abgerufen AWS Lambda und in diese kopiert.
+ Um [Greengrass-spezifische Eigenschaften](lambda-group-config.md) zu aktualisieren, erstellen Sie eine `FunctionDefinitionVersion`, der die aktualisierten `Function`-Eigenschaften enthält.
**Anmerkung**
Lambda-Funktionen von Greengrass können auf eine Lambda-Funktion mit dem Alias ARN oder der Version ARN verweisen. Wenn Sie auf den Alias-ARN verweisen (empfohlen), müssen Sie Ihre `FunctionDefinitionVersion` (oder `SubscriptionDefinitionVersion`) nicht aktualisieren, wenn Sie eine neue Funktionsversion in AWS Lambda veröffentlichen. Weitere Informationen finden Sie unter [Lambda-Funktionen nach Alias oder Version referenzieren](lambda-functions.md#lambda-versions-aliases).
## Weitere Informationen finden Sie auch unter
+ [Abrufen von Bereitstellungsbenachrichtigungen](deployment-notifications.md)
+ [Zurücksetzen von Bereitstellungen](reset-deployments-scenario.md)
+ [Erstellen von Sammelbereitstellungen für Gruppen](bulk-deploy-cli.md)
+ [Fehlerbehebung bei Bereitstellungsproblemen](gg-troubleshooting.md#gg-troubleshooting-deploymentissues)
+ [AWS IoT Greengrass Version 1 API Reference](https://docs.aws.amazon.com/greengrass/v1/apireference/)
+ [AWS IoT Greengrass*Befehle in der Befehlsreferenz AWS CLI *](https://docs.aws.amazon.com/cli/latest/reference/greengrass/index.html)