Konektor tepi untuk Kinesis Video Streams - AWS IoT Greengrass

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

Konektor tepi untuk Kinesis Video Streams

Konektor tepi untuk aws.iot.EdgeConnectorForKVS komponen Kinesis Video Streams () membaca umpan video dari kamera lokal dan menerbitkan aliran ke Kinesis Video Streams. Anda dapat mengonfigurasi komponen ini untuk membaca umpan video dari kamera Internet Protocol (IP) menggunakan Real Time Streaming Protocol (RTSP). Kemudian, Anda dapat mengatur dasbor di Grafana Terkelola Amazon atau server Grafana lokal untuk memantau dan berinteraksi dengan aliran video.

Anda dapat mengintegrasikan komponen ini AWS IoT TwinMaker untuk menampilkan dan mengontrol aliran video di dasbor Grafana. AWS IoT TwinMaker adalah AWS layanan yang memungkinkan Anda membangun kembar digital operasional sistem fisik. Anda dapat menggunakan AWS IoT TwinMaker untuk memvisualisasikan data dari sensor, kamera, dan aplikasi perusahaan bagi Anda untuk melacak pabrik fisik, bangunan, atau pabrik industri Anda. Anda juga dapat menggunakan data ini untuk memantau operasi, mendiagnosis kesalahan, dan memperbaiki kesalahan. Untuk informasi lebih lanjut, lihat Apa AWS IoT TwinMaker? dalam AWS IoT TwinMaker Panduan Pengguna.

Komponen ini menyimpan konfigurasinya diAWS IoT SiteWise, yang merupakan AWS layanan yang memodelkan dan menyimpan data industri. DalamAWS IoT SiteWise, aset mewakili objek seperti perangkat, peralatan, atau kelompok objek lain. Untuk mengonfigurasi dan menggunakan komponen ini, Anda membuat AWS IoT SiteWise aset untuk setiap perangkat inti Greengrass dan untuk setiap kamera IP yang terhubung ke setiap perangkat inti. Setiap aset memiliki properti yang Anda konfigurasikan untuk mengontrol fitur, seperti streaming langsung, unggahan sesuai permintaan, dan caching lokal. Untuk menentukan URL untuk setiap kamera, Anda membuat rahasia AWS Secrets Manager yang berisi URL kamera. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Kemudian, Anda menentukan rahasia itu di properti aset untuk kamera IP.

Komponen ini mengunggah aliran video setiap kamera ke aliran video Kinesis. Anda menentukan nama aliran video Kinesis tujuan dalam konfigurasi AWS IoT SiteWise aset untuk setiap kamera. Jika aliran video Kinesis tidak ada, komponen ini membuatnya untuk Anda.

AWS IoT TwinMaker menyediakan skrip yang dapat Anda jalankan untuk membuat AWS IoT SiteWise aset dan rahasia Secrets Manager ini. Untuk informasi selengkapnya tentang cara membuat sumber daya ini, serta cara menginstal, mengonfigurasi, dan menggunakan komponen ini, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

catatan

Konektor tepi untuk komponen Kinesis Video Streams hanya tersedia dalam hal berikut: Wilayah AWS

  • US East (N. Virginia)

  • US West (Oregon)

  • Europe (Frankfurt)

  • Europe (Ireland)

  • Asia Pacific (Singapore)

Versi

