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

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.

2. Vérifiez le checksum.

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

4. 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 contientpom.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

5. libs.jarPlacez-le dans le dossier contenant les artefacts du composant.

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

6. Définissez les variables d'environnement à l'aide des valeurs des étapes précédentes. Le tableau suivant décrit les variables.

   Nom de la variable d'environnement	Obligatoire	Description
   AWS_REGION	Oui	Région utilisée. Exemple : us-west-2
   AWS_IOT_CA_CERT	Oui	Chemin du fichier vers le certificat CA utilisé pour établir la confiance avec le service principal via TLS. Exemple : /file/path/to/AmazonRootCA1.pem
   AWS_IOT_CORE_CERT	Oui	Chemin du fichier vers le certificat X.509. Exemple : /file/path/to/certificateID-certificate.pem.crt
   AWS_IOT_CORE_CREDENTIAL_ENDPOINT	Oui	Le point de terminaison AWS IoT Core du fournisseur d'informations d'identification pour votre AWS compte. Exemple : credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_DATA_ATS_ENDPOINT	Oui	Le point de terminaison du plan de AWS IoT Core données de votre AWS compte. Exemple : data-account-specific-prefix.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_PRIVATE_KEY	Oui	Chemin du fichier vers la clé privée utilisée dans la paire de clés publique/privée. Pour plus d'informations, consultez la section Gestion des clés dans AWS IoT. Exemple : /file/path/to/certificateID-private.pem.key
   AWS_IOT_CORE_ROLE_ALIAS	Oui	Nom de l'alias de rôle pointant vers le rôle AWS IAM à utiliser lors de la connexion. AWS IoT Core Exemple : kvs-edge-role-alias
   AWS_IOT_CORE_THING_NAME	Oui	Nom de l' AWS IoT objet sur lequel l'application est exécutée. Exemple : my-edge-device-thing
   GST_PLUGIN_PATH	Oui	Chemin du fichier pointant vers le dossier contenant les bibliothèques dépendantes de la IngestorPipelineJNI plate-forme gstkvssink et de celle-ci. GStreamer Chargons ces plugins. Pour de plus amples informations, veuillez consulter Téléchargez, créez et configurez l' GStreamer élément. Exemple : /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/
   LD_LIBRARY_PATH	Oui	Chemin du fichier pointant vers le répertoire contenant les bibliothèques cproducer dépendantes de la KinesisVideoProducer plate-forme et Exemple : /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/
   AWS_KVS_EDGE_CLOUDWATCH_ENABLED	Non	Détermine si l'agent Amazon Kinesis Video Streams Edge publiera les indicateurs Amazon CloudWatch de santé au travail sur. Valeurs acceptées :TRUE/FALSE(sans distinction majuscules/minuscules). La valeur par défaut est FALSE si elle n'est pas fournie. Exemple : FAUX
   AWS_KVS_EDGE_LOG_LEVEL	Non	Niveau de journalisation des sorties de l'agent Amazon Kinesis Video Streams Edge. Valeurs acceptées : OFF ALL FATAL ERROR WARN INFO, par défaut, s'il n'est pas fourni DEBUG TRACE Exemple : INFO
   AWS_KVS_EDGE_LOG_MAX_FILE_SIZE	Non	Une fois que le fichier journal atteint cette taille, un roulement se produit. Minimum : 0 Maximum : 10000 Par défaut : 20, s'il n'est pas fourni Unités : mégaoctets (Mo) Exemple : 5
   AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY	Non	Le chemin du fichier pointant vers le répertoire dans lequel les journaux de l'agent Amazon Kinesis Video Streams Edge sont générés. La valeur par défaut est ./log si elle n'est pas fournie. Exemple : /file/path/
   AWS_KVS_EDGE_LOG_ROLLOVER_COUNT	Non	Le nombre de journaux reportés à conserver avant de les supprimer. Minimum : 1 Maximum : 100 Par défaut : 10, s'il n'est pas fourni Exemple : 20
   AWS_KVS_EDGE_RECORDING_DIRECTORY	Non	Le chemin du fichier pointant vers le répertoire dans lequel le support enregistré sera écrit. La valeur par défaut est le répertoire actuel s'il n'est pas fourni. Exemple : /file/path/
   GST_DEBUG	Non	Spécifie le niveau des GStreamer journaux à générer. Pour plus d’informations, consultez la documentation GStreamer . Exemple : 0
   GST_DEBUG_FILE	Non	Spécifie le fichier de sortie des journaux de GStreamer débogage. S'ils ne sont pas définis, les journaux de débogage affichent une erreur standard. Pour plus d’informations, consultez la documentation GStreamer . Exemple : /tmp/gstreamer-logging.log

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

8. Préparez et exécutez la commande Java. L'agent Amazon Kinesis Video Streams Edge accepte les arguments suivants :

   Nom de propriété Java	Obligatoire	Description
   java.library.path	Non	Chemin du fichier pointant vers le dossier contenant gstkvssink les bibliothèques IngestorPipelineJNI dépendantes. S'ils ne sont pas fournis, l'agent Amazon Kinesis Video Streams Edge les recherchera dans le répertoire actuel. Important L'agent Amazon Kinesis Video Streams Edge ne fonctionnera pas correctement s'il ne parvient pas à localiser ces fichiers. Exemple : /file/path/

   Pour les définir, ajoutez-les -Djava-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.

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

      {
          "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
              }
          }
      }

   2. 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"

10. Répétez l'étape précédente pour chaque flux pour l'agent Amazon Kinesis Video Streams Edge.