Inti Greengrass - AWS IoT Greengrass

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

Inti Greengrass

Komponen nukleus Greengrass (aws.greengrass.Nucleus) adalah komponen wajib dan persyaratan minimum untuk menjalankan perangkat lunak inti AWS IoT Greengrass pada perangkat. Anda dapat mengonfigurasi komponen ini untuk menyesuaikan dan memperbarui perangkat lunak inti AWS IoT Greengrass Anda dari jarak jauh. Deploy komponen ini untuk mengkonfigurasi pengaturan seperti proksi, peran perangkat, dan konfigurasi objek AWS IoT pada perangkat inti Anda.

penting

Ketika versi komponen inti berubah, atau ketika Anda mengubah parameter konfigurasi tertentu, perangkat lunak inti AWS IoT Greengrass—yang mencakup inti dan semua komponen lainnya di perangkat Anda—dimulai ulang untuk menerapkan perubahan itu.

Ketika Anda men-deploy komponen,AWS IoT Greengrass menginstal versi terbaru yang didukung dari semua dependensi komponen tersebut. Karena ini, versi patch baru dari komponen publik yang disediakan oleh AWS mungkin secara otomatis di-deploy ke perangkat inti Anda jika Anda menambahkan perangkat baru ke grup objek, atau Anda memperbarui deployment yang menargetkan perangkat tersebut. Beberapa pembaruan otomatis, seperti pembaruan inti, dapat menyebabkan perangkat Anda memulai ulang secara tiba-tiba.

Untuk mencegah pembaruan yang tidak diinginkan untuk komponen yang berjalan di perangkat Anda, sebaiknya sertakan versi komponen yang Anda inginkan secara langsung saat membuat deployment. Untuk informasi selengkapnya tentang perilaku pembaruan untuk perangkat lunak Inti AWS IoT Greengrass, lihat Perbarui perangkat lunak inti AWS IoT Greengrass (OTA).

Versi

Komponen ini memiliki versi berikut:

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Sistem operasi

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

  • Linux

  • Windows

Untuk informasi selengkapnya, lihat Platform yang didukung.

Persyaratan

Perangkat harus memenuhi persyaratan tertentu untuk menginstal dan menjalankan nukleus Greengrass dan perangkat lunak inti AWS IoT Greengrass. Untuk informasi selengkapnya, lihat Persyaratan perangkat.

Dependensi

Inti Greengrass tidak termasuk dependensi komponen apapun. Namun, beberapa komponen yang disediakan oleh AWS mencakup nukleus sebagai dependensi. Untuk informasi selengkapnya, lihat Komponen yang disediakan oleh AWS.

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

Unduh dan instal

Anda dapat men-download installer yang mengatur komponen inti Greengrass pada perangkat Anda. Installer ini mengatur perangkat Anda sebagai perangkat inti Greengrass. Ada dua jenis instalasi yang dapat Anda lakukan: instalasi cepat yang membuat sumber daya AWS yang diperlukan untuk Anda, atau instalasi manual di mana Anda membuat sumber daya AWS Anda sendiri. Untuk informasi selengkapnya, lihat Instal perangkat lunak inti AWS IoT Greengrass.

Anda juga dapat mengikuti tutorial untuk menginstal inti Greengrass dan mengeksplorasi pengembangan komponen Greengrass. Untuk informasi selengkapnya, lihat Tutorial: MemulaiAWS IoT Greengrass V2.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. Beberapa parameter mengharuskan perangkat lunak inti AWS IoT Greengrass restart untuk mulai berlaku. Untuk informasi selengkapnya tentang mengapa dan bagaimana komponen ini, lihat Konfigurasikan perangkat lunak inti AWS IoT Greengrass.

iotRoleAlias

AWS IoTPeran yang menunjuk ke pertukaran token IAM role. Penyedia kredensial AWS IoT meneruskan peran ini untuk memungkinkan perangkat inti Greengrass untuk berinteraksi dengan layanan AWS. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

Ketika Anda menjalankan perangkat lunak inti AWS IoT Greengrass dengan opsi --provision true, perangkat lunak menyediakan alias peran dan menetapkan nilai dalam komponen inti.

interpolateComponentConfiguration

(Opsional) Anda dapat mengaktifkan inti Greengrass untuk menginterpolasi variabel resep komponen dalam konfigurasi komponen dan menggabungkan pembaruan konfigurasi. Sebaiknya atur opsi initrue agar perangkat inti dapat menjalankan komponen Greengrass yang menggunakan variabel resep dalam konfigurasinya.

Fitur ini tersedia untuk v2.6.0 dan versi yang lebih baru dari komponen ini.

Default: false

networkProxy

(Opsional) Proksi jaringan yang digunakan untuk semua koneksi. Untuk informasi selengkapnya, lihat Hubungkan pada port 443 atau melalui proksi jaringan.

penting

Ketika Anda men-deploy perubahan ke parameter konfigurasi ini, perangkat lunak inti AWS IoT Greengrass akan dimulai agar perubahan dapat diterapkan.

Objek ini berisi informasi berikut:

noProxyAddresses

(Opsional) Daftar comma-separated alamat IP atau nama host yang dibebaskan dari proksi.

proxy

Proksi yang akan dihubungkan. Objek ini berisi informasi berikut:

url

