View a markdown version of this page

Menyebarkan Agen Edge Streaming Video Amazon Kinesis AWS IoT Greengrass komponen pada perangkat - Amazon Kinesis Video Streams

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menyebarkan Agen Edge Streaming Video Amazon Kinesis AWS IoT Greengrass komponen pada perangkat

Lakukan hal berikut untuk menerapkan AWS IoT Greengrass komponen Amazon Kinesis Video Streams Edge Agent pada perangkat:

Menyebarkan komponen

  1. Unduh tar file menggunakan tautan yang disediakan.

    Jika Anda mengisi formulir minat Amazon Kinesis Video Streams Edge Agent, periksa email Anda untuk tautan unduhan. Jika Anda belum mengisi formulir, lengkapi di sini.

  2. Verifikasi checksum.

  3. Ekstrak binari dan toples di perangkat Anda.

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

    Setelah ekstraksi, struktur folder Anda akan terlihat seperti berikut:

    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
    catatan

    Nama folder rilis harus diatur dengan cara yang mencerminkan nomor rilis biner terbaru. Misalnya, rilis 1.0.0 akan memiliki nama folder yang ditetapkan sebagai 1.0.0.

  4. Bangun jar dependensi.

    catatan

    Toples yang disertakan dengan kvs-edge-agent.tar.gz tidak memiliki dependensi. Gunakan langkah-langkah berikut untuk membangun perpustakaan tersebut.

    Arahkan ke kvs-edge-agent folder yang berisipom.xml.

    Ketik mvn clean package.

    Ini akan menghasilkan file jar yang berisi dependensi yang dibutuhkan Amazon Kinesis Video Streams Edge Agent di. kvs-edge-agent/target/libs.jar

  5. Tempatkan libs.jar ke dalam folder yang berisi artefak komponen.

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

  6. Opsional. Konfigurasikan properti. Amazon Kinesis Video Streams Edge Agent menerima variabel lingkungan berikut dalam AWS IoT Greengrass mode:

    Nama Variabel Lingkungan Diperlukan Deskripsi

    AWS_REGION

    Ya

    wilayah yang digunakan.

    Contoh: us-west-2

    AWS IoT Greengrass Perangkat lunak inti secara otomatis menetapkan nilai ini untuk Anda. Untuk informasi selengkapnya, lihat topik referensi variabel lingkungan Komponen di Panduan AWS IoT Greengrass Version 2 Pengembang.

    GST_PLUGIN_PATH

    Ya

    Jalur file menunjuk ke folder yang berisi pustaka yang gstkvssink IngestorPipelineJNI bergantung pada platform. Ini memungkinkan GStreamer memuat plugin ini. Untuk informasi selengkapnya, lihat Unduh, buat, dan konfigurasikan elemen GStreamer.

    Contoh: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/

    LD_LIBRARY_PATH

    Ya

    Jalur file menunjuk ke direktori yang berisi pustaka yang cproducer KinesisVideoProducer bergantung pada platform.

    Contoh: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/

    AWS_KVS_EDGE_CLOUDWATCH_ENABLED

    Tidak

    Menentukan apakah Amazon Kinesis Video Streams Edge Agent akan memposting metrik kesehatan pekerjaan ke Amazon CloudWatch.

    Nilai yang diterima:TRUE/FALSE(case insensitive). Defaultnya FALSE jika tidak disediakan.

    Contoh: SALAH

    AWS_KVS_EDGE_LOG_LEVEL

    Tidak

    Tingkat pencatatan keluaran Amazon Kinesis Video Streams Edge Agent.

    Nilai yang diterima:

    • MATI

    • SEMUA

    • FATAL

    • ERROR

    • WARN

    • INFO, default, jika tidak disediakan

    • DEBUG

    • JEJAK

    Contoh: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    Tidak

    Setelah file log mencapai ukuran ini, rollover akan terjadi.

    • Min: 1

    • Maks: 100

    • Default: 20, jika tidak disediakan

    • Unit: Megabyte (MB)

    Contoh 5:

    AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY

    Tidak

    Jalur file yang menunjuk ke direktori tempat log Agen Edge Amazon Kinesis Video Streams dikeluarkan. Defaultnya ./log jika tidak disediakan.

    Contoh: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    Tidak

    Jumlah log rolled-over yang harus disimpan sebelum dihapus.

    • Min: 1

    • Maks: 100

    • Default: 10, jika tidak disediakan

    Contoh: 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    Tidak

    Jalur file yang menunjuk ke direktori media yang direkam akan ditulis. Defaultnya ke direktori saat ini jika tidak disediakan.

    Contoh: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    Tidak

    Jalur file ke direktori AWS IoT Greengrass root.

    Ini default /greengrass/v2/ jika tidak disediakan.

    Contoh: /file/path/

    GST_DEBUG

    Tidak

    Menentukan tingkat log GStreamer untuk keluaran. Untuk informasi selengkapnya, lihat dokumentasi GStreamer.

    Contoh: 0

    GST_DEBUG_FILE

    Tidak

    Menentukan file output dari log debug GStreamer. Jika tidak disetel, log debug mendapatkan output ke kesalahan standar. Untuk informasi selengkapnya, lihat dokumentasi GStreamer.

    Contoh: /tmp/gstreamer-logging.log

    Buka kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml dan ubah skrip run untuk menambahkan salah satu variabel lingkungan sebelumnya.

    penting

    Pastikan skrip run yang dimodifikasi tidak berisi karakter tab apa pun. Perangkat lunak AWS IoT Greengrass inti tidak akan dapat membaca resepnya.

  7. Terapkan AWS IoT Greengrass komponen Amazon Kinesis Video Streams Edge Agent.

    Jenis:

    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"

    Untuk informasi tambahan, lihat bagian berikut di Panduan Peng AWS IoT Greengrass Version 2 embang:

  8. Kirim konfigurasi ke aplikasi menggunakan AWS CLI.

    1. Buat file baru,example-edge-configuration.json.

      Tempel kode berikut ke file. Ini adalah konfigurasi sampel yang merekam setiap hari dari pukul 09:00:00 hingga 16:59:59 (sesuai dengan waktu sistem di perangkat Anda). AWS IoT Ini juga mengunggah media rekaman setiap hari dari 19:00:00 sampai 21:59:59.

      Untuk informasi selengkapnya, lihat 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. Ketik berikut ini AWS CLI untuk mengirim file ke Amazon Kinesis Video Streams Edge Agent:

      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"

  9. Ulangi langkah sebelumnya untuk setiap aliran untuk Amazon Kinesis Video Streams Edge Agent.