

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.

# Création de l'agent Amazon Kinesis Video Streams Edge
<a name="gs-build-agent"></a>

**Création de l'agent Amazon Kinesis Video Streams Edge**

1. Téléchargez le `tar` fichier en utilisant le lien qui vous a été 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 avec le `kvs-edge-agent.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ère un fichier jar contenant les dépendances requises par l'agent Amazon Kinesis Video Streams Edge. `kvs-edge-agent/target/libs.jar`

1. `libs.jar`Placez-le dans le dossier contenant les artefacts du composant.

   Tapez `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}/`.

1. Définissez les variables d'environnement à l'aide des valeurs des étapes précédentes. Le tableau suivant décrit les variables.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/kinesisvideostreams/latest/dg/gs-build-agent.html)

1.  GStreamer Videz le cache. Type :

   ```
   rm ~/.cache/gstreamer-1.0/registry.{{your-os-architecture}}.bin
   ```

   Pour plus d'informations, consultez la [documentation GStreamer du registre](https://gstreamer.freedesktop.org/documentation/gstreamer/gstregistry.html?gi-language=c).

1. Préparez et exécutez la commande Java. L'agent Amazon Kinesis Video Streams Edge accepte les arguments suivants :    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/kinesisvideostreams/latest/dg/gs-build-agent.html)

   Pour les définir, ajoutez-les `-D{{java-property-name}}={{value}}` à la commande java utilisée pour exécuter le fichier jar.

   Par exemple :

   ```
   java -Djava.library.path=/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}} \
     --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \
     -Dio.netty.tryReflectionSetAccessible=true \
     -cp kvs-edge-agent.jar:libs.jar \
     com.amazonaws.kinesisvideo.edge.controller.ControllerApp
   ```
**Important**  
Exécutez la commande java ci-dessus depuis le même répertoire que`/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}`.

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. Pour envoyer le fichier à l'agent Amazon Kinesis Video Streams Edge, saisissez ce qui suit dans AWS CLI le champ :

      ```
      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.