URL server proksi dalam format scheme://userinfo@host:port.

  • scheme — Skema, yang harus berupa http atau https.

    penting

    Perangkat inti Greengrass harus menjalankan Greengrass nucleus v2.5.0 atau yang lebih baru untuk menggunakan proxy HTTPS.

    Jika Anda mengonfigurasi proxy HTTPS, Anda harus menambahkan sertifikat CA server proxy ke sertifikat CA root Amazon perangkat inti. Untuk informasi selengkapnya, lihat Aktifkan perangkat inti untuk mempercayai proxy HTTPS.

  • userinfo - (Opsional) Nama pengguna dan informasi kata sandi. Jika Anda menentukan informasi ini diurl, perangkat inti Greengrass akan mengabaikanpassword kolomusername dan.

  • host - Nama host atau alamat IP server proksi.

  • port — (Opsional) Nomor port. Jika Anda tidak menentukan port, maka perangkat inti Greengrass akan menggunakan nilai default berikut:

    • http – 80

    • https – 443

username

(Opsional) Nama pengguna yang mengautentikasi server proksi.

password

(Opsional) Kata sandi yang mengautentikasi server proksi.

mqtt

(Opsional) Konfigurasi MQTT untuk perangkat inti Greengrass. Untuk informasi selengkapnya, lihat Hubungkan pada port 443 atau melalui proksi jaringan.

penting

Ketika Anda men-deploy perubahan ke parameter konfigurasi ini, perangkat lunak inti AWS IoT Greengrass akan dimulai agar perubahan dapat diterapkan.

Objek ini berisi informasi berikut:

port

(Opsional) Port yang akan digunakan untuk koneksi MQTT.

Default: 8883

keepAliveTimeoutMs

(Opsional) Jumlah waktu dalam milidetik antara setiap pesan PING yang dikirim klien untuk menjaga sambungan MQTT hidup.

Default: 60000 (60 detik)

pingTimeoutMs

(Opsional) Jumlah waktu dalam milidetik yang klien tunggu untuk menerima pesan PINGACK dari server. Jika masa tunggu melebihi batas waktu, perangkat inti menutup dan membuka kembali sambungan MQTT.

Default: 30000 (30 detik)

maxInFlightPublishes

(Opsional) Jumlah maksimum pesan MQTT QoS 1 yang tidak diakui yang dapat terbang pada waktu yang sama.

Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini.

Default: 5

Kisaran valid: Nilai maksimum 100

maxMessageSizeInBytes

(Opsional) Ukuran maksimum pesan MQTT. Jika pesan melebihi ukuran ini, inti Greengrass menolak pesan dengan kesalahan.

Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini.

Default: 131072 (128 KB)

Kisaran valid: Nilai maksimum 2621440 (2,5 MB)

maxPublishRetry

(Opsional) Jumlah waktu maksimum untuk mencoba kembali pesan yang gagal untuk dipublikasikan. Anda dapat menentukan -1 untuk mencoba lagi dalam waktu tak terbatas.

Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini.

Default: 100

spooler

(Opsional) Konfigurasi spooler MQTT untuk perangkat inti Greengrass. Objek ini berisi informasi berikut:

maxSizeInBytes

(Opsional) Ukuran maksimum cache di mana perangkat inti menyimpan pesan MQTT yang belum diproses dalam memori. Jika cache penuh, perangkat inti membuang pesan tertua untuk menambahkan pesan baru.

Default: 2621440 (2,5 MB)

keepQos0WhenOffline

(Opsional) Anda dapat mengirim pesan MQTT QoS 0 yang diterima oleh perangkat inti ketika ia offline. Jika Anda menetapkan opsi ini ke true, perangkat inti akan mengirim pesan QoS 0 yang tidak dapat dikirimnya saat sedang offline. Jika Anda menetapkan opsi ini ke false, perangkat inti akan membuang pesan ini. Perangkat inti selalu mengirim pesan QoS 1 pesan kecuali spool penuh.

Default: false

version

(Opsional) Versi MQTT. Anda dapat menentukan mqtt3 atau mqtt5.

Fitur ini tersedia untuk v2.10.0 dan versi yang lebih baru dari komponen inti Greengrass.

Default: mqtt5

receiveMaximum

(Opsional) Jumlah maksimum paket QoS1 yang tidak diakui yang dapat dikirim broker.

Fitur ini tersedia untuk v2.10.0 dan versi yang lebih baru dari komponen inti Greengrass.

Default: 100

sessionExpirySeconds

(Opsional) Jumlah waktu, dalam hitungan detik, Anda dapat meminta sesi untuk bertahan dari IoT Core. Default adalah waktu maksimum yang didukung olehAWS IoT Core.

Fitur ini tersedia untuk v2.10.0 dan versi yang lebih baru dari komponen inti Greengrass.

Default: 604800 (7 days)

minimumReconnectDelaySeconds

(Opsional) Opsi untuk perilaku rekoneksi. Jumlah minimum waktu dalam detik untuk MQTT untuk menyambung kembali.

Fitur ini tersedia untuk v2.10.0 dan versi kemudian dari komponen inti Greengrass.

Default: 1

maximumReconnectDelaySeconds

(Opsional) Opsi untuk perilaku rekoneksi. Jumlah waktu maksimum dalam hitungan detik untuk MQTT untuk menyambung kembali.

Fitur ini tersedia untuk v2.10.0 dan versi kemudian dari komponen inti Greengrass.

Default: 120

