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. # Déployez l'agent Amazon Kinesis Video Streams Edge pour AWS IoT Greengrass Cette section fournit un guide complet sur l'utilisation d'Amazon Kinesis Video Streams AWS IoT Greengrass avec. En combinant ces services, vous pouvez diffuser efficacement des vidéos depuis des appareils de pointe vers le cloud, permettant ainsi un large éventail d'applications dans les domaines de l'IoT, de la surveillance, etc. Vous trouverez des informations détaillées sur : + Configuration de votre environnement de développement + Création d'un flux vidéo Kinesis + Création et empaquetage d'une fonction Lambda + Configuration de l'appareil principal Kinesis Video Streams + Déploiement sur le périphérique principal + Vérification de votre stream Suivez ces étapes pour déployer l'agent Amazon Kinesis Video Streams Edge AWS IoT Greengrass afin d'enregistrer et de télécharger du contenu multimédia à partir de caméras IP. **Topics** + [Création d'une instance Ubuntu Amazon EC2](gs-ubuntu.md) + [Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil](gs-setup-gg.md) + [Créez les Amazon Kinesis Video Streams AWS Secrets Manager et les ressources pour votre caméra IP RTSP URLs](gs-create-resources.md) + [Ajouter des autorisations au rôle de service d'échange de jetons (TES)](gs-add-permissions.md) + [Installez le composant AWS IoT Greengrass Secret Manager sur l'appareil](gs-install-secrets-manager.md) + [Déployez le composant Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sur l'appareil](gs-deploy-edge.md) + [Installez le composant du gestionnaire de AWS IoT Greengrass journaux sur l'appareil](gs-publish-edge.md) # Création d'une instance Ubuntu Amazon EC2 Procédez comme suit pour créer une instance Ubuntu Amazon EC2. **Création d'une instance Ubuntu Amazon EC2** 1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) Vérifiez que la région appropriée est sélectionnée. 1. Choisissez **Launch Instances** (Lancer les instances). Renseignez les champs suivants : + **Nom** — Entrez le nom de l'instance. + **Images d'applications et de systèmes d'exploitation (Amazon Machine Image)** : sélectionnez **Ubuntu**. + **Type d'instance** — Sélectionnez **t2.large.** + **Connexion par paire de clés** — Créez votre propre paire de clés. + **Paramètres réseau** : conservez les paramètres par défaut. + **Configuration du stockage** : augmentez le volume à 256 GiB. + **Paramètres avancés** : conservez les paramètres par défaut. 1. Lancez l'instance et utilisez-la en SSH. Procédez comme suit : 1. Sélectionnez **Instances** dans le menu de navigation de gauche, puis sélectionnez l'ID de l'instance. 1. Choisissez **Connect** en haut à droite. 1. Choisissez le **client SSH** et suivez les instructions affichées à l'écran. 1. Ouvrez un terminal et naviguez jusqu'au `.pem` fichier téléchargé (probablement dans`~/Downloads`). 1. La première fois que vous suivez ces procédures, vous recevrez le message « L'authenticité de l'hôte (...) ne peut pas être établie ». Tapez **« oui** ». 1. Installez les bibliothèques système pour intégrer l'agent Amazon Kinesis Video Streams Edge sur l'instance. ``` wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add - sudo add-apt-repository 'deb https://apt.corretto.aws stable main' sudo apt-get update sudo apt-get install -y gcc libssl-dev libcurl4-openssl-dev liblog4cplus-dev \ libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad \ gstreamer1.0-plugins-good gstreamer1.0-tools \ unzip java-11-amazon-corretto-jdk maven ``` **Important** Si un écran vous indique que certains services doivent être redémarrés, appuyez sur Entrée pour sélectionner **OK.** Pour plus d'informations, consultez le guide de l'utilisateur [https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html](https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html). # Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil Suivez ces procédures pour installer le logiciel Nucleus AWS IoT Greengrass principal sur l'instance Amazon EC2. **Configuration de l'appareil AWS IoT Greengrass principal** 1. Connectez-vous au AWS Management Console, [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Vérifiez que la région appropriée est sélectionnée. 1. Dans le menu de navigation de gauche, sélectionnez Appareils **Greengrass, Appareils** **Core**. 1. Choisissez **Configurer un appareil principal**. 1. Effectuez les étapes affichées à l'écran. + **Étape 1 : Enregistrez un appareil principal Greengrass**. Entrez le nom de l'appareil. + **Étape 2 : ajouter à un groupe d'objets pour appliquer un déploiement continu**. Sélectionnez **Aucun groupe**. + **Étape 3 : installez le logiciel Greengrass Core**. Sélectionnez **Linux**. + **Étape 3.1 : Installation de Java sur l'appareil** Java est installé dans le cadre de[Création d'une instance Ubuntu Amazon EC2](gs-ubuntu.md). Revenez à cette étape si Java n'est pas encore installé. + **Étape 3.2 : Copier les AWS informations d'identification sur l'appareil** Ouvrez l'`bash/zsh`option et collez les commandes d'exportation dans l'instance Amazon EC2. + **Étape 3.3 : Exécuter le programme d'installation** 1. Copiez et exécutez les commandes **Télécharger le programme d'installation** et **Exécuter le programme d'installation** dans l'instance Ubuntu Amazon EC2. **Note** La commande **Exécuter le programme d'installation** sera automatiquement mise à jour en fonction du nom que vous avez choisi à l'étape précédente. 1. Notez le rôle de service d'échange de jetons (TES) créé. Vous en aurez besoin ultérieurement. **Note** Par défaut, le rôle créé s'appelle **GreengrassV2 TokenExchangeRole**. # Créez les Amazon Kinesis Video Streams AWS Secrets Manager et les ressources pour votre caméra IP RTSP URLs Suivez ces procédures pour créer les flux et les secrets nécessaires dans AWS Secrets Manager. Effectuez d'abord cette étape, car vous avez besoin ARNs des ressources créées dans les politiques. ## Création d'Amazon Kinesis Video Streams Créez Amazon Kinesis Video Streams à l'aide AWS Management Console de l' AWS CLI API, ou. Dans le AWS Management Console, ouvrez la console [Amazon Kinesis Video Streams](https://console.aws.amazon.com/kinesisvideo/home/). Choisissez **Streams vidéo** dans le menu de navigation de gauche. Pour de plus amples informations, veuillez consulter [Création d'un flux vidéo Amazon Kinesis](gs-createstream.md). ## Créez des secrets dans AWS Secrets Manager Dans le AWS Management Console, ouvrez la [AWS Secrets Manager console](https://console.aws.amazon.com/secretsmanager/landing). Choisissez **Secrets** dans le menu de navigation de gauche. Vérifiez que la région appropriée est sélectionnée. 1. Choisissez **Store a new secret** (Stocker un nouveau secret). 1. **Étape 1 : Choisissez le type de secret** + Sélectionnez **Autre type de secret**. + Dans la section **Paires clé/valeur, ajoutez une paire clé-valeur**. **Clé :** `MediaURI` **Note** La clé doit être`MediaURI`. Cela distingue les majuscules et minuscules. Si vous ne le saisissez pas correctement, l'application ne fonctionne pas. **Valeur** :`Your MediaURI`. **Example** **Exemple :**`rtsp://:/YourCameraMediaURI`. 1. **Étape 2 : configurer le secret**. Donnez un nom à ce secret. Nomme-le comme tu veux. 1. **Étape 3 : Configuration de la rotation (facultatif)**. Choisissez **Suivant**. 1. **Étape 4 : Révision**. Choisissez **Stocker**. 1. Si votre secret ne s'affiche pas immédiatement, sélectionnez le bouton d'actualisation. Choisissez le nom de votre secret. Prenez note de l'**ARN secret**. 1. Répétez ce processus pour chaque MediaURI à partir duquel vous souhaitez diffuser. **Note** Le AWS réseau bloque certaines sources RTSP publiques. Vous ne pouvez pas y accéder depuis l'instance Amazon EC2 ou si vous les exécutez de manière non gérée lorsque vous êtes connecté au VPN. L'URL RTSP de votre caméra doit diffuser de la vidéo au format h.264. La durée du fragment ne doit pas dépasser la limite mentionnée dans[Quotas du SDK pour les producteurs](limits.md#producer-sdk-limits). L'agent Amazon Kinesis Video Streams Edge prend uniquement en charge la vidéo. Exécutez `gst-discoverer-1.0 Your RtspUrl` pour vous assurer que votre caméra est accessible depuis votre appareil. Enregistrez le ARNs pour tous les flux et secrets que vous avez créés. Vous en aurez besoin pour passer à l'étape suivante. # Ajouter des autorisations au rôle de service d'échange de jetons (TES) Accordez le rôle de service d'échange de jetons (TES) à l'appareil autorisé à consulter les secrets. Cela est nécessaire pour que le AWS Secrets Manager AWS IoT Greengrass composant fonctionne correctement. **Ajouter des autorisations au rôle TES** 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Choisissez **Rôles** dans le menu de navigation de gauche et recherchez le rôle TES que vous avez créé plus tôt dans le processus. 1. Dans le menu déroulant **Ajouter des autorisations**, sélectionnez **Joindre des politiques**. 1. Choisissez **Create Policy** (Créer une politique). 1. Faites défiler l'écran vers le bas et sélectionnez **Modifier**. 1. Dans l'éditeur de stratégie, choisissez **JSON** et modifiez la politique. Remplacez la politique par la suivante : **Note** Remplacez `arn:aws:kinesisvideo:*:*:stream/streamName1/*` et `arn:aws:kinesisvideo:*:*:stream/streamName2/*` par le ARNs pour les flux que vous avez créés à l'étape précédente. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kinesisvideo:ListStreams" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "kinesisvideo:DescribeStream", "kinesisvideo:PutMedia", "kinesisvideo:TagStream", "kinesisvideo:GetDataEndpoint" ], "Resource": [ "arn:aws:kinesisvideo:*:*:stream/streamName1/*", "arn:aws:kinesisvideo:*:*:stream/streamName2/*" ] } ] } ``` ------ 1. Sur la page **Add tags** (Ajouter des identifications), choisissez **Next: Review** (Suivant : Révision). 1. Donnez un nom à votre politique, puis choisissez **Créer une politique**. Un exemple de nom de politique est **KvsEdgeAccessPolicy**. 1. Fermez l'onglet et revenez à l'onglet dans lequel vous associiez une politique au rôle TES. Cliquez sur le bouton d'actualisation, puis recherchez la politique nouvellement créée. Cochez la case et choisissez **Joindre les politiques**. Sur l'écran suivant, vous voyez une note indiquant que la **politique a été correctement attachée au rôle.** 1. Créez et joignez une autre politique, cette fois pour vos secrets. Remplacez la politique par la suivante : **Note** `arn:aws:secretsmanager:*:*:secret:*`Remplacez-le par celui ARNs contenant les secrets MediaURI que vous avez créés dans. [Créez les Amazon Kinesis Video Streams AWS Secrets Manager et les ressources pour votre caméra IP RTSP URLs](gs-create-resources.md) ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": [ "arn:aws:secretsmanager:*:*:secret:*", "arn:aws:secretsmanager:*:*:secret:*" ] } ] } ``` ------ 1. Créez et attachez une autre politique, cette fois pour les Amazon CloudWatch métriques. Remplacez la politique par la suivante : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData" ], "Resource": [ "*" ] } ] } ``` ------ # Installez le composant AWS IoT Greengrass Secret Manager sur l'appareil L'agent Amazon Kinesis Video Streams Edge nécessite que AWS IoT Greengrass le composant Secret Manager soit d'abord installé sur l'appareil. **Installation du composant Secret Manager** 1. Connectez-vous à la AWS IoT Core console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Vérifiez que la région appropriée est sélectionnée. 1. **Dans le menu de navigation de gauche, sélectionnez **Appareils Greengrass**, Déploiements.** Choisissez le déploiement avec le même objectif que celui dans lequel nous l'avons créé[Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil](gs-setup-gg.md). 1. Dans le menu déroulant **Actions** en haut à droite, sélectionnez **Réviser**. Dans la fenêtre contextuelle qui apparaît, choisissez **Revise le déploiement**. 1. Complétez les sections suivantes : + **Étape 1 : Spécifiez la cible**. Choisissez **Suivant**. + **Étape 2 : Sélectionnez les composants**. + Vérifiez que le composant **AWS.Greengrass.cli** est sélectionné. Ne désinstallez pas ce composant. + Activez le bouton **Afficher uniquement les composants sélectionnés** et recherchez **aws.greengrass. SecretManager**. + Cochez la case à côté de **aws.greengrass. SecretManager**, puis choisissez **Next**. + **Étape 3 : Configuration des composants**. Configurez le composant AWS IoT Greengrass Secret Manager pour télécharger les secrets depuis l' AWS IoT Greengrass environnement. Sélectionnez **aws.greengrass. SecretManager**composant, puis choisissez **Configurer le composant**. Dans l'écran qui apparaît, mettez à jour le AWS Secrets Manager ARNs dans la zone **Configuration pour fusionner**. **Note** `arn:aws:secretsmanager:*:*:secret:*`Remplacez-le par ARNs les secrets que vous avez créés dans[Créez les Amazon Kinesis Video Streams AWS Secrets Manager et les ressources pour votre caméra IP RTSP URLs](gs-create-resources.md). ``` { "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:*:*:secret:*" }, { "arn": "arn:aws:secretsmanager:*:*:secret:*" } ] } ``` **Note** `cloudSecrets`est une liste d'objets avec la clé`arn`. Pour plus d'informations, consultez la section relative à la [configuration du gestionnaire secret](https://docs.aws.amazon.com//greengrass/v2/developerguide/secret-manager-component.html#secret-manager-component-configuration) dans le guide du AWS IoT Greengrass Version 2 développeur. Lorsque vous avez terminé, sélectionnez **Confirmer**, puis **Suivant**. + **Étape 4 : configurer les paramètres avancés**. Sélectionnez **Suivant**. + **Étape 5 : Révision**. Sélectionnez **Deploy (Déployer)**. 1. Vérifiez que le AWS Secrets Manager composant et les autorisations ont été correctement installés. Sur l'instance Amazon EC2 d'Ubuntu, tapez `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.SecretManager` pour vérifier que le composant a reçu la configuration mise à jour. 1. Inspectez les AWS IoT Greengrass principaux journaux. Tapez `sudo less /greengrass/v2/logs/greengrass.log`. Vérifiez les erreurs de déploiement. En cas d'erreur, revoyez le déploiement pour supprimer le `aws.greengrass.SecretManager` composant. Tapez `sudo service greengrass restart` pour redémarrer le service AWS IoT Greengrass principal. Si l'erreur de déploiement est liée à des autorisations manquantes, consultez la [Ajouter des autorisations au rôle de service d'échange de jetons (TES)](gs-add-permissions.md) section pour vous assurer que le rôle TES dispose des autorisations appropriées. Ensuite, répétez cette section. 1. **Mettre à jour les secrets du composant AWS IoT Greengrass Secret Manager** **Important** Le composant AWS IoT Greengrass Secret Manager récupère et met en cache les secrets uniquement lorsque le déploiement est mis à jour. Pour mettre à jour les secrets du composant AWS IoT Greengrass Secret Manager, suivez les étapes 1 à 6 précédentes, avec les modifications suivantes. **Étape 3 : Configuration des composants**. Configurez le composant AWS IoT Greengrass Secret Manager pour télécharger les secrets depuis l' AWS IoT Greengrass environnement. Sélectionnez **aws.greengrass. SecretManager**composant, puis choisissez **Configurer le composant**. Dans l'écran qui apparaît, collez `[""]` la zone **Réinitialiser les chemins** et mettez-la à jour AWS Secrets Manager ARNs dans la zone **Configuration pour fusionner**. Pour plus d'informations, voir [Réinitialiser les mises à jour](https://docs.aws.amazon.com//greengrass/v2/developerguide/update-component-configurations.html#reset-configuration-update). # Déployez le composant Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sur l'appareil Procédez comme suit pour déployer le composant Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sur l'appareil : **Déployer le composant** 1. Téléchargez le `tar` fichier à l'aide du lien fourni. Si vous avez rempli le formulaire d'intérêt pour Amazon Kinesis Video Streams Edge Agent, consultez vos e-mails pour trouver le lien de téléchargement. Si vous n'avez pas rempli le formulaire, complétez-le [ici](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html). 1. Vérifiez le checksum. 1. Extrayez les fichiers binaires et le fichier jar de votre appareil. Type :`tar -xvf kvs-edge-agent.tar.gz`. Après l'extraction, la structure de vos dossiers ressemblera à ce qui suit : ``` kvs-edge-agent/LICENSE kvs-edge-agent/THIRD-PARTY-LICENSES kvs-edge-agent/pom.xml kvs-edge-agent/KvsEdgeComponent kvs-edge-agent/KvsEdgeComponent/recipes kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml kvs-edge-agent/KvsEdgeComponent/artifacts kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/edge_log_config kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/kvs-edge-agent.jar kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libgstkvssink.so kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libIngestorPipelineJNI.so kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libcproducer.so kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libKinesisVideoProducer.so ``` **Note** Le nom du dossier de version doit être configuré de manière à refléter le dernier numéro de version binaire. Par exemple, le nom du dossier d'une version 1.0.0 sera défini comme 1.0.0. 1. Créez le fichier jar de dépendances. **Note** Le fichier jar inclus dans le kvs-edge-agent fichier .tar.gz ne contient pas les dépendances. Suivez les étapes ci-dessous pour créer ces bibliothèques. Accédez au `kvs-edge-agent` dossier qui contient`pom.xml`. Tapez `mvn clean package`. Cela générera un fichier jar contenant les dépendances requises par l'agent Amazon Kinesis Video Streams Edge. `kvs-edge-agent/target/libs.jar` 1. Placez le fichier libs.jar dans le dossier contenant les artefacts du composant. Tapez `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/`. 1. **Facultatif**. Configurez les propriétés. L'agent Amazon Kinesis Video Streams Edge accepte les variables d'environnement suivantes AWS IoT Greengrass en mode : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kinesisvideostreams/latest/dg/gs-deploy-edge.html) Ouvrez `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` et modifiez le script d'exécution pour ajouter l'une des variables d'environnement précédentes. **Important** Assurez-vous que le script d'exécution modifié ne contient aucun caractère de **tabulation**. Le logiciel AWS IoT Greengrass principal ne pourra pas lire la recette. 1. Déployez le composant Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent. Type : ``` sudo /greengrass/v2/bin/greengrass-cli deployment create \ --recipeDir /kvs-edge-agent/KvsEdgeComponent/recipes/ \ --artifactDir /kvs-edge-agent/KvsEdgeComponent/artifacts/ \ --merge "aws.kinesisvideo.KvsEdgeComponent=EdgeAgentVersion" ``` Pour plus d'informations, consultez les sections suivantes du *guide du AWS IoT Greengrass Version 2 développeur* : + [AWS IoT Greengrass Commandes CLI](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html) + [Déployer AWS IoT Greengrass des composants sur des appareils](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html) 1. Envoyez les configurations à l'application à l'aide du AWS CLI. 1. Créez un nouveau fichier,`example-edge-configuration.json`. Collez le code suivant dans le fichier. Il s'agit d'un exemple de configuration qui enregistre tous les jours de 9 h 00 à 16 h 59 min 59 s (en fonction de l'heure système de votre appareil). AWS IoT Il télécharge également les médias enregistrés tous les jours de 19 h 00 à 21 h 59 min 59 s 59. Pour de plus amples informations, veuillez consulter [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md). ``` { "StreamARN": "arn:aws:kinesisvideo:your-region:your-account-id:stream/your-stream/0123456789012", "EdgeConfig": { "HubDeviceArn": "arn:aws:iot:your-region:your-account-id:thing/kvs-edge-agent-demo", "RecorderConfig": { "MediaSourceConfig": { "MediaUriSecretArn": "arn:aws:secretsmanager:your-region:your-account-id:secret:your-secret-dRbHJQ", "MediaUriType": "RTSP_URI" }, "ScheduleConfig": { "ScheduleExpression": "0 0 9,10,11,12,13,14,15,16 ? * * *", "DurationInSeconds": 3599 } }, "UploaderConfig": { "ScheduleConfig": { "ScheduleExpression": "0 0 19,20,21 ? * * *", "DurationInSeconds": 3599 } }, "DeletionConfig": { "EdgeRetentionInHours": 15, "LocalSizeConfig": { "MaxLocalMediaSizeInMB": 2800, "StrategyOnFullSize": "DELETE_OLDEST_MEDIA" }, "DeleteAfterUpload": true } } } ``` 1. Entrez ce qui suit AWS CLI pour envoyer le fichier à l'agent Amazon Kinesis Video Streams Edge : ``` aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json" ``` 1. Répétez l'étape précédente pour chaque flux pour l'agent Amazon Kinesis Video Streams Edge. # Installez le composant du gestionnaire de AWS IoT Greengrass journaux sur l'appareil **Note** Soyez conscient des [CloudWatchquotas](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html). Suivez ces procédures pour configurer les journaux de l'agent Amazon Kinesis Video Streams Edge afin qu'ils soient automatiquement téléchargés CloudWatch à l'aide AWS IoT Greengrass du composant du gestionnaire de journaux. Il s'agit d'une étape facultative. **Installation du composant du gestionnaire de AWS IoT Greengrass journaux** 1. Vérifiez que le rôle de l' AWS IoT Greengrass appareil dispose des [autorisations appropriées](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-requirements). 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Cliquez sur **Rôles** dans le menu de navigation de gauche. 1. Choisissez le nom du rôle TES créé dans[Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil](gs-setup-gg.md). Utilisez la barre de recherche si nécessaire. 1. Sélectionnez la `GreengrassV2TokenExchangeRoleAccess` politique. 1. Sélectionnez l'onglet JSON et vérifiez que la politique ressemble à ce qui suit : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams", "s3:GetBucketLocation" ], "Resource": "*" } ] } ``` ------ 1. Si la `GreengrassV2TokenExchangeRoleAccess` politique n'existe pas ou si certaines autorisations requises sont manquantes, créez une nouvelle stratégie IAM avec ces autorisations et associez-la au rôle TES créé dans[Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil](gs-setup-gg.md). 1. Connectez-vous à la AWS IoT Core console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Vérifiez que la région appropriée est sélectionnée. 1. **Dans le menu de navigation de gauche, sélectionnez **Appareils Greengrass**, Déploiements.** Choisissez le déploiement avec le même objectif que celui dans lequel vous l'avez créé[Configurer le périphérique AWS IoT Greengrass V2 principal sur l'appareil](gs-setup-gg.md). 1. Dans le coin supérieur droit, sélectionnez **Actions**, puis sélectionnez **Réviser**. Dans la fenêtre contextuelle qui apparaît, choisissez **Revise le déploiement**. 1. Complétez les sections suivantes : 1. **Étape 1 : Spécifiez la cible.** Choisissez **Suivant**. 1. **Étape 2 : Sélectionnez les composants.** 1. **Vérifiez que le composant **AWS.Greengrass.cli et aws.greengrass.** SecretManager**les composants sont toujours sélectionnés. **Important** Ne désinstallez pas ces composants. 1. Activez le bouton **Afficher uniquement les composants sélectionnés** et recherchez **aws.greengrass. LogManager**. 1. Cochez la case à côté de **aws.greengrass. LogManager**, puis choisissez **Next**. 1. **Étape 3 : Configuration des composants.** Configurez le composant du gestionnaire de AWS IoT Greengrass journaux pour télécharger les journaux générés par l'agent Amazon Kinesis Video Streams Edge. Sélectionnez **aws.greengrass. LogManager**composant, puis choisissez **Configurer le composant**. Dans l'écran qui apparaît, collez la configuration suivante du gestionnaire de journaux dans la zone **Configuration à fusionner**. ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "aws.kinesisvideo.KvsEdgeComponent/java_kvs.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "java_kvs.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_edge.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvs_edge.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvssink.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvssink.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_streams.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvs_streams.log\\w*" } } }, "periodicUploadIntervalSec": "1" } ``` **Important** `logFileDirectoryPath`Dans la configuration précédente, on suppose que l'emplacement de sortie de journalisation par défaut est utilisé. **Note** Pour plus d'informations sur chacun des paramètres de configuration du gestionnaire de journaux, consultez la section [Gestionnaire de journaux](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration) du guide du AWS IoT Greengrass Version 2 développeur. Lorsque vous avez terminé, sélectionnez **Confirmer**, puis **Suivant**. 1. **Étape 4 : configurer les paramètres avancés.** Sélectionnez **Suivant**. 1. **Étape 5 : Révision.** Sélectionnez **Deploy (Déployer)**. 1. Vérifiez que le composant du gestionnaire de AWS journaux et les autorisations ont été correctement installés. 1. Sur l'instance Amazon EC2 d'Ubuntu, tapez `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.LogManager` pour vérifier que le composant a reçu la configuration mise à jour. 1. Inspectez les AWS IoT Greengrass principaux journaux. Tapez `sudo less /greengrass/v2/logs/greengrass.log`. Vérifiez les erreurs de déploiement. En cas d'erreur, revoyez le déploiement pour supprimer le `aws.greengrass.LogManager` composant. Tapez `sudo service greengrass restart` pour redémarrer le service AWS IoT Greengrass principal. Si l'erreur de déploiement est liée à des autorisations manquantes, vérifiez [Ajouter des autorisations au rôle de service d'échange de jetons (TES)](gs-add-permissions.md) que le rôle TES dispose des autorisations appropriées. Ensuite, répétez cette section.