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 komponen Kinesis Video Streams (aws.iot.EdgeConnectorForKVS) membaca umpan video dari kamera lokal dan menerbitkan aliran ke Kinesis Video Streams. Anda dapat mengkonfigurasi komponen ini untuk membaca umpan video dari kamera Internet Protocol (IP) menggunakan Real Time Streaming Protocol (RTSP). Kemudian, Anda dapat mengatur dasbor diAmazon Managed Grafanaatau server Grafana lokal untuk memantau dan berinteraksi dengan aliran video.

Anda dapat mengintegrasikan komponen ini denganAWS IoT TwinMaker untuk menampilkan dan mengontrol aliran video di dasbor Grafana. AWS IoT TwinMaker adalahAWSlayanan yang memungkinkan Anda untuk membangun kembar digital operasional sistem fisik. Anda dapat menggunakanAWS 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 merupakanAWSlayanan yang memodelkan dan menyimpan data industri. MasukAWS IoT SiteWise,asetmewakili benda-benda seperti perangkat, peralatan, atau kelompok benda lain. Untuk mengkonfigurasi dan menggunakan komponen ini, Anda membuatAWS IoT SiteWiseaset 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 rahasiaAWS Secrets Manageryang 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 streaming video setiap kamera ke aliran video Kinesis. Anda menentukan nama aliran video Kinesis tujuan diAWS IoT SiteWisekonfigurasi aset untuk setiap kamera. Jika aliran video Kinesis tidak ada, komponen ini akan membuatnya untuk Anda.

AWS IoT TwinMaker menyediakan skrip yang dapat Anda jalankan untuk membuat iniAWS IoT SiteWiseaset dan rahasia Secrets Manager. Untuk informasi selengkapnya tentang cara membuat sumber daya ini, dan cara menginstal, mengkonfigurasi, dan menggunakan komponen ini, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan Pengguna.

catatan

Konektor tepi untuk komponen Kinesis Video Streams hanya tersedia diWilayah 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

Inikomponen adalah komponen generik (aws.greengrass.generic). YangInti Greengrassmenjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti Linux saja.

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.

  • GStreamer1.18.4 atau yang lebih baru diinstal pada perangkat inti. Untuk informasi selengkapnya, lihatMenginstal 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
  • SesiAWS IoT SiteWiseaset untuk setiap perangkat inti. IniAWS IoT SiteWiseaset merupakan perangkat inti. Untuk informasi lebih lanjut tentang cara membuat aset ini, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan Pengguna.

  • SesiAWS IoT SiteWiseaset untuk setiap kamera IP yang Anda sambungkan ke setiap perangkat inti. IniAWS IoT SiteWiseaset 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, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan Pengguna.

  • SesiAWS Secrets Managerrahasia untuk setiap kamera IP. Rahasia ini harus mendefinisikan pasangan kunci-nilai, di mana kuncinya adalahRTSPStreamUrl, 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, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan Pengguna.

    Anda juga dapat menggunakan konsol dan API Secrets Manager untuk membuat rahasia tambahan. Untuk informasi selengkapnya, lihatBuat rahasiadi dalamAWS Secrets ManagerPanduan Pengguna.

  • YangGreengrass peran pertukaran tokenharus memungkinkan berikutAWS Secrets Manager,AWS IoT SiteWise, dan tindakan Kinesis Video Streams, seperti yang ditunjukkan dalam kebijakan IAM contoh berikut.

    catatan

    Kebijakan contoh ini memungkinkan perangkat untuk mendapatkan nilai dari rahasia yang bernamaIPCamera1UrldanIPCamera2Url. Ketika Anda mengkonfigurasi 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 pelanggan yang dikelolaAWS Key Management Servicekunci untuk mengenkripsi rahasia, peran perangkat juga harus memungkinkankms:Decrypttindakan.

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 aliran video keAWS 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 pengaliran > = 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 dariAWS IoT SiteWiseaset yang mewakili perangkat inti ini. Untuk informasi lebih lanjut tentang cara membuat aset ini dan menggunakannya untuk berinteraksi dengan komponen ini, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan Pengguna.

contoh Contoh: Pembaruan gabungan konfigurasi

{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

Penggunaan

Untuk mengkonfigurasi dan berinteraksi dengan komponen ini, Anda dapat mengatur properti padaAWS IoT SiteWiseaset yang mewakili perangkat inti dan kamera IP di mana ia terhubung. Anda juga dapat memvisualisasikan dan berinteraksi dengan streaming video di dasbor Grafana melaluiAWS IoT TwinMaker. Untuk informasi selengkapnya, lihatAWS IoT TwinMaker Integrasi Videodi dalamAWS IoT TwinMaker Panduan 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 jalur menuju folder akar AWS IoT Greengrass.

    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

Peningkatan dan perbaikan bug umum.

1.0.1

Peningkatan dan perbaikan bug umum.

1.0.0

Versi awal.

Lihat juga