Detektor IP - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiBerkas log lokalChangelog

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

Detektor IP

Komponen detektor IP (aws.greengrass.clientdevices.IPDetector) melakukan hal berikut:

  • Memantau informasi konektivitas jaringan perangkat inti Greengrass. Informasi ini mencakup titik akhir jaringan perangkat inti dan port tempat MQTT broker beroperasi.

  • Memperbarui informasi konektivitas perangkat inti di layanan AWS IoT Greengrass cloud.

Perangkat klien dapat menggunakan penemuan cloud Greengrass untuk mengambil informasi konektivitas perangkat inti terkait. Kemudian, perangkat klien dapat mencoba untuk menyambung ke setiap perangkat inti sampai berhasil terhubung.

catatan

Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan dan data untuk diproses. MQTT Untuk informasi selengkapnya, lihat Berinteraksilah dengan perangkat IoT lokal.

Komponen detektor IP menggantikan informasi konektivitas perangkat inti yang ada dengan informasi dideteksinya. Karena komponen ini menghapus informasi yang ada, Anda dapat menggunakan komponen detektor IP, atau secara manual mengelola informasi konektivitas.

Versi

Komponen ini memiliki versi berikut:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen ini di Java Virtual Machine JVM () yang sama dengan nukleus. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Peran layanan Greengrass harus dikaitkan dengan Akun AWS Anda dan mengizinkan serta izin. iot:GetThingShadow iot:UpdateThingShadow

  • AWS IoT Kebijakan perangkat inti harus mengizinkan greengrass:UpdateConnectivityInfo izin. Untuk informasi selengkapnya, silakan lihat Kebijakan AWS IoT untuk operasi bidang data dan Kebijakan AWS IoT minimal untuk mendukung perangkat klien.

  • Jika Anda mengonfigurasi komponen MQTT broker perangkat inti untuk menggunakan port selain port default 8883, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker beroperasi.

  • Jika Anda memiliki penataan jaringan yang kompleks, komponen detektor IP mungkin tidak dapat mengidentifikasi titik akhir di mana perangkat klien dapat menyambung ke perangkat inti. Jika komponen detektor IP tidak dapat mengelola titik akhir, Anda harus secara manual mengelola titik akhir perangkat inti sebagai gantinya. Misalnya, jika perangkat inti berada di belakang router yang meneruskan port MQTT broker ke sana, Anda harus menentukan alamat IP router sebagai titik akhir untuk perangkat inti. Untuk informasi selengkapnya, lihat Kelola titik akhir perangkat inti.

  • Komponen detektor IP didukung untuk berjalan di fileVPC.

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.2.1

Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.15.0 Lunak
2.2.0

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.14.0 Lunak
2.1.8 – 2.1.9

Tabel berikut mencantumkan dependensi untuk versi 2.1.8 dan 2.1.9 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.13.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.2.0 <2.12.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.2.0 <2.11.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.2.0 <2.10.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.2.0 <2.9.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.2.0 <2.8.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.2.0 <2.7.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.2.0 <2.6.0 Lunak
2.1.0 and 2.0.2

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 dan 2.0.2 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.5.0 Lunak
2.0.1

Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.4.0 Lunak
2.0.0

Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.2.0 <2.3.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.

2.2.x
defaultPort

(Opsional) Port MQTT broker untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengkonfigurasi MQTT broker untuk menggunakan port yang berbeda dari port default 8883.

Default: 8883

includeIPv4LoopbackAddrs

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, sepertilocalhost, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.

Default: false

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 link-lokal. Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.

Default: false

includeIPv6LoopbackAddrs

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 loopback. Ini adalah alamat IP, sepertilocalhost, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan uji di mana perangkat inti dan perangkat klien berjalan pada sistem yang sama. Anda harus mengatur includeIPv4Addrs ke false dan includeIPv6Addrs true untuk menggunakan opsi ini.

Default: false

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 link-lokal. Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. Anda harus mengatur includeIPv4Addrs ke false dan includeIPv6Addrs true untuk menggunakan opsi ini.

Default: false

includeIPv4Addrs

(Opsional) Default diatur ketrue. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti.

Default: true

includeIPv6Addrs

(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan di perangkat inti. Setel includeIPv4Addrs false untuk menggunakan opsi ini.

Default: false

2.1.x
defaultPort

(Opsional) Port MQTT broker untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengkonfigurasi MQTT broker untuk menggunakan port yang berbeda dari port default 8883.

Default: 8883

includeIPv4LoopbackAddrs

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, sepertilocalhost, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.

Default: false

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 link-lokal. Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.

Default: false

2.0.x
includeIPv4LoopbackAddrs

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, sepertilocalhost, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.

Default: false

(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 link-lokal. Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.

Default: false

Berkas log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.2.1

Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis.

2.2.0

Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis.

Fitur baru

  • Menambahkan dukungan untukIPv6. Anda sekarang dapat menggunakan IPv6 untuk pesan lokal.

2.1.9
Perbaikan bug dan peningkatan

  • Menyesuaikan langkah yang diperoleh IP untuk hanya mengirim log pada tingkat log debug.

2.1.8

 Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.

2.1.7

 Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

2.1.6

 Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

2.1.5

 Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

2.1.4

 Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

2.1.3

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

2.1.2
Perbaikan bug dan peningkatan

  • Meningkatkan pesan kesalahan yang dicatat komponen ini dalam skenario tertentu.

  • Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.

2.1.1

Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.

2.1.0
Perbaikan

  • Menambahkan defaultPort parameter, yang memungkinkan Anda untuk menggunakan port MQTT broker non-default.

  • Pembaruan untuk membuat pesan log lebih jelas.

2.0.2

Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.

2.0.1

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.0.0

Versi awal.