minimumConnectedTimeBeforeRetryResetSeconds

(Opsional) Opsi untuk perilaku rekoneksi. Jumlah waktu dalam detik koneksi harus aktif sebelum penundaan coba ulang diatur ulang kembali ke minimum.

Fitur ini tersedia untuk v2.10.0 dan versi kemudian dari komponen inti Greengrass.

Default: 30

jvmOptions

(Opsional) Opsi JVM yang akan digunakan untuk menjalankan perangkat lunak inti AWS IoT Greengrass. Untuk informasi tentang pilihan JVM yang direkomendasikan untuk menjalankan perangkat lunak inti AWS IoT Greengrass, lihat Kontrol alokasi memori dengan opsi JVM.

penting

Ketika Anda men-deploy perubahan ke parameter konfigurasi ini, perangkat lunak inti AWS IoT Greengrass akan dimulai ulang agar perubahan dapat diterapkan.

iotDataEndpoint

Titik akhir data AWS IoT untuk perangkat Akun AWS.

Ketika Anda menjalankan perangkat lunak inti AWS IoT Greengrass dengan opsi --provision true, perangkat lunak tersebut mendapatkan data dan titik akhir kredensial Anda dari AWS IoT dan menetapkannya dalam komponen nukleus.

iotCredEndpoint

Titik akhir kredensial AWS IoT untuk Akun AWS Anda.

Ketika Anda menjalankan perangkat lunak inti AWS IoT Greengrass dengan opsi --provision true, perangkat lunak tersebut mendapatkan data dan titik akhir kredensial Anda dari AWS IoT dan menetapkannya dalam komponen nukleus.

greengrassDataPlaneEndpoint

Fitur ini tersedia pada v2.7.0 dan versi yang lebih baru dari komponen ini.

Untuk informasi selengkapnya, lihat Menggunakan sertifikat perangkat yang ditandatangani oleh CA privat.

greengrassDataPlanePort

Fitur ini tersedia pada v2.0.4 dan versi yang lebih baru dari komponen ini.

(Opsional) Port yang akan digunakan untuk koneksi bidang data. Untuk informasi selengkapnya, lihat Hubungkan pada port 443 atau melalui proksi jaringan.

penting

Anda harus menentukan port di mana perangkat dapat membuat koneksi keluar. Jika Anda menentukan port yang diblokir, perangkat tidak akan dapat tersambung ke AWS IoT Greengrass untuk menerima deployment.

Pilih dari salah satu pilihan berikut:

  • 443

  • 8443

Default: 8443

awsRegion

Wilayah AWS yang akan digunakan

runWithDefault

Pengguna sistem yang akan digunakan untuk menjalankan komponen.

penting

Ketika Anda men-deploy perubahan ke parameter konfigurasi ini, perangkat lunak inti AWS IoT Greengrass akan dimulai ulang agar perubahan dapat diterapkan.

Objek ini berisi informasi berikut:

posixUser

Nama atau ID dari pengguna sistem dan, secara opsional, grup sistem yang digunakan oleh perangkat inti untuk menjalankan komponen generik dan Lambda. Tentukan pengguna dan grup yang dipisahkan dengan titik dua (:) dalam format berikut: user:group. Grup ini opsional. Jika Anda tidak menentukan grup, perangkat lunakAWS IoT Greengrass inti akan menggunakan grup utama untuk pengguna. Misalnya, Anda dapat menentukan ggc_user atau ggc_user:ggc_group. Untuk informasi selengkapnya, lihat Mengkonfigurasi pengguna yang menjalankan komponen.

Ketika Anda menjalankan penginstal perangkat lunakAWS IoT Greengrass inti dengan--component-default-user ggc_user:ggc_group opsi, perangkat lunak menetapkan parameter ini dalam komponen nukleus.

windowsUser

Fitur ini tersedia pada v2.5.0 dan versi yang lebih baru dari komponen ini.

Nama pengguna Windows yang digunakan untuk menjalankan komponen ini pada perangkat inti Windows. Pengguna harus ada di setiap perangkat inti Windows, dan nama serta kata sandinya harus disimpan di instance Manajer KredensialLocalSystem akun. Untuk informasi selengkapnya, lihat Mengkonfigurasi pengguna yang menjalankan komponen.

Ketika Anda menjalankan penginstal perangkat lunakAWS IoT Greengrass inti dengan--component-default-user ggc_user opsi, perangkat lunak menetapkan parameter ini dalam komponen nukleus.

systemResourceLimits

Fitur ini tersedia pada v2.4.0 dan versi yang lebih baru dari komponen ini. AWS IoT GreengrassSaat ini tidak mendukung fitur ini pada perangkat inti Windows.

Batas sumber daya sistem untuk diterapkan pada proses komponen Lambda generik dan non-kontainer secara default. Anda dapat mengganti batas sumber daya sistem untuk masing-masing komponen saat membuat penerapan. Untuk informasi selengkapnya, lihat Mengkonfigurasi batas sumber daya sistem untuk komponen.

Objek ini berisi informasi berikut:

cpus

Jumlah maksimum waktu CPU yang dapat digunakan setiap proses komponen pada perangkat inti. Total waktu CPU perangkat inti setara dengan jumlah inti CPU perangkat. Misalnya, pada perangkat inti dengan 4 inti CPU, Anda dapat mengatur nilai ini2 untuk membatasi setiap proses komponen hingga 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini0.25 untuk membatasi setiap proses komponen hingga 25 persen penggunaan CPU. Jika Anda menetapkan nilai ini ke angka yang lebih besar dari jumlahAWS IoT Greengrass inti CPU, perangkat lunak Core tidak membatasi penggunaan CPU komponen.

