

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 le composant Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sur l'appareil
<a name="gs-deploy-edge"></a>

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 <download location>/kvs-edge-agent/KvsEdgeComponent/recipes/ \
     --artifactDir <download location>/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.