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. # Lokale Bereitstellungen und Komponenten verwalten **Anmerkung** Diese Funktion ist für Version 2.6.0 und höher der [Greengrass](greengrass-nucleus-component.md) Nucleus-Komponente verfügbar. Verwenden Sie den Greengrass CLI IPC-Dienst, um lokale Bereitstellungen und Greengrass-Komponenten auf dem Kerngerät zu verwalten. Um diese IPC-Operationen zu verwenden, fügen Sie Version 2.6.0 oder höher der [Greengrass-CLI-Komponente](greengrass-cli-component.md) als Abhängigkeit in Ihre benutzerdefinierte Komponente ein. Sie können dann IPC-Operationen in Ihren benutzerdefinierten Komponenten verwenden, um Folgendes zu tun: + Erstellen Sie lokale Bereitstellungen, um Greengrass-Komponenten auf dem Kerngerät zu ändern und zu konfigurieren. + Starten Sie die Greengrass-Komponenten auf dem Kerngerät neu und beenden Sie sie. + Generieren Sie ein Passwort, mit dem Sie sich an der [lokalen Debug-Konsole](local-debug-console-component.md) anmelden können. **Topics** + [Minimale SDK-Versionen](#ipc-local-deployments-components-sdk-versions) + [Autorisierung](#ipc-local-deployments-components-authorization) + [CreateLocalDeployment](#ipc-operation-createlocaldeployment) + [ListLocalDeployments](#ipc-operation-listlocaldeployments) + [GetLocalDeploymentStatus](#ipc-operation-getlocaldeploymentstatus) + [ListComponents](#ipc-operation-listcomponents) + [GetComponentDetails](#ipc-operation-getcomponentdetails) + [RestartComponent](#ipc-operation-restartcomponent) + [StopComponent](#ipc-operation-stopcomponent) + [CreateDebugPassword](#ipc-operation-createdebugpassword) ## Minimale SDK-Versionen In der folgenden Tabelle sind die Mindestversionen von aufgeführt SDKs , die Sie für die Interaktion mit dem Greengrass CLI IPC-Dienst verwenden können. | SDK | Mindestversion | | --- | --- | | [AWS IoT Greengrass Komponenten-SDK (C, C\$1\$1, Rust)](https://github.com/aws-greengrass/aws-greengrass-component-sdk) | v1.0.0 | | [AWS IoT Device SDK für Java v2](https://github.com/aws/aws-iot-device-sdk-java-v2) | v1.2.10 | | [AWS IoT Device SDK für Python v2](https://github.com/aws/aws-iot-device-sdk-python-v2) | v1.5.3 | | [AWS IoT Device SDK für C\$1\$1 v2](https://github.com/aws/aws-iot-device-sdk-cpp-v2) | v1.17.0 | | [AWS IoT Device SDK für v2 JavaScript ](https://github.com/aws/aws-iot-device-sdk-js-v2) | v1.12.0 | ## Autorisierung Um den Greengrass CLI IPC-Dienst in einer benutzerdefinierten Komponente zu verwenden, müssen Sie Autorisierungsrichtlinien definieren, die es Ihrer Komponente ermöglichen, lokale Bereitstellungen und Komponenten zu verwalten. Informationen zur Definition von Autorisierungsrichtlinien finden Sie unter. [Autorisieren Sie Komponenten zur Ausführung von IPC-Vorgängen](interprocess-communication.md#ipc-authorization-policies) Autorisierungsrichtlinien für die Greengrass-CLI haben die folgenden Eigenschaften. **IPC-Servicekennung:** `aws.greengrass.Cli` | Operation | Description | Ressourcen | | --- | --- | --- | | `aws.greengrass#CreateLocalDeployment` | Ermöglicht einer Komponente, eine lokale Bereitstellung auf dem Kerngerät zu erstellen. | `*` | | `aws.greengrass#ListLocalDeployments` | Ermöglicht einer Komponente, lokale Bereitstellungen auf dem Kerngerät aufzulisten. | `*` | | `aws.greengrass#GetLocalDeploymentStatus` | Ermöglicht einer Komponente, den Status einer lokalen Bereitstellung auf dem Kerngerät abzurufen. | Eine lokale Bereitstellungs-ID oder `*` um den Zugriff auf alle lokalen Bereitstellungen zu ermöglichen. | | `aws.greengrass#ListComponents` | Ermöglicht einer Komponente, Komponenten auf dem Kerngerät aufzulisten. | `*` | | `aws.greengrass#GetComponentDetails` | Ermöglicht einer Komponente, Details zu einer Komponente auf dem Kerngerät abzurufen. | Ein Komponentenname, z. B. oder`com.example.HelloWorld`, `*` um den Zugriff auf alle Komponenten zu ermöglichen. | | `aws.greengrass#RestartComponent` | Ermöglicht einer Komponente, eine Komponente auf dem Kerngerät neu zu starten. | Ein Komponentenname, z. B. oder`com.example.HelloWorld`, `*` um den Zugriff auf alle Komponenten zu ermöglichen. | | `aws.greengrass#StopComponent` | Ermöglicht einer Komponente, eine Komponente auf dem Kerngerät zu stoppen. | Ein Komponentenname, z. B. oder`com.example.HelloWorld`, `*` um den Zugriff auf alle Komponenten zu ermöglichen. | | `aws.greengrass#CreateDebugPassword` | Ermöglicht einer Komponente, ein Passwort zu generieren, mit dem sie sich bei der [lokalen Debug-Konsolenkomponente](local-debug-console-component.md) anmelden kann. | `*` | **Example Beispiel für eine Autorisierungsrichtlinie** Das folgende Beispiel für Autorisierungsrichtlinien ermöglicht es einer Komponente, lokale Bereitstellungen zu erstellen, alle lokalen Bereitstellungen und Komponenten anzuzeigen und eine Komponente mit dem Namen neu zu starten und zu beenden. `com.example.HelloWorld` ``` { "accessControl": { "aws.greengrass.Cli": { "com.example.MyLocalManagerComponent:cli:1": { "policyDescription": "Allows access to create local deployments and view deployments and components.", "operations": [ "aws.greengrass#CreateLocalDeployment", "aws.greengrass#ListLocalDeployments", "aws.greengrass#GetLocalDeploymentStatus", "aws.greengrass#ListComponents", "aws.greengrass#GetComponentDetails" ], "resources": [ "*" ] } }, "aws.greengrass.Cli": { "com.example.MyLocalManagerComponent:cli:2": { "policyDescription": "Allows access to restart and stop the Hello World component.", "operations": [ "aws.greengrass#RestartComponent", "aws.greengrass#StopComponent" ], "resources": [ "com.example.HelloWorld" ] } } } } ``` ## CreateLocalDeployment Erstellen oder aktualisieren Sie eine lokale Bereitstellung mithilfe bestimmter Komponentenrezepte, Artefakte und Laufzeitargumente. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl deployment create](gg-cli-deployment.md#deployment-create) in der Greengrass-CLI. ### Anforderung Die Anfrage dieses Vorgangs hat die folgenden Parameter: `recipeDirectoryPath`(Python:`recipe_directory_path`) (Optional) Der absolute Pfad zu dem Ordner, der die Rezeptdateien für Komponenten enthält. `artifactDirectoryPath`(Python:`artifact_directory_path`) (Optional) Der absolute Pfad zu dem Ordner, der die Artefaktdateien enthält, die in die Bereitstellung aufgenommen werden sollen. Der Ordner Artifacts muss die folgende Ordnerstruktur enthalten: ``` /path/to/artifact/folder/component-name/component-version/artifacts ``` `rootComponentVersionsToAdd`(Python:`root_component_versions_to_add`) (Optional) Die Komponentenversionen, die auf dem Kerngerät installiert werden sollen. Dieses Objekt,`ComponentToVersionMap`, ist eine Map, die die folgenden Schlüssel-Wert-Paare enthält: `key` Der Name der Komponente. `value` Die Version der Komponente. `rootComponentsToRemove`(Python:`root_components_to_remove`) (Optional) Die Komponenten, die vom Kerngerät deinstalliert werden sollen. Geben Sie eine Liste an, in der jeder Eintrag dem Namen einer Komponente entspricht. `componentToConfiguration`(Python:`component_to_configuration`) (Optional) Die Konfigurationsaktualisierungen für jede Komponente in der Bereitstellung. Dieses Objekt,`ComponentToConfiguration`, ist eine Map, die die folgenden Schlüssel-Wert-Paare enthält: `key` Der Name der Komponente. `value` Das JSON-Objekt für das Konfigurationsupdate für die Komponente. Das JSON-Objekt muss das folgende Format haben. ``` { "MERGE": { "config-key": "config-value" }, "RESET": [ "path/to/reset/" ] } ``` Weitere Informationen zu Konfigurationsupdates finden Sie unter[Komponentenkonfigurationen aktualisieren](update-component-configurations.md). `componentToRunWithInfo`(Python:`component_to_run_with_info`) (Optional) Die Laufzeitkonfiguration für jede Komponente in der Bereitstellung. Diese Konfiguration umfasst den Systembenutzer, der für die Prozesse der einzelnen Komponenten verantwortlich ist, sowie die Systemlimits, die für jede Komponente gelten sollen. Dieses Objekt,`ComponentToRunWithInfo`, ist eine Map, die die folgenden Schlüssel-Wert-Paare enthält: `key` Der Name der Komponente. `value` Die Laufzeitkonfiguration für die Komponente. Wenn Sie einen Laufzeitkonfigurationsparameter weglassen, verwendet die AWS IoT Greengrass Core-Software die Standardwerte, die Sie auf dem [Greengrass-Nucleus](greengrass-nucleus-component.md) konfigurieren. Dieses Objekt,`RunWithInfo`, enthält die folgenden Informationen: `posixUser`(Python:`posix_user`) (Optional) Der POSIX-Systembenutzer und optional die Gruppe, die verwendet werden sollen, um diese Komponente auf Linux-Kerngeräten auszuführen. Der Benutzer und die Gruppe, falls angegeben, müssen auf jedem Linux-Core-Gerät vorhanden sein. Geben Sie den Benutzer und die Gruppe durch einen Doppelpunkt (`:`) getrennt im folgenden Format an: `user:group`. Die Gruppe ist optional. Wenn Sie keine Gruppe angeben, verwendet die AWS IoT Greengrass Core-Software die primäre Gruppe für den Benutzer. Weitere Informationen finden Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user). `windowsUser`(Python:`windows_user`) (Optional) Der Windows-Benutzer, der für die Ausführung dieser Komponente auf Windows Core-Geräten verwendet werden soll. Der Benutzer muss auf jedem Windows Core-Gerät vorhanden sein, und sein Name und Passwort müssen in der Credentials Manager-Instanz des LocalSystem Kontos gespeichert sein. Weitere Informationen finden Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user). `systemResourceLimits`(Python:`system_resource_limits`) (Optional) Die Systemressourcenlimits, die für die Prozesse dieser Komponente gelten sollen. Sie können Systemressourcenlimits auf generische und nicht containerisierte Lambda-Komponenten anwenden. Weitere Informationen finden Sie unter [Konfigurieren Sie die Systemressourcenlimits für Komponenten](configure-greengrass-core-v2.md#configure-component-system-resource-limits). AWS IoT Greengrass unterstützt diese Funktion derzeit nicht auf Windows-Core-Geräten. Dieses Objekt,`SystemResourceLimits`, enthält die folgenden Informationen: `cpus` (Optional) Die maximale Menge an CPU-Zeit, die die Prozesse dieser Komponente auf dem Kerngerät verwenden können. Die gesamte CPU-Zeit eines Core-Geräts entspricht der Anzahl der CPU-Kerne des Geräts. Auf einem Core-Gerät mit 4 CPU-Kernen können Sie diesen Wert beispielsweise auf festlegen, `2` um die Prozesse dieser Komponente auf 50 Prozent der Auslastung jedes CPU-Kerns zu beschränken. Auf einem Gerät mit einem CPU-Kern können Sie diesen Wert auf festlegen, `0.25` um die Prozesse dieser Komponente auf 25 Prozent der CPU-Auslastung zu beschränken. Wenn Sie diesen Wert auf eine Zahl festlegen, die größer als die Anzahl der CPU-Kerne ist, begrenzt die AWS IoT Greengrass Core-Software die CPU-Auslastung der Komponente nicht. `memory` (Optional) Die maximale Menge an RAM (in Kilobyte), die die Prozesse dieser Komponente auf dem Kerngerät verwenden können. `groupName`(Python:`group_name`) (Optional) Der Name der Dinggruppe, auf die diese Bereitstellung abzielen soll. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `deploymentId`(Python:`deployment_id`) Die ID der lokalen Bereitstellung, die durch die Anfrage erstellt wurde. ## ListLocalDeployments Ruft den Status der letzten 10 lokalen Bereitstellungen ab. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl deployment list](gg-cli-deployment.md#deployment-list) in der Greengrass-CLI. ### Anforderung Die Anfrage dieses Vorgangs hat keine Parameter. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `localDeployments`(Python:`local_deployments`) Die Liste der lokalen Bereitstellungen. Jedes Objekt in dieser Liste ist ein `LocalDeployment` Objekt, das die folgenden Informationen enthält: `deploymentId`(Python:`deployment_id`) Die ID der lokalen Bereitstellung. `status` Der Status der lokalen Bereitstellung. Diese Aufzählung,`DeploymentStatus`, hat die folgenden Werte: + `QUEUED` + `IN_PROGRESS` + `SUCCEEDED` + `FAILED` ## GetLocalDeploymentStatus Ruft den Status einer lokalen Bereitstellung ab. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl Deployment Status](gg-cli-deployment.md#deployment-status) in der Greengrass-CLI. ### Anforderung Die Anfrage dieses Vorgangs hat die folgenden Parameter: `deploymentId`(Python:`deployment_id`) Die ID der lokalen Bereitstellung, die abgerufen werden soll. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `deployment` Die lokale Bereitstellung. Dieses Objekt,`LocalDeployment`, enthält die folgenden Informationen: `deploymentId`(Python:`deployment_id`) Die ID der lokalen Bereitstellung. `status` Der Status der lokalen Bereitstellung. Diese Aufzählung,`DeploymentStatus`, hat die folgenden Werte: + `QUEUED` + `IN_PROGRESS` + `SUCCEEDED` + `FAILED` ## ListComponents Ruft den Namen, die Version, den Status und die Konfiguration jeder Stammkomponente auf dem Kerngerät ab. Eine *Stammkomponente* ist eine Komponente, die Sie in einer Bereitstellung angeben. Diese Antwort beinhaltet keine Komponenten, die als Abhängigkeiten von anderen Komponenten installiert werden. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl component list](gg-cli-component.md#component-list) in der Greengrass-CLI. ### Anforderung Die Anfrage dieser Operation hat keine Parameter. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `components` Die Liste der Root-Komponenten auf dem Core-Gerät. Jedes Objekt in dieser Liste ist ein `ComponentDetails` Objekt, das die folgenden Informationen enthält: `componentName`(Python:`component_name`) Der Name der Komponente. `version` Die Version der Komponente. `state` Der Status der Komponente. Dieser Status kann einer der folgenden sein: + `BROKEN` + `ERRORED` + `FINISHED` + `INSTALLED` + `NEW` + `RUNNING` + `STARTING` + `STOPPING` `configuration` Die Konfiguration der Komponente als JSON-Objekt. ## GetComponentDetails Ruft die Version, den Status und die Konfiguration einer Komponente auf dem Kerngerät ab. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl Component Details](gg-cli-component.md#component-details) in der Greengrass-CLI. ### Anforderung Die Anfrage dieses Vorgangs hat die folgenden Parameter: `componentName`(Python:`component_name`) Der Name der Komponente, die abgerufen werden soll. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `componentDetails`(Python:`component_details`) Die Details der Komponente. Dieses Objekt,`ComponentDetails`, enthält die folgenden Informationen: `componentName`(Python:`component_name`) Der Name der Komponente. `version` Die Version der Komponente. `state` Der Status der Komponente. Dieser Status kann einer der folgenden sein: + `BROKEN` + `ERRORED` + `FINISHED` + `INSTALLED` + `NEW` + `RUNNING` + `STARTING` + `STOPPING` `configuration` Die Konfiguration der Komponente als JSON-Objekt. ## RestartComponent Startet eine Komponente auf dem Kerngerät neu. **Anmerkung** Sie können zwar jede Komponente neu starten, wir empfehlen jedoch, nur [generische Komponenten](develop-greengrass-components.md#component-types) neu zu starten. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl zum Neustarten der Komponente](gg-cli-component.md#component-restart) in der Greengrass-CLI. ### Anforderung Die Anfrage dieses Vorgangs hat die folgenden Parameter: `componentName`(Python:`component_name`) Der Name der Komponente. ### Antwort Die Antwort dieser Operation enthält die folgenden Informationen: `restartStatus`(Python:`restart_status`) Der Status der Neustartanfrage. Der Anforderungsstatus kann einer der folgenden sein: + `SUCCEEDED` + `FAILED` `message` Eine Meldung darüber, warum die Komponente nicht neu gestartet werden konnte, falls die Anfrage fehlgeschlagen ist. ### Beispiele Die folgenden Beispiele zeigen, wie dieser Vorgang in benutzerdefiniertem Komponentencode aufgerufen wird. ------ #### [ Rust ] **Example Beispiel: Starten Sie eine Komponente neu** ``` use gg_sdk::Sdk; fn main() { let sdk = Sdk::init(); sdk.connect().expect("Failed to establish IPC connection"); let component_name = "com.example.HelloWorld"; sdk.restart_component(component_name) .expect("Failed to restart component"); println!("Successfully requested restart for component: {component_name}"); } ``` ------ #### [ C ] **Example Beispiel: Starten Sie eine Komponente neu** ``` #include #include #include #include #include int main(void) { gg_sdk_init(); GgError err = ggipc_connect(); if (err != GG_ERR_OK) { fprintf(stderr, "Failed to establish IPC connection.\n"); exit(-1); } GgBuffer component_name = GG_STR("com.example.HelloWorld"); err = ggipc_restart_component(component_name); if (err != GG_ERR_OK) { fprintf( stderr, "Failed to restart component: %.*s\n", (int) component_name.len, component_name.data ); exit(-1); } printf( "Successfully requested restart for component: %.*s\n", (int) component_name.len, component_name.data ); } ``` ------ #### [ C\$1\$1 (Component SDK) ] **Example Beispiel: Starten Sie eine Komponente neu** ``` #include #include int main() { auto &client = gg::ipc::Client::get(); auto error = client.connect(); if (error) { std::cerr << "Failed to establish IPC connection.\n"; exit(-1); } std::string_view component_name = "com.example.HelloWorld"; error = client.restart_component(component_name); if (error) { std::cerr << "Failed to restart component: " << component_name << "\n"; exit(-1); } std::cout << "Successfully requested restart for component: " << component_name << "\n"; } ``` ------ ## StopComponent Stoppt die Prozesse einer Komponente auf dem Kerngerät. **Anmerkung** Sie können zwar jede Komponente beenden, wir empfehlen jedoch, nur [generische Komponenten](develop-greengrass-components.md#component-types) zu beenden. Dieser Vorgang bietet dieselbe Funktionalität wie der [Befehl zum Stoppen der Komponente](gg-cli-component.md#component-stop) in der Greengrass-CLI. ### Anforderung Die Anfrage dieser Operation hat die folgenden Parameter: `componentName`(Python:`component_name`) Der Name der Komponente. ### Antwort Die Antwort dieser Operation enthält die folgenden Informationen: `stopStatus`(Python:`stop_status`) Der Status der Stopp-Anfrage. Der Anforderungsstatus kann einer der folgenden sein: + `SUCCEEDED` + `FAILED` `message` Eine Meldung darüber, warum die Komponente nicht gestoppt werden konnte, falls die Anfrage fehlgeschlagen ist. ## CreateDebugPassword Generiert ein zufälliges Passwort, mit dem Sie sich bei der [lokalen Debug-Konsolenkomponente](local-debug-console-component.md) anmelden können. Das Passwort läuft 8 Stunden nach seiner Generierung ab. Dieser Vorgang bietet dieselbe Funktionalität wie der [get-debug-password Befehl](gg-cli-get-debug-password.md) in der Greengrass-CLI. ### Anforderung Die Anfrage dieser Operation hat keine Parameter. ### Antwort Die Antwort dieses Vorgangs enthält die folgenden Informationen: `username` Der Benutzername, mit dem Sie sich anmelden möchten. `password` Das Passwort, mit dem Sie sich anmelden möchten. `passwordExpiration`(Python:`password_expiration`) Die Zeit, zu der das Passwort abläuft. `certificateSHA256Hash`(Python:`certificate_sha256_hash`) Der SHA-256-Fingerabdruck für das selbstsignierte Zertifikat, das die lokale Debug-Konsole verwendet, wenn HTTPS aktiviert ist. Verwenden Sie diesen Fingerabdruck, wenn Sie die lokale Debug-Konsole öffnen, um zu überprüfen, ob das Zertifikat legitim und die Verbindung sicher ist. `certificateSHA1Hash`(Python:`certificate_sha1_hash`) Der SHA-1-Fingerabdruck für das selbstsignierte Zertifikat, das die lokale Debug-Konsole verwendet, wenn HTTPS aktiviert ist. Verwenden Sie diesen Fingerabdruck, wenn Sie die lokale Debug-Konsole öffnen, um zu überprüfen, ob das Zertifikat legitim und die Verbindung sicher ist.