Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Router langganan warisan
Router langganan warisan (aws.greengrass.LegacySubscriptionRouter
) mengelola langganan pada perangkat inti Greengrass. Langganan adalah fitur AWS IoT Greengrass V1 yang menentukan topik yang dapat digunakan fungsi Lambda untuk MQTT mengirim pesan pada perangkat inti. Untuk informasi selengkapnya, lihat Langganan terkelola dalam alur kerja MQTT perpesanan di Panduan Pengembang AWS IoT Greengrass V1.
Anda dapat menggunakan komponen ini untuk mengaktifkan langganan komponen konektor dan komponen fungsi Lambda yang menggunakan AWS IoT Greengrass Core. SDK
Komponen router langganan lama diperlukan hanya jika fungsi Lambda Anda menggunakan fungsi publish()
di AWS IoT Greengrass Core. SDK Jika Anda memperbarui kode fungsi Lambda untuk menggunakan antarmuka interprocess communication (IPC) di AWS IoT Device SDK V2, Anda tidak perlu menerapkan komponen router langganan lama. Untuk informasi lebih lanjut, lihat layanan komunikasi antar proses berikut ini:
Versi
Komponen ini memiliki versi berikut:
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:
Dependensi
Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga 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.
- 2.1.13
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.13 dari komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.15.0 |
Lunak |
- 2.1.12
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.12 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.14.0 |
Lunak |
- 2.1.11
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.13.0 |
Lunak |
- 2.1.10
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.12.0 |
Lunak |
- 2.1.9
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.11.0 |
Lunak |
- 2.1.8
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.10.0 |
Lunak |
- 2.1.7
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.9.0 |
Lunak |
- 2.1.6
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.8.0 |
Lunak |
- 2.1.5
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.7.0 |
Lunak |
- 2.1.4
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.6.0 |
Lunak |
- 2.1.3
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.5.0 |
Lunak |
- 2.1.2
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.4.0 |
Lunak |
- 2.1.1
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.3.0 |
Lunak |
- 2.1.0
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.0 <2.2.0 |
Lunak |
- 2.0.3
-
Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini.
Dependensi |
Versi yang kompatibel |
Jenis dependensi |
Inti Greengrass |
>=2.0.3 <2.1.0 |
Lunak |
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.
- v2.1.x
-
subscriptions
-
(Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan saat menerapkan komponen konektor V1 atau fungsi Lambda yang menggunakan Core. AWS IoT Greengrass SDK
Setiap objek langganan berisi informasi berikut.
id
-
ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini.
source
-
Fungsi Lambda yang menggunakan AWS IoT Greengrass Core SDK untuk mempublikasikan MQTT pesan tentang topik yang Anda tentukan. subject
Tentukan satu dari yang berikut ini:
-
Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks component:
, seperti component:com.example.HelloWorldLambda
.
-
Nama Sumber Daya Amazon (ARN) dari fungsi Lambda pada perangkat inti.
Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.
Anda harus menentukan Amazon Resource Name (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST
.
Untuk menerapkan langganan komponen konektor V1, tentukan nama komponen atau fungsi Lambda komponen konektor. ARN
subject
-
Filter MQTT topik atau topik tempat sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik +
dan #
.
target
-
Target yang menerima MQTT pesan tentang topik yang Anda tentukansubject
. Langganan menentukan bahwa source
fungsi menerbitkan MQTT pesan ke AWS IoT Core atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini:
-
cloud
. source
Fungsi ini menerbitkan MQTT pesan ke AWS IoT Core.
-
Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks component:
, seperti component:com.example.HelloWorldLambda
.
-
Nama Sumber Daya Amazon (ARN) dari fungsi Lambda pada perangkat inti.
Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.
Anda harus menentukan Amazon Resource Name (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST
.
Default: Tidak ada langganan
contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke AWS IoT Core)
Contoh berikut menentukan bahwa komponen fungsi com.example.HelloWorldLambda
Lambda MQTT menerbitkan pesan AWS IoT Core ke topik. hello/world
{
"subscriptions": {
"Greengrass_HelloWorld_to_cloud": {
"id": "Greengrass_HelloWorld_to_cloud",
"source": "component:com.example.HelloWorldLambda",
"subject": "hello/world",
"target": "cloud"
}
}
}
contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)
Contoh berikut menentukan bahwa komponen fungsi com.example.HelloWorldLambda
Lambda MQTT menerbitkan pesan ke komponen fungsi com.example.MessageRelay
Lambda pada topik. hello/world
{
"subscriptions": {
"Greengrass_HelloWorld_to_MessageRelay": {
"id": "Greengrass_HelloWorld_to_MessageRelay",
"source": "component:com.example.HelloWorldLambda",
"subject": "hello/world",
"target": "component:com.example.MessageRelay"
}
}
}
- v2.0.x
-
subscriptions
-
(Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan saat menerapkan komponen konektor V1 atau fungsi Lambda yang menggunakan Core. AWS IoT Greengrass SDK
Setiap objek langganan berisi informasi berikut.
id
-
ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini.
source
-
Fungsi Lambda yang menggunakan AWS IoT Greengrass Core SDK untuk mempublikasikan MQTT pesan tentang topik yang Anda tentukan. subject
Tentukan hal berikut:
Untuk menerapkan langganan komponen konektor V1, tentukan fungsi Lambda komponen konektor. ARN
subject
-
Filter MQTT topik atau topik tempat sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik +
dan #
.
target
-
Target yang menerima MQTT pesan tentang topik yang Anda tentukansubject
. Langganan menentukan bahwa source
fungsi menerbitkan MQTT pesan ke AWS IoT Core atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini:
Default: Tidak ada langganan
contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke AWS IoT Core)
Contoh berikut menentukan bahwa Greengrass_HelloWorld
fungsi menerbitkan MQTT pesan ke AWS IoT Core topik. hello/world
"subscriptions": {
"Greengrass_HelloWorld_to_cloud": {
"id": "Greengrass_HelloWorld_to_cloud",
"source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
"subject": "hello/world",
"target": "cloud"
}
}
contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)
Contoh berikut menentukan bahwa Greengrass_HelloWorld
fungsi menerbitkan MQTT pesan ke Greengrass_MessageRelay
topik. hello/world
"subscriptions": {
"Greengrass_HelloWorld_to_MessageRelay": {
"id": "Greengrass_HelloWorld_to_MessageRelay",
"source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
"subject": "hello/world",
"target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5"
}
}
File log lokal
Komponen ini tidak mengeluarkan log.
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
Versi
|
Perubahan
|
2.1.13
|
Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. |
2.1.12
|
Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. |
2.1.11
|
Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. |
2.1.10
|
Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. |
2.1.9
|
Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. |
2.1.8
|
Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. |
2.1.7
|
Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. |
2.1.6
|
Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.
|
2.1.5
|
Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.
|
2.1.4
|
Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.
|
2.1.3
|
Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.
|
2.1.2
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.
|
2.1.1
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.
|
2.1.0
|
- Perbaikan bug dan peningkatan
-
-
Menambahkan dukungan untuk menentukan nama komponen, bukan ARNs untuk source dantarget . Jika Anda menentukan nama komponen untuk suatu langganan, Anda tidak perlu mengonfigurasi ulang langganan setiap kali versi fungsi Lambda berubah.
|
2.0.3
|
Versi awal.
|