View a markdown version of this page

Déployez l'agent Amazon Kinesis Video Streams Edge AWS IoT Greengrass composant de l'appareil - Amazon Kinesis Video Streams

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 AWS IoT Greengrass composant de l'appareil

Procédez comme suit pour déployer le AWS IoT Greengrass composant Amazon Kinesis Video Streams Edge 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 votre e-mail pour accéder au lien de téléchargement. Si vous n'avez pas rempli le formulaire, complétez-le ici.

  2. Vérifiez la somme de contrôle.

  3. Extrayez les fichiers binaires et le fichier jar de votre appareil.

    Type :tar -xvf kvs-edge-agent.tar.gz.

    Après 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 publication 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 sur 1.0.0.

  4. Créez le fichier jar des dépendances.

    Note

    Le fichier jar inclus dans le fichier kvs-edge-agent.tar.gz ne possède 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érera un fichier jar contenant les dépendances dont l'agent Amazon Kinesis Video Streams Edge a besoin. kvs-edge-agent/target/libs.jar

  5. Placez le fichier libs.jar dans le dossier contenant les artefacts du composant.

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

  6. Facultatif. Configurez les propriétés. L'agent Amazon Kinesis Video Streams Edge accepte les variables d'environnement suivantes en AWS IoT Greengrass mode :

    Nom de la variable d'environnement Obligatoire Description

    AWS_REGION

    Oui

    La région qui est utilisée.

    Exemple : us-west-2

    AWS IoT Greengrass Le logiciel principal définit automatiquement cette valeur pour vous. Pour plus d'informations, consultez la rubrique de référence sur les variables d'environnement Component dans le Guide du AWS IoT Greengrass Version 2 développeur.

    GST_PLUGIN_PATH

    Oui

    Chemin du fichier pointant vers le dossier contenant les bibliothèques gstkvssink et les bibliothèques IngestorPipelineJNI dépendantes de la plate-forme. Cela permet à GStreamer de charger ces plugins. Pour de plus amples informations, veuillez consulter Téléchargez, créez et configurez l'élément GStreamer.

    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 et dépendantes de la KinesisVideoProducer plate-forme.

    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 des statistiques de santé des tâches sur Amazon CloudWatch.

    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 d'enregistrement des sorties de l'agent Edge d'Amazon Kinesis Video Streams.

    Valeurs acceptées :

    • OFF

    • ALL

    • FATAL

    • ERROR

    • WARN

    • INFO, par défaut, si elle n'est pas fournie

    • DEBUG

    • TRACE

    Exemple : INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    Non

    Une fois que le fichier journal atteint cette taille, un survol se produit.

    • Minimum : 1

    • Maximum : 100

    • 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 reconduits à 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 média enregistré sera écrit. La valeur par défaut est le répertoire actuel s'il n'est pas fourni.

    Exemple : /file/path/

    GREENGRASS_ROOT_DIRECTORY

    Non

    Le chemin du fichier vers le répertoire AWS IoT Greengrass racine.

    Cette valeur est définie par défaut /greengrass/v2/ si elle n'est pas fournie.

    Exemple : /file/path/

    GST_DEBUG

    Non

    Spécifie le niveau des journaux GStreamer à sortir. Pour plus d'informations, consultez la documentation de GStreamer.

    Exemple : 0

    GST_DEBUG_FILE

    Non

    Spécifie le fichier de sortie des journaux de débogage de GStreamer. S'il n'est pas défini, les journaux de débogage génèrent une erreur standard. Pour plus d'informations, consultez la documentation de GStreamer.

    Exemple : /tmp/gstreamer-logging.log

    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 sera pas en mesure de lire la recette.

  7. Déployez le AWS IoT Greengrass composant Amazon Kinesis Video Streams Edge 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  :

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

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

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