memory

Jumlah maksimum RAM (dalam kilobyte) yang dapat digunakan setiap proses komponen pada perangkat inti.

logging

(Opsional) Konfigurasi pencatatan untuk perangkat inti. Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan log Greengrass, lihatMemonitorAWS IoT Greengrass log.

Objek ini berisi informasi berikut:

level

(Opsional) Tingkat minimum pesan log yang akan dikeluarkan.

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

format

(Opsional) Format data log. Pilih dari salah satu pilihan berikut:

  • TEXT- Pilih opsi ini jika Anda ingin melihat log dalam bentuk teks.

  • JSON- Pilih opsi ini jika Anda ingin melihat log dengan perintah Greengrass CLI logs atau berinteraksi dengan log pemrograman.

Default: TEXT

outputType

(Opsional) Jenis output untuk log. Pilih dari salah satu pilihan berikut:

  • FILE — Perangkat lunak inti AWS IoT Greengrass mengeluarkan log ke file dalam direktori yang Anda tentukan di outputDirectory.

  • CONSOLE — Perangkat lunak inti AWS IoT Greengrass mencetak log ke stdout. Pilih opsi ini untuk melihat log begitu perangkat inti mencetaknya.

Default: FILE

fileSizeKB

(Opsional) Ukuran maksimum setiap file log (dalam kilobyte). Setelah file log melebihi ukuran file maksimum ini, perangkat lunakAWS IoT Greengrass inti membuat file log baru.

Parameter ini hanya berlaku bila Anda menentukan FILE untuk outputType.

Default: 1024

totalLogsSizeKB

(Opsional) Ukuran total maksimum file log (dalam kilobyte) untuk setiap komponen, termasuk inti Greengrass. File log nukleus Greengrass juga menyertakan log dari komponen plugin. Setelah ukuran total file log melebihi ukuran maksimum ini, perangkat lunakAWS IoT Greengrass inti menghapus file log tertua dari komponen tersebut.

Parameter ini setara dengan parameter batas ruang disk komponen pengelola log (diskSpaceLimit), yang dapat Anda tentukan untuk inti Greengrass (sistem) dan setiap komponen. Perangkat lunakAWS IoT Greengrass inti menggunakan minimum dari dua nilai tersebut sebagai ukuran total log maksimum untuk inti Greengrass dan setiap komponen.

Parameter ini hanya berlaku bila Anda menentukan FILE untuk outputType.

Default: 10240

outputDirectory

(Opsional) Direktori output untuk file log.

Parameter ini hanya berlaku bila Anda menentukan FILE untuk outputType.

Default: /greengrass/v2/logs, di mana /greengrass/v2 adalah folder akar AWS IoT Greengrass.

fleetstatus

Parameter ini tersedia pada v2.1.0 dan versi yang lebih baru dari komponen ini.

(Opsional) Konfigurasi status armada untuk perangkat inti.

Objek ini berisi informasi berikut:

periodicStatusPublishIntervalSeconds

(Opsional) Jumlah waktu (dalam detik) yang di antaranya perangkat inti menerbitkan status perangkat ke AWS Cloud.

Minimal:86400 (24 jam)

Default:86400 (24 jam)

telemetry

(Opsional) Konfigurasi telemetri kesehatan sistem untuk perangkat inti. Untuk informasi lebih lanjut tentang metrik telemetri dan cara memperlakukan data telemetri, lihat Kumpulkan data telemetri kondisi sistem dari perangkat inti AWS IoT Greengrass.

Objek ini berisi informasi berikut:

enabled

(Opsional) Anda dapat mengaktifkan atau menonaktifkan telemetri.

Default: true

periodicAggregateMetricsIntervalSeconds

(Opsional) Interval (dalam detik) di mana perangkat inti menggabungkan metrik.

Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, nukleus akan menggunakan nilai default sebagai gantinya.

Minimum:3600

Default: 3600

periodicPublishMetricsIntervalSeconds

(Opsional) Jumlah waktu (dalam detik) yang di antaranya perangkat inti menerbitkan metrik telemetri ke AWS Cloud.

Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, nukleus akan menggunakan nilai default sebagai gantinya.

Minimum:86400

Default: 86400

deploymentPollingFrequencySeconds

(Opsional) Periode dalam detik untuk mengumpulkan notifikasi deployment.

Default: 15

componentStoreMaxSizeBytes

(Opsional) Ukuran maksimum pada disk dari penyimpanan komponen, yang terdiri dari resep komponen dan artefak.

Default: 10000000000 (10 GB)

platformOverride

(Opsional) Kamus atribut yang mengidentifikasi platform perangkat inti. Gunakan ini untuk menentukan atribut platform kustom yang dapat digunakan resep komponen untuk mengidentifikasi siklus hidup dan artefak yang benar untuk komponen. Misalnya, Anda mungkin menentukan atribut kemampuan perangkat keras untuk men-deploy hanya serangkaian artefak minimal yang akan dijalankan oleh komponen. Untuk informasi lebih lanjut, lihat parameter platform manifes dalam resep komponen.

