Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Gérez les déploiements et les composants locaux **Note** Cette fonctionnalité est disponible pour les versions 2.6.0 et ultérieures du composant [Greengrass](greengrass-nucleus-component.md) nucleus. Utilisez le service IPC Greengrass CLI pour gérer les déploiements locaux et les composants Greengrass sur le périphérique principal. Pour utiliser ces opérations IPC, incluez la version 2.6.0 ou ultérieure du composant Greengrass [CLI en tant que dépendance dans votre composant](greengrass-cli-component.md) personnalisé. Vous pouvez ensuite utiliser les opérations IPC dans vos composants personnalisés pour effectuer les opérations suivantes : + Créez des déploiements locaux pour modifier et configurer les composants Greengrass sur le périphérique principal. + Redémarrez et arrêtez les composants Greengrass sur le périphérique principal. + Générez un mot de passe que vous pouvez utiliser pour vous connecter à la [console de débogage locale](local-debug-console-component.md). **Topics** + [Versions minimales du SDK](#ipc-local-deployments-components-sdk-versions) + [Autorisation](#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) ## Versions minimales du SDK Le tableau suivant répertorie les versions minimales du Kit SDK des appareils AWS IoT que vous devez utiliser pour interagir avec le service IPC Greengrass CLI. | Kit SDK | Version minimale | | --- | --- | | [Kit SDK des appareils AWS IoT pour Java v2](https://github.com/aws/aws-iot-device-sdk-java-v2) | v1.2.10 | | [Kit SDK des appareils AWS IoT pour Python v2](https://github.com/aws/aws-iot-device-sdk-python-v2) | v1.5.3 | | [Kit SDK des appareils AWS IoT pour C\$1\$1 v2](https://github.com/aws/aws-iot-device-sdk-cpp-v2) | v1.17.0 | | [Kit SDK des appareils AWS IoT pour JavaScript v2](https://github.com/aws/aws-iot-device-sdk-js-v2) | v1.12.0 | ## Autorisation Pour utiliser le service IPC Greengrass CLI dans un composant personnalisé, vous devez définir des politiques d'autorisation qui permettent à votre composant de gérer les déploiements et les composants locaux. Pour plus d'informations sur la définition des politiques d'autorisation, consultez[Autoriser les composants à effectuer des opérations IPC](interprocess-communication.md#ipc-authorization-policies). Les politiques d'autorisation de la Greengrass CLI présentent les propriétés suivantes. **Identifiant du service IPC :** `aws.greengrass.Cli` | Opération | Description | Ressources | | --- | --- | --- | | `aws.greengrass#CreateLocalDeployment` | Permet à un composant de créer un déploiement local sur le périphérique principal. | `*` | | `aws.greengrass#ListLocalDeployments` | Permet à un composant de répertorier les déploiements locaux sur le périphérique principal. | `*` | | `aws.greengrass#GetLocalDeploymentStatus` | Permet à un composant d'obtenir l'état d'un déploiement local sur le périphérique principal. | Un identifiant de déploiement local, ou `*` pour autoriser l'accès à tous les déploiements locaux. | | `aws.greengrass#ListComponents` | Permet à un composant de répertorier les composants du périphérique principal. | `*` | | `aws.greengrass#GetComponentDetails` | Permet à un composant d'obtenir des informations sur un composant du périphérique principal. | Un nom de composant, tel que`com.example.HelloWorld`, ou `*` pour autoriser l'accès à tous les composants. | | `aws.greengrass#RestartComponent` | Permet à un composant de redémarrer un composant sur le périphérique principal. | Un nom de composant, tel que`com.example.HelloWorld`, ou `*` pour autoriser l'accès à tous les composants. | | `aws.greengrass#StopComponent` | Permet à un composant d'arrêter un composant du périphérique principal. | Un nom de composant, tel que`com.example.HelloWorld`, ou `*` pour autoriser l'accès à tous les composants. | | `aws.greengrass#CreateDebugPassword` | Permet à un composant de générer un mot de passe à utiliser pour se connecter au [composant de console de débogage local](local-debug-console-component.md). | `*` | **Example Exemple de politique d'autorisation** Les exemples de politiques d'autorisation suivants permettent à un composant de créer des déploiements locaux, de visualiser tous les déploiements et composants locaux, ainsi que de redémarrer et d'arrêter un composant nommé. `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 Créez ou mettez à jour un déploiement local à l'aide de recettes de composants, d'artefacts et d'arguments d'exécution spécifiés. Cette opération fournit les mêmes fonctionnalités que la [commande de création de déploiement](gg-cli-deployment.md#deployment-create) dans la CLI Greengrass. ### Demande La demande de cette opération comporte les paramètres suivants : `recipeDirectoryPath`(Python :`recipe_directory_path`) (Facultatif) Le chemin absolu vers le dossier contenant les fichiers de recettes de composants. `artifactDirectoryPath`(Python :`artifact_directory_path`) (Facultatif) Le chemin absolu vers le dossier contenant les fichiers d'artefacts à inclure dans le déploiement. Le dossier des artefacts doit contenir la structure de dossiers suivante : ``` /path/to/artifact/folder/component-name/component-version/artifacts ``` `rootComponentVersionsToAdd`(Python :`root_component_versions_to_add`) (Facultatif) Les versions des composants à installer sur le périphérique principal. Cet objet est une carte qui contient les paires clé-valeur suivantes : `ComponentToVersionMap` `key` Le nom du composant. `value` Version du composant. `rootComponentsToRemove`(Python :`root_components_to_remove`) (Facultatif) Les composants à désinstaller du périphérique principal. Spécifiez une liste dans laquelle chaque entrée est le nom d'un composant. `componentToConfiguration`(Python :`component_to_configuration`) (Facultatif) Les mises à jour de configuration pour chaque composant du déploiement. Cet objet est une carte qui contient les paires clé-valeur suivantes : `ComponentToConfiguration` `key` Le nom du composant. `value` L'objet JSON de mise à jour de configuration pour le composant. L'objet JSON doit avoir le format suivant. ``` { "MERGE": { "config-key": "config-value" }, "RESET": [ "path/to/reset/" ] } ``` Pour plus d'informations sur les mises à jour de configuration, consultez[Mettre à jour les configurations des composants](update-component-configurations.md). `componentToRunWithInfo`(Python :`component_to_run_with_info`) (Facultatif) La configuration d'exécution pour chaque composant du déploiement. Cette configuration inclut l'utilisateur du système qui possède les processus de chaque composant et les limites du système à appliquer à chaque composant. Cet objet est une carte qui contient les paires clé-valeur suivantes : `ComponentToRunWithInfo` `key` Le nom du composant. `value` Configuration d'exécution du composant. Si vous omettez un paramètre de configuration d'exécution, le logiciel AWS IoT Greengrass Core utilise les valeurs par défaut que vous configurez sur le noyau [Greengrass](greengrass-nucleus-component.md). Cet objet contient `RunWithInfo` les informations suivantes : `posixUser`(Python :`posix_user`) (Facultatif) L'utilisateur du système POSIX et, éventuellement, le groupe à utiliser pour exécuter ce composant sur les périphériques principaux Linux. L'utilisateur et le groupe, s'ils sont spécifiés, doivent exister sur chaque périphérique principal Linux. Spécifiez l'utilisateur et le groupe en les séparant par deux points (`:`) au format suivant : `user:group`. Le groupe est facultatif. Si vous ne spécifiez aucun groupe, le logiciel AWS IoT Greengrass Core utilise le groupe principal pour l'utilisateur. Pour plus d'informations, consultez [Configurer l'utilisateur qui exécute les composants](configure-greengrass-core-v2.md#configure-component-user). `windowsUser`(Python :`windows_user`) (Facultatif) Utilisateur Windows à utiliser pour exécuter ce composant sur les appareils principaux de Windows. L'utilisateur doit exister sur chaque appareil principal de Windows, et son nom et son mot de passe doivent être stockés dans l'instance Credentials Manager du LocalSystem compte. Pour plus d'informations, consultez [Configurer l'utilisateur qui exécute les composants](configure-greengrass-core-v2.md#configure-component-user). `systemResourceLimits`(Python :`system_resource_limits`) (Facultatif) Les limites de ressources système à appliquer aux processus de ce composant. Vous pouvez appliquer des limites de ressources système aux composants Lambda génériques et non conteneurisés. Pour plus d'informations, consultez [Configuration des limites de ressources système pour les composants](configure-greengrass-core-v2.md#configure-component-system-resource-limits). AWS IoT Greengrass ne prend actuellement pas en charge cette fonctionnalité sur les appareils Windows principaux. Cet objet contient `SystemResourceLimits` les informations suivantes : `cpus` (Facultatif) Durée maximale du processeur que les processus de ce composant peuvent utiliser sur le périphérique principal. Le temps processeur total d'un appareil principal est équivalent au nombre de cœurs processeurs de l'appareil. Par exemple, sur un périphérique principal doté de 4 cœurs de processeur, vous pouvez définir cette valeur `2` pour limiter les processus de ce composant à 50 % d'utilisation de chaque cœur de processeur. Sur un appareil doté d'un cœur de processeur, vous pouvez définir cette valeur `0.25` pour limiter les processus de ce composant à 25 % d'utilisation du processeur. Si vous définissez cette valeur sur un nombre supérieur au nombre de cœurs de processeur, le logiciel AWS IoT Greengrass Core ne limite pas l'utilisation du processeur par le composant. `memory` (Facultatif) La quantité maximale de RAM (en kilo-octets) que les processus de ce composant peuvent utiliser sur le périphérique principal. `groupName`(Python :`group_name`) (Facultatif) Nom du groupe d'objets à cibler dans le cadre de ce déploiement. ### Réponse La réponse de cette opération contient les informations suivantes : `deploymentId`(Python :`deployment_id`) ID du déploiement local créé par la demande. ## ListLocalDeployments Obtient le statut des 10 derniers déploiements locaux. Cette opération fournit les mêmes fonctionnalités que la [commande de liste de déploiement](gg-cli-deployment.md#deployment-list) dans la CLI Greengrass. ### Demande La demande de cette opération ne comporte aucun paramètre. ### Réponse La réponse de cette opération contient les informations suivantes : `localDeployments`(Python :`local_deployments`) La liste des déploiements locaux. Chaque objet de cette liste est un `LocalDeployment` objet qui contient les informations suivantes : `deploymentId`(Python :`deployment_id`) ID du déploiement local. `status` État du déploiement local. Cette énumération possède `DeploymentStatus` les valeurs suivantes : + `QUEUED` + `IN_PROGRESS` + `SUCCEEDED` + `FAILED` ## GetLocalDeploymentStatus Obtient le statut d'un déploiement local. Cette opération fournit les mêmes fonctionnalités que la [commande d'état du déploiement](gg-cli-deployment.md#deployment-status) dans la CLI Greengrass. ### Demande La demande de cette opération comporte les paramètres suivants : `deploymentId`(Python :`deployment_id`) ID du déploiement local à obtenir. ### Réponse La réponse de cette opération contient les informations suivantes : `deployment` Le déploiement local. Cet objet contient `LocalDeployment` les informations suivantes : `deploymentId`(Python :`deployment_id`) ID du déploiement local. `status` État du déploiement local. Cette énumération possède `DeploymentStatus` les valeurs suivantes : + `QUEUED` + `IN_PROGRESS` + `SUCCEEDED` + `FAILED` ## ListComponents Obtient le nom, la version, l'état et la configuration de chaque composant racine sur le périphérique principal. Un *composant racine* est un composant que vous spécifiez dans un déploiement. Cette réponse n'inclut pas les composants installés en tant que dépendances d'autres composants. Cette opération fournit les mêmes fonctionnalités que la [commande de liste de composants](gg-cli-component.md#component-list) dans la CLI Greengrass. ### Demande La demande de cette opération ne comporte aucun paramètre. ### Réponse La réponse de cette opération contient les informations suivantes : `components` Liste des composants racine du périphérique principal. Chaque objet de cette liste est un `ComponentDetails` objet qui contient les informations suivantes : `componentName`(Python :`component_name`) Le nom du composant. `version` Version du composant. `state` État du composant. Cet état peut être l'un des suivants : + `BROKEN` + `ERRORED` + `FINISHED` + `INSTALLED` + `NEW` + `RUNNING` + `STARTING` + `STOPPING` `configuration` Configuration du composant en tant qu'objet JSON. ## GetComponentDetails Obtient la version, le statut et la configuration d'un composant sur le périphérique principal. Cette opération fournit les mêmes fonctionnalités que la [commande component details](gg-cli-component.md#component-details) de la CLI Greengrass. ### Demande La demande de cette opération comporte les paramètres suivants : `componentName`(Python :`component_name`) Nom du composant à obtenir. ### Réponse La réponse de cette opération contient les informations suivantes : `componentDetails`(Python :`component_details`) Les détails du composant. Cet objet contient `ComponentDetails` les informations suivantes : `componentName`(Python :`component_name`) Le nom du composant. `version` Version du composant. `state` État du composant. Cet état peut être l'un des suivants : + `BROKEN` + `ERRORED` + `FINISHED` + `INSTALLED` + `NEW` + `RUNNING` + `STARTING` + `STOPPING` `configuration` Configuration du composant en tant qu'objet JSON. ## RestartComponent Redémarre un composant sur le périphérique principal. **Note** Bien que vous puissiez redémarrer n'importe quel composant, nous vous recommandons de ne redémarrer que [les composants génériques](develop-greengrass-components.md#component-types). Cette opération fournit les mêmes fonctionnalités que la [commande de redémarrage du composant](gg-cli-component.md#component-restart) dans la CLI Greengrass. ### Demande La demande de cette opération comporte les paramètres suivants : `componentName`(Python :`component_name`) Le nom du composant. ### Réponse La réponse de cette opération contient les informations suivantes : `restartStatus`(Python :`restart_status`) État de la demande de redémarrage. Le statut de la demande peut être l'un des suivants : + `SUCCEEDED` + `FAILED` `message` Un message expliquant pourquoi le composant n'a pas pu redémarrer, en cas d'échec de la demande. ### Exemples Les exemples suivants montrent comment appeler cette opération dans le code de composant personnalisé. ------ #### [ Rust ] **Example Exemple : redémarrage d'un composant** ``` 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 Exemple : redémarrage d'un composant** ``` #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 Exemple : redémarrage d'un composant** ``` #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 Arrête les processus d'un composant sur le périphérique principal. **Note** Bien que vous puissiez arrêter n'importe quel composant, nous vous recommandons de n'arrêter que [les composants génériques](develop-greengrass-components.md#component-types). Cette opération fournit les mêmes fonctionnalités que la [commande d'arrêt du composant](gg-cli-component.md#component-stop) dans la CLI Greengrass. ### Demande La demande de cette opération comporte les paramètres suivants : `componentName`(Python :`component_name`) Le nom du composant. ### Réponse La réponse de cette opération contient les informations suivantes : `stopStatus`(Python :`stop_status`) État de la demande d'arrêt. Le statut de la demande peut être l'un des suivants : + `SUCCEEDED` + `FAILED` `message` Un message expliquant pourquoi le composant n'a pas pu s'arrêter, en cas d'échec de la demande. ## CreateDebugPassword Génère un mot de passe aléatoire que vous pouvez utiliser pour vous connecter au [composant de console de débogage local](local-debug-console-component.md). Le mot de passe expire 8 heures après sa création. Cette opération fournit les mêmes fonctionnalités que la [get-debug-password commande](gg-cli-get-debug-password.md) de la CLI Greengrass. ### Demande La demande de cette opération ne comporte aucun paramètre. ### Réponse La réponse de cette opération contient les informations suivantes : `username` Le nom d'utilisateur à utiliser pour se connecter. `password` Le mot de passe à utiliser pour se connecter. `passwordExpiration`(Python :`password_expiration`) Heure à laquelle le mot de passe expire. `certificateSHA256Hash`(Python :`certificate_sha256_hash`) L'empreinte SHA-256 du certificat autosigné utilisé par la console de débogage locale lorsque le protocole HTTPS est activé. Lorsque vous ouvrez la console de débogage locale, utilisez cette empreinte pour vérifier que le certificat est légitime et que la connexion est sécurisée. `certificateSHA1Hash`(Python :`certificate_sha1_hash`) L'empreinte SHA-1 du certificat autosigné utilisé par la console de débogage locale lorsque le protocole HTTPS est activé. Lorsque vous ouvrez la console de débogage locale, utilisez cette empreinte pour vérifier que le certificat est légitime et que la connexion est sécurisée.