Komponen ini memiliki versi berikut:

  • 1.0.x

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini hanya dapat diinstal pada perangkat inti Linux.

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Anda dapat menerapkan komponen ini hanya ke perangkat inti tunggal, karena konfigurasi komponen harus unik untuk setiap perangkat inti. Anda tidak dapat menerapkan komponen ini ke grup perangkat inti.

  • GStreamer 1.18.4 atau yang lebih baru diinstal pada perangkat inti. Untuk informasi selengkapnya, lihat Menginstal GStreamer.

    Pada perangkat denganapt, Anda dapat menjalankan perintah berikut untuk menginstal GStreamer.

    sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools
  • AWS IoT SiteWiseAset untuk setiap perangkat inti. AWS IoT SiteWiseAset ini mewakili perangkat inti. Untuk informasi selengkapnya tentang cara membuat aset ini, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

  • AWS IoT SiteWiseAset untuk setiap kamera IP yang Anda sambungkan ke setiap perangkat inti. AWS IoT SiteWiseAset ini mewakili kamera yang mengalirkan video ke setiap perangkat inti. Setiap aset kamera harus dikaitkan dengan aset untuk perangkat inti yang terhubung ke kamera. Aset kamera memiliki properti yang dapat Anda konfigurasikan untuk menentukan aliran video Kinesis, rahasia otentikasi, dan parameter streaming video. Untuk informasi selengkapnya tentang cara membuat dan mengonfigurasi aset kamera, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

  • AWS Secrets ManagerRahasia untuk setiap kamera IP. Rahasia ini harus mendefinisikan pasangan kunci-nilai, di mana kuncinyaRTSPStreamUrl, dan nilainya adalah URL untuk kamera. Jika kamera memerlukan otentikasi, sertakan nama pengguna dan kata sandi di URL ini. Anda dapat menggunakan skrip untuk membuat rahasia saat Anda membuat sumber daya yang dibutuhkan komponen ini. Untuk informasi selengkapnya, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

    Anda juga dapat menggunakan konsol Secrets Manager dan API untuk membuat rahasia tambahan. Untuk informasi selengkapnya, lihat Membuat rahasia di Panduan AWS Secrets Manager Pengguna.

  • Peran pertukaran token Greengrass harus mengizinkan tindakan AWS Secrets Manager berikut,, dan AWS IoT SiteWise Kinesis Video Streams, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

    catatan

    Kebijakan contoh ini memungkinkan perangkat untuk mendapatkan nilai rahasia bernama IPCamera1Url danIPCamera2Url. Saat Anda mengonfigurasi setiap kamera IP, Anda menentukan rahasia yang berisi URL untuk kamera itu. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Peran pertukaran token perangkat inti harus memungkinkan akses ke rahasia untuk setiap kamera IP untuk terhubung.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:region:account-id:secret:IPCamera1Url", "arn:aws:secretsmanager:region:account-id:secret:IPCamera2Url" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] }
    catatan

    Jika Anda menggunakan AWS Key Management Service kunci yang dikelola pelanggan untuk mengenkripsi rahasia, peran perangkat juga harus mengizinkan kms:Decrypt tindakan.

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik Akhir Port Diperlukan Deskripsi

kinesisvideo.region.amazonaws.com

443 Ya

Unggah data ke Kinesis Video Streams.

data.iotsitewise.region.amazonaws.com

443 Ya

Publikasikan metadata streaming video ke. AWS IoT SiteWise

secretsmanager.region.amazonaws.com

443 Ya

Unduh rahasia URL kamera ke perangkat inti.

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

Tabel berikut mencantumkan dependensi untuk versi 1.0.0 hingga 1.0.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Layanan pertukaran Token >=2.0.3 Keras
Manajer aliran >=2.0.9 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

SiteWiseAssetIdForHub

ID AWS IoT SiteWise aset yang mewakili perangkat inti ini. Untuk informasi selengkapnya tentang cara membuat aset ini dan menggunakannya untuk berinteraksi dengan komponen ini, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

contoh Contoh: Pembaruan gabungan konfigurasi
{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

Penggunaan

Untuk mengonfigurasi dan berinteraksi dengan komponen ini, Anda dapat mengatur properti pada AWS IoT SiteWise aset yang mewakili perangkat inti dan kamera IP tempat ia terhubung. Anda juga dapat memvisualisasikan dan berinteraksi dengan aliran video di dasbor Grafana melalui. AWS IoT TwinMaker Untuk informasi selengkapnya, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

File log lokal

Komponen ini menggunakan file log berikut.

/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
Untuk melihat log komponen ini
  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti/greengrass/v2 dengan path ke folder AWS IoT Greengrass root.

    sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

1.0.4

Perbaikan bug dan peningkatan
  • Memperbaiki masalah yang menyebabkan pengunggahan langsung berhenti.

1.0.3

Perbaikan bug umum dan perbaikan.

1.0.1

Perbaikan bug umum dan perbaikan.

1.0.0

Versi awal.

Lihat juga