Anda juga dapat menggunakan parameter ini untuk menimpa atribut platform os dan architecture dari perangkat inti.

httpClient

Parameter ini tersedia pada v2.5.0 dan versi yang lebih baru dari komponen ini.

(Opsional) Konfigurasi klien HTTP untuk perangkat inti. Opsi konfigurasi ini berlaku untuk semua permintaan HTTP yang dibuat oleh komponen ini. Jika perangkat inti berjalan pada jaringan yang lebih lambat, Anda dapat meningkatkan durasi batas waktu ini untuk mencegah permintaan HTTP dari waktu habis.

Objek ini berisi informasi berikut:

connectionTimeoutMs

(Opsional) Jumlah waktu (dalam milidetik) untuk menunggu koneksi terbuka sebelum permintaan koneksi habis.

Default:2000 (2 detik)

socketTimeoutMs

(Opsional) Jumlah waktu (dalam milidetik) untuk menunggu data ditransfer melalui koneksi terbuka sebelum koneksi habis.

Default: 30000 (30 detik)

contoh Contoh: Pembaruan gabungan konfigurasi
{ "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias", "networkProxy": { "noProxyAddresses": "http://192.168.0.1,www.example.com", "proxy": { "url": "http://my-proxy-server:1100", "username": "Mary_Major", "password": "pass@word1357" } }, "mqtt": { "port": 443 }, "greengrassDataPlanePort": 443, "jvmOptions": "-Xmx64m", "runWithDefault": { "posixUser": "ggc_user:ggc_group" } }

File log lokal

Komponen ini menggunakan file log berikut.

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 path ke folderAWS 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.10.1

Perbaikan bug dan peningkatan
  • Memperbaiki masalah yang dapat menyebabkan crash saat startup pada prosesor ARMv8 tertentu, termasuk Jetson Nano.

  • Greengrass tidak lagi menutup standar komponen, ini mengembalikan perilaku ke perilaku pra-2.10.0

2.10.0

Fitur baru
  • MenambahkaninterpolateComponentConfiguration dukungan untuk ekspresi reguler kosong. Greengrass sekarang interpolasi dari objek root config.

  • Menambahkan dukungan untuk MQTT5.

  • Menambahkan mekanisme untuk memuat komponen plugin dengan cepat tanpa pemindaian.

  • Memungkinkan Greengrass untuk menghemat ruang disk dengan menghapus gambar Docker yang tidak digunakan.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana rollback meninggalkan nilai konfigurasi tertentu pada tempatnya dari penyebaran.

  • Memperbaiki masalah di mana inti Greengrass memvalidasi untuk urutanAWS domain dalamAWS non-kredensi kustom dan titik akhir data.

  • Memperbarui resolusi ketergantungan multi-grup untuk menyelesaikan kembali semua dependensi grup melaluiAWS Cloud negosiasi, alih-alih mengunci ke versi aktif. Pembaruan ini juga menghapus kode kesalahan penyebaranINSTALLED_COMPONENT_NOT_FOUND.

  • Memperbarui inti Greengrass untuk melewatkan pengunduhan image Docker saat sudah ada secara lokal.

  • Memperbarui nukleus Greengrass untuk memulai ulang langkah penginstalan komponen sebelum batas waktu berakhir.

  • Peningkatan dan perbaikan kecil tambahan.

2.9.6

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana penyebaran Greengrass gagal dengan kesalahan LAUNCH_DIRECTORY_CORRUPTED dan reboot perangkat berikutnya gagal memulai Greengrass. Kesalahan ini dapat terjadi saat Anda memindahkan perangkat Greengrass di antara beberapa grup hal dengan penerapan yang memerlukan Greengrass untuk memulai ulang.

2.9.5

Fitur baru
  • Menambahkan dukungan untuk verifikasi tanda tangan perangkat lunak inti Greengrass.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah saat penyebaran gagal saat wilayah metadata resep lokal tidak cocok dengan wilayah peluncuran nukleus Greengrass. Inti Greengrass sekarang menegosiasikan ulang dengan awan saat ini terjadi.

  • Memperbaiki masalah di mana spooler pesan MQTT terisi dan tidak pernah menghapus pesan.

  • Peningkatan dan perbaikan kecil tambahan.

2.9.4

Perbaikan bug dan peningkatan
  • Memeriksa pesan null sebelum menjatuhkan pesan QOS 0.

  • Memotong nilai detail status pekerjaan jika melebihi batas 1024 karakter.

  • Memperbarui skrip bootstrap untuk Windows agar benar membaca jalur akar Greengrass jika jalur itu mencakup spasi.

  • Pembaruan berlanggananAWS IoT Core sehingga menjatuhkan pesan klien jika respons langganan tidak dikirim.

  • Memastikan bahwa nukleus memuat konfigurasinya dari file cadangan ketika file konfigurasi utama rusak atau hilang.

2.9.3

Perbaikan bug dan peningkatan
  • Memastikan ID klien MQTT tidak digandakan.

  • Menambahkan pembacaan dan penulisan file yang lebih kuat untuk menghindari dan pulih dari korupsi.

  • Mencoba kembali gambar docker menarik pada kesalahan terkait jaringan tertentu.

  • MenambahkannoProxyAddresses opsi untuk koneksi MQTT.

2.9.2

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana konfigurasiinterpolateComponentConfiguration tidak berlaku untuk penyebaran yang sedang berlangsung.

  • Menggunakan OSHI untuk daftar semua proses anak.

2.9.1

Perbaikan bug dan peningkatan
  • Menambahkan perbaikan di mana Greengrass restart jika penyebaran menghapus komponen plugin.

2.9.0

Fitur baru
  • Menambahkan kemampuan untuk membuat subdeployment yang mencoba lagi penerapan dengan subset perangkat yang lebih kecil. Fitur ini menciptakan cara yang lebih efisien untuk menguji dan menyelesaikan penerapan yang tidak berhasil.

Perbaikan bug dan peningkatan
  • Meningkatkan dukungan untuk sistem yang tidak memilikiuseradd,groupadd, danusermod.

  • Peningkatan dan perbaikan kecil tambahan.

2.8.1

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana kode kesalahan penyebaran tidak dihasilkan dengan benar dari kesalahan Greengrass API.

  • Memperbaiki masalah saat pembaruan status armada mengirim informasi yang tidak akurat saat komponen mencapaiERRORED status selama penyebaran.

  • Memperbaiki masalah di mana penyebaran tidak dapat diselesaikan ketika Greengrass memiliki lebih dari 50 langganan yang ada.

2.8.0

Fitur baru
  • Memperbarui inti Greengrass untuk melaporkan respons status kesehatan penyebaran yang menyertakan kode kesalahan terperinci saat ada masalah dalam menerapkan komponen ke perangkat inti. Untuk informasi selengkapnya, lihat Kode kesalahan penyebaran terperinci.

  • Memperbarui inti Greengrass untuk melaporkan respons status kesehatan komponen yang menyertakan kode kesalahan terperinci saat komponen memasukiERRORED statusBROKEN atau. Untuk informasi selengkapnya, lihat Kode status komponen rinci.

  • Memperluas bidang pesan status untuk meningkatkan informasi ketersediaan cloud untuk perangkat.

  • Meningkatkan ketahanan layanan status armada.

Perbaikan bug dan peningkatan
  • Memungkinkan komponen yang rusak untuk menginstal ulang saat konfigurasinya berubah.

  • Memperbaiki masalah di mana inti restart selama penyebaran bootstrap menyebabkan penyebaran gagal.

  • Memperbaiki masalah di Windows di mana instalasi gagal saat jalur root berisi spasi.

  • Memperbaiki masalah di mana komponen dimatikan selama penyebaran menggunakan skrip shutdown versi baru.

  • Berbagai perbaikan shutdown.

  • Peningkatan dan perbaikan kecil tambahan.

2.7.0

Fitur baru
  • Memperbarui inti Greengrass untuk mengirim pembaruan status keAWS IoT Greengrass cloud saat perangkat inti menerapkan penerapan lokal.

  • Menambahkan dukungan untuk sertifikat klien yang ditandatangani oleh otoritas sertifikat khusus (CA), di mana CA tidak terdaftarAWS IoT. Untuk menggunakan fitur ini, Anda dapat mengatur opsigreengrassDataPlaneEndpoint konfigurasi baru keiotdata. Untuk informasi selengkapnya, lihat Menggunakan sertifikat perangkat yang ditandatangani oleh CA privat.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana inti Greengrass memutar kembali penyebaran dalam skenario tertentu saat nukleus dihentikan atau dimulai ulang. Inti sekarang melanjutkan penyebaran setelah nukleus dimulai kembali.

  • Memperbarui installer Greengrass untuk menghormati--start argumen ketika Anda menentukan untuk mengatur perangkat lunak sebagai layanan sistem.

  • Memperbarui perilakuSubscribeToComponentUpdates untuk mengatur ID penyebaran dalam peristiwa di mana nukleus memperbarui komponen.

  • Peningkatan dan perbaikan kecil tambahan.

2.6.0

Fitur baru
  • Menambahkan dukungan untuk karakter pengganti MQTT ketika Anda berlangganan topik publikasi/berlangganan lokal. Untuk informasi selengkapnya, lihat Pesan lokal publikasi/berlangganan dan SubscribeToTopic.

  • Menambahkan dukungan untuk variabel resep dalam konfigurasi komponen, selain variabelcomponent_dependency_name:configuration:json_pointer resep. Anda dapat menggunakan variabel resep ini ketika Anda menentukan komponenDefaultConfiguration dalam resep atau ketika Anda mengkonfigurasi komponen dalam penyebaran. Untuk mengaktifkan fitur ini, atur opsi interpolateComponentConfigurationkonfigurasi ketrue. Untuk informasi selengkapnya, lihat Variabel resep dan Gunakan variabel resep di update merge.

  • Menambahkan dukungan penuh untuk* wildcard dalam kebijakan otorisasi komunikasi interprocess (IPC). Anda sekarang dapat menentukan* karakter dalam string sumber daya untuk mencocokkan kombinasi karakter. Untuk informasi selengkapnya, lihat Wildcard di kebijakan otorisasi.

  • Menambahkan dukungan untuk komponen kustom untuk memanggil operasi IPC yang digunakan Greengrass CLI. Anda dapat menggunakan operasi IPC ini untuk mengelola penerapan lokal, melihat detail komponen, dan membuat kata sandi yang dapat Anda gunakan untuk masuk ke konsol debug lokal. Untuk informasi selengkapnya, lihat IPC: Mengelola penyebaran dan komponen lokal.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana komponen dependen tidak akan bereaksi ketika dependensi keras mereka memulai ulang atau mengubah status dalam skenario tertentu.

  • Meningkatkan pesan kesalahan yang dilaporkan perangkat inti ke layananAWS IoT Greengrass cloud saat penyebaran gagal.

  • Memperbaiki masalah di mana inti Greengrass menerapkan penyebaran hal dua kali dalam skenario tertentu saat nukleus dimulai ulang.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.5.6

Fitur baru
  • Menambahkan dukungan untuk modul keamanan perangkat keras yang menggunakan kunci ECC. Anda dapat menggunakan modul keamanan perangkat keras (HSM) untuk menyimpan kunci dan sertifikat pribadi perangkat dengan aman. Untuk informasi selengkapnya, lihat Integrasi keamanan perangkat keras.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana penyebaran tidak pernah selesai saat Anda menyebarkan komponen dengan skrip penginstalan yang rusak dalam skenario tertentu.

  • Meningkatkan kinerja selama startup.

  • Peningkatan dan perbaikan kecil tambahan.

2.5.5

Fitur baru
  • Menambahkan variabelGG_ROOT_CA_PATH lingkungan untuk komponen, sehingga Anda dapat mengakses sertifikat otoritas sertifikat root (CA) di komponen kustom.

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk perangkat Windows yang menggunakan bahasa tampilan selain bahasa Inggris.

  • Memperbarui bagaimana nukleus Greengrass mem-parsing argumen installer Boolean, sehingga Anda dapat menentukan argumen Boolean tanpa nilai Boolean untuk menentukantrue nilai. Misalnya, Anda sekarang dapat menentukan--provision alih-alih--provision true menginstal dengan penyediaan sumber daya otomatis.

  • Memperbaiki masalah di mana perangkat inti tidak melaporkan statusnya ke layananAWS IoT Greengrass cloud setelah penyediaan dalam skenario tertentu.

  • Peningkatan dan perbaikan kecil tambahan.

2.5.4

Perbaikan bug dan peningkatan
  • Penyempurnaan dan perbaikan bug umum.

2.5.3

Fitur baru
  • Menambahkan dukungan untuk integrasi keamanan perangkat keras. Anda dapat menggunakan modul keamanan perangkat keras (HSM) untuk menyimpan kunci dan sertifikat pribadi perangkat dengan aman. Untuk informasi selengkapnya, lihat Integrasi keamanan perangkat keras.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah dengan pengecualian runtime sementara nukleus membuat koneksi MQTT denganAWS IoT Core.

2.5.2

Perbaikan bug dan peningkatan
  • Memperbaiki masalah di mana setelah Greengrass nucleus update, layanan Windows gagal untuk memulai lagi setelah Anda menghentikannya atau reboot perangkat.

2.5.1

Awas

Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru.

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk versi 32-bit dari Java Runtime Environment (JRE) di Windows.

  • Mengubah hal perilaku penghapusan grup untuk perangkat inti yangAWS IoT kebijakannya tidak memberikangreengrass:ListThingGroupsForCoreDevice izin. Dengan versi ini, penyebaran berlanjut, mencatat peringatan, dan tidak menghapus komponen saat Anda menghapus perangkat inti dari grup hal. Untuk informasi selengkapnya, lihat Deploy komponen AWS IoT Greengrass ke perangkat.

  • Memperbaiki masalah dengan variabel lingkungan sistem yang disediakan oleh nukleus Greengrass untuk proses komponen Greengrass. Anda sekarang dapat me-restart komponen untuk itu untuk menggunakan variabel lingkungan sistem terbaru.

2.5.0

Fitur baru
  • Menambahkan dukungan untuk perangkat inti yang menjalankan Windows.

  • Mengubah perilaku penghapusan kelompok hal. Dengan versi ini, Anda dapat menghapus perangkat inti dari grup objek untuk menghapus komponen grup objek itu di penyebaran berikutnya.

    Sebagai hasil dari perubahan ini,AWS IoT kebijakan perangkat inti harus memilikigreengrass:ListThingGroupsForCoreDevice izin. Jika Anda menggunakan penginstal perangkat lunakAWS IoT Greengrass inti untuk menyediakan sumber daya,AWS IoT kebijakan default mengizinkangreengrass:*, yang mencakup izin ini. Untuk informasi selengkapnya, lihat Autentikasi dan otorisasi perangkat untuk AWS IoT Greengrass.

  • Menambahkan dukungan untuk konfigurasi proxy HTTPS. Untuk informasi selengkapnya, lihat Hubungkan pada port 443 atau melalui proksi jaringan.

  • Menambahkan parameterwindowsUser konfigurasi baru. Anda dapat menggunakan parameter ini untuk menentukan pengguna default yang akan digunakan untuk menjalankan komponen pada perangkat inti Windows. Untuk informasi selengkapnya, lihat Mengkonfigurasi pengguna yang menjalankan komponen.

  • Menambahkan opsihttpClient konfigurasi baru yang dapat Anda gunakan untuk menyesuaikan batas waktu tunggu permintaan HTTP untuk meningkatkan kinerja pada jaringan yang lambat. Untuk informasi selengkapnya, lihat parameter konfigurasi httpClient.

Perbaikan bug dan peningkatan
  • Memperbaiki opsi siklus hidup bootstrap untuk me-restart perangkat inti dari komponen.

  • Menambahkan dukungan untuk tanda hubung dalam variabel resep.

  • Memperbaiki otorisasi IPC untuk komponen fungsi Lambda sesuai permintaan.

  • Meningkatkan pesan log dan mengubah log non-kritis dariINFO keDEBUG tingkat, sehingga log lebih berguna.

  • Menghapusiot:DescribeCertificate izin dari peran pertukaran token default yang dibuat nukleus Greengrass saat Anda menginstal perangkat lunakAWS IoT Greengrass Inti dengan penyediaan otomatis. Izin ini tidak digunakan oleh inti Greengrass.

  • Memperbaiki masalah sehingga skrip penyediaan otomatis tidak memerlukaniam:GetPolicy izin jikaiam:CreatePolicy tersedia untuk kebijakan yang sama.

  • Peningkatan dan perbaikan kecil tambahan.

2.4.0

Fitur baru
Perbaikan bug dan peningkatan
  • Update logging konfigurasi pada startup. Ini memperbaiki masalah di mana konfigurasi logging tidak diterapkan pada startup.

  • Memperbarui symlink nucleus loader untuk menunjuk ke penyimpanan komponen di folder root Greengrass selama instalasi. Pembaruan ini memungkinkan Anda untuk menghapus file JAR dan artefak nukleus lainnya yang Anda download ketika Anda menginstal perangkat lunakAWS IoT Greengrass inti.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.3.0

Fitur baru
  • Menambahkan variabel resep iot:thingName. Anda dapat menggunakan variabel resep ini untuk mendapatkan nama objek AWS IoT perangkat inti dalam resep. Untuk informasi selengkapnya, lihat Variabel resep.

Perbaikan bug dan peningkatan
  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.2.0

Fitur baru
  • Menambahkan operasi IPC untuk manajemen bayangan lokal.

Perbaikan bug dan peningkatan
  • Mengurangi ukuran file JAR.

  • Mengurangi penggunaan memori.

  • Memperbaiki masalah di mana konfigurasi log tidak diperbarui dalam kasus tertentu.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.1.0

Fitur baru
  • Mendukung pengunduhan gambar Docker dari repositori privat di Amazon ECR.

  • Menambahkan parameter berikut untuk menyesuaikan konfigurasi MQTT pada perangkat inti:

    • maxInFlightPublishes - Jumlah maksimum pesan MQTT QoS 1 yang tidak diakui yang dapat terbang pada waktu yang sama.

    • maxPublishRetry - Jumlah waktu maksimum untuk mencoba kembali pesan yang gagal untuk dipublikasikan.

  • Menambahkan parameter konfigurasi fleetstatusservice untuk mengonfigurasi interval di mana perangkat inti menerbitkan status perangkat untuk AWS Cloud.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

Perbaikan bug dan peningkatan
  • Memperbaiki masalah yang menyebabkan deployment bayangan diduplikasi saat nukleus dimulai ulang.

  • Memperbaiki masalah yang menyebabkan nukleus lumpuh saat mengalami pengecualian beban layanan.

  • Meningkatkan resolusi dependensi komponen untuk menggagalkan deployment yang mencakup dependensi melingkar.

  • Memperbaiki masalah yang mencegah komponen plugin di-deploy ulang jika komponen tersebut sebelumnya telah dihapus dari perangkat inti.

  • Memperbaiki masalah yang menyebabkan variabel lingkungan HOME yang akan ditetapkan ke direktori /greengrass/v2/work untuk komponen Lambda atau untuk komponen yang berjalan sebagai root. Variabel HOME sekarang diatur dengan tepat ke direktori home untuk pengguna yang menjalankan komponen.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.0.5

Perbaikan bug dan peningkatan
  • Dengan benar mengarahkan lalu lintas melalui proksi jaringan yang dikonfigurasi saat mengunduh komponen yang disediakan oleh AWS.

  • Menggunakan titik akhir bidang data Greengrass yang benar di Wilayah Cina AWS.

2.0.4

Fitur baru
  • Memungkinkan lalu lintas HTTPS melalui port 443. Anda dapat menggunakan parameter konfigurasi greengrassDataPlanePort untuk versi 2.0.4 komponen inti untuk mengonfigurasi komunikasi HTTPS untuk berjalan melalui port 443 dan bukan port default 8443. Untuk informasi selengkapnya, lihat Konfigurasikan HTTPS melalui port 443.

  • Menambahkan variabel resep jalur kerja. Anda dapat menggunakan variabel resep ini untuk mendapatkan jalur ke folder kerja komponen, yang dapat Anda gunakan untuk berbagi file antara komponen dan dependensinya. Untuk informasi lebih lanjut, lihat variabel resep jalur kerja.

Perbaikan bug dan peningkatan
  • Mencegah terciptanya kebijakan (IAM) role AWS Identity and Access Management pertukaran token jika kebijakan peran sudah ada.

    Akibat dari perubahan ini, penginstal sekarang memerlukan iam:GetPolicy dan sts:GetCallerIdentity ketika dijalankan dengan --provision true. Untuk informasi selengkapnya, lihat Kebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya.

  • Secara tepat menangani pembatalan deployment yang belum berhasil didaftarkan.

  • Meng-update konfigurasi untuk menghapus entri lama dengan cap waktu yang lebih baru ketika memutar kembali deployment.

  • Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat changelog aktifGitHub.

2.0.3

Versi awal.