Kelola titik akhir perangkat inti - AWS IoT Greengrass

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

Kelola titik akhir perangkat inti

Saat Anda menggunakan penemuan cloud, Anda menyimpan titik akhir MQTT broker untuk perangkat inti di layanan AWS IoT Greengrass cloud. Perangkat klien terhubung AWS IoT Greengrass untuk mengambil titik akhir ini dan informasi lain untuk perangkat inti terkait mereka.

Untuk setiap perangkat inti, Anda dapat secara otomatis atau manual mengelola titik akhir.

  • Mengelola titik akhir secara otomatis dengan detektor IP

    Anda dapat menerapkan komponen detektor IP untuk secara otomatis mengelola titik akhir perangkat inti untuk Anda jika Anda memiliki pengaturan jaringan yang tidak kompleks, seperti di mana perangkat klien berada di jaringan yang sama dengan perangkat inti. Anda tidak dapat menggunakan komponen detektor IP jika perangkat inti berada di belakang router yang meneruskan port MQTT broker ke perangkat inti, misalnya.

    Komponen detektor IP juga berguna jika Anda men-deploy ke grup objek, karena ia mengelola titik akhir untuk semua perangkat inti dalam grup objek. Untuk informasi selengkapnya, lihat Gunakan detektor IP untuk mengelola titik akhir secara otomatis.

  • Kelola titik akhir secara manual

    Jika Anda tidak dapat menggunakan komponen detektor IP, Anda harus mengelola titik akhir perangkat inti secara manual. Anda dapat memperbarui titik akhir ini dengan konsol atau file. API Untuk informasi selengkapnya, lihat Kelola titik akhir secara manual.

Gunakan detektor IP untuk mengelola titik akhir secara otomatis

Jika Anda memiliki pengaturan jaringan sederhana, seperti perangkat klien pada jaringan yang sama sebagai perangkat inti, Anda dapatmen-deploy Komponen pendeteksi IP untuk melakukan hal berikut:

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

  • Laporkan informasi konektivitas perangkat inti ke layanan AWS IoT Greengrass cloud.

Komponen detektor IP menimpa titik akhir yang Anda tetapkan secara manual.

penting

AWS IoT Kebijakan perangkat inti harus mengizinkan greengrass:UpdateConnectivityInfo izin untuk menggunakan komponen detektor IP. Untuk informasi selengkapnya, silakan lihat Kebijakan AWS IoT untuk operasi bidang data dan Konfigurasikan kebijakan AWS IoT hal.

Anda dapat melakukan salah satu dari berikut ini untuk men-deploy komponen detektor IP:

  • Gunakan halaman Konfigurasi penemuan di konsol. Untuk informasi selengkapnya, lihat Konfigurasikan penemuan cloud (konsol).

  • Membuat dan merevisi deployment untuk menyertakan detektor IP. Anda dapat menggunakan konsol, AWS CLI, atau AWS API untuk mengelola penerapan. Untuk informasi selengkapnya, lihat Buat deployment.

  1. Pada menu navigasi konsol AWS IoT Greengrass tersebut, pilih Komponen.

  2. Pada halaman Components, pilih tab Public components, lalu pilih aws.greengrass.clientdevices.IPDetector.

  3. Pada halaman aws.greengrass.clientdevices.IPDetector pilih Deploy.

  4. Dari Tambahkan ke penerapan, pilih penerapan yang ada untuk direvisi, atau pilih untuk membuat penerapan baru, lalu pilih Berikutnya.

  5. Jika Anda memilih untuk membuat penerapan baru, pilih perangkat inti target atau grup hal untuk penerapan. Pada halaman Tentukan target, di bawah target Deployment, pilih perangkat inti atau grup benda, lalu pilih Berikutnya.

  6. Pada halaman Pilih komponen, verifikasi bahwa aws.greengrass.clientdevices.IPDetectorkomponen dipilih, pilih Berikutnya.

  7. Pada halaman Configure components, pilih aws.greengrass.clientdevices.IPDetector, lalu lakukan hal berikut:

    1. Pilih Konfigurasi komponen.

    2. Dalam aws.greengrass.clientdevices.IPDetector modal Konfigurasi, di bawah pembaruan Konfigurasi, di Konfigurasi untuk digabungkan, Anda dapat memasukkan pembaruan konfigurasi untuk mengonfigurasi komponen detektor IP. Anda dapat menentukan salah satu opsi konfigurasi berikut:

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

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

      • includeIPv4LinkLocalAddrs(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.

      • 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. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

      • includeIPv6LinkLocalAddrs(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. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

      • includeIPv4Addrs(Opsional) Default diatur ke true. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

      • includeIPv6Addrs(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan pada perangkat inti. Setel includeIPv4Addrs false untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

      Pembaruan konfigurasi mungkin terlihat mirip dengan contoh berikut.

      { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false }
    3. Pilih Konfirmasi untuk menutup modal, lalu pilih Berikutnya.

  8. Pada halaman Konfigurasikan pengaturan lanjutan, simpan pengaturan konfigurasi default tersebut, dan pilih Selanjutnya.

  9. Di halaman Tinjau, pilih Deploy.

    Penyebaran dapat memakan waktu hingga satu menit untuk diselesaikan.

Untuk menyebarkan komponen detektor IP, buat dokumen penerapan yang disertakan aws.greengrass.clientdevices.IPDetector dalam components objek, dan tentukan pembaruan konfigurasi untuk komponen tersebut. Ikuti petunjuk Buat deployment untuk membuat penerapan baru atau merevisi penerapan yang ada.

Anda dapat menentukan salah satu opsi berikut untuk mengonfigurasi komponen detektor IP saat Anda membuat dokumen penerapan:

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

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

  • includeIPv4LinkLocalAddrs(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.

  • 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. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

  • includeIPv6LinkLocalAddrs(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. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

  • includeIPv4Addrs(Opsional) Default diatur ke true. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

  • includeIPv6Addrs(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan pada perangkat inti. Setel includeIPv4Addrs false untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

Contoh berikut dokumen penyebaran sebagian menentukan untuk melaporkan port 8883 sebagai port broker. MQTT

{ ..., "components": { ..., "aws.greengrass.clientdevices.IPDetector": { "componentVersion": "2.1.1", "configurationUpdate": { "merge": "{\"defaultPort\":\"8883\",}" } } } }

Kelola titik akhir secara manual

Anda dapat mengelola titik akhir MQTT broker secara manual untuk perangkat inti.

Setiap titik akhir MQTT broker memiliki informasi berikut:

Titik akhir () HostAddress

Alamat IP atau DNS alamat tempat perangkat klien dapat terhubung ke MQTT broker di perangkat inti.

Port (PortNumber)

Port tempat MQTT broker beroperasi pada perangkat inti.

Anda dapat mengonfigurasi port ini pada komponen MQTT broker Moquette, yang default menggunakan port 8883.

Metadata () Metadata

Metadata tambahan yang akan diberikan ke perangkat klien yang terhubung ke titik akhir ini.

Mengelola titik akhir (konsol)

Anda dapat menggunakan AWS IoT Greengrass konsol untuk melihat, memperbarui, dan menghapus titik akhir untuk perangkat inti.

Untuk mengelola titik akhir untuk perangkat inti (konsol)
  1. Pilih Perangkat inti.

  2. Pilih perangkat inti untuk dikelola.

  3. Pada halaman detail perangkat inti, pilih tab Perangkat klien.

  4. Di bagian titik akhir MQTT broker, Anda dapat melihat titik akhir MQTT broker perangkat inti. Pilih Kelola titik akhir.

  5. Dalam modal Kelola titik akhir, tambahkan atau hapus titik akhir MQTT broker untuk perangkat inti.

  6. Pilih Perbarui.

Kelola titik akhir (AWS CLI)

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk mengelola titik akhir untuk perangkat inti.

catatan

Karena dukungan perangkat klien di AWS IoT Greengrass V2 kompatibel dengan versi mundur AWS IoT Greengrass V1, Anda dapat menggunakan AWS IoT Greengrass V2 atau AWS IoT Greengrass V1 API operasi untuk mengelola titik akhir perangkat inti.

Untuk mendapatkan titik akhir untuk perangkat inti (AWS CLI)
Untuk memperbarui titik akhir untuk perangkat inti (AWS CLI)

Kelola titik akhir (API)

Anda dapat menggunakan AWS API untuk mengelola titik akhir untuk perangkat inti.

catatan

Karena dukungan perangkat klien di AWS IoT Greengrass V2 kompatibel dengan versi mundur AWS IoT Greengrass V1, Anda dapat menggunakan AWS IoT Greengrass V2 atau AWS IoT Greengrass V1 API operasi untuk mengelola titik akhir perangkat inti.

Untuk mendapatkan titik akhir untuk perangkat inti ()AWS API
Untuk memperbarui titik akhir untuk perangkat inti ()AWS API