Versi Persyaratan perangkat Platform yang didukung Sistem operasi Persyaratan Dependensi Unduh dan instalasi Konfigurasi File log lokal Changelog

Inti Greengrass

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

catatan

Pada Greengrass versi 2.14.0, versi runtime perangkat inti yang dioptimalkan untuk jejak memori tersedia untuk perangkat tepi terbatas. Lihat Greengrass nucleus lite untuk informasi lebih lanjut tentang konfigurasi dan penggunaannya.

penting

Ketika versi komponen inti berubah, atau ketika Anda mengubah parameter konfigurasi tertentu, perangkat lunak Inti—yang mencakup nukleus dan semua komponen lain pada perangkat Anda—memulai ulang untuk menerapkan perubahan. AWS IoT Greengrass

Saat Anda menerapkan komponen, AWS IoT Greengrass instal versi terbaru yang didukung dari semua dependensi komponen tersebut. Karena itu, versi patch baru dari komponen publik yang AWS disediakan dapat diterapkan secara otomatis ke perangkat inti Anda jika Anda menambahkan perangkat baru ke grup benda, atau Anda memperbarui penerapan 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 AWS IoT Greengrass Core, lihatPerbarui AWS IoT Greengrass Perangkat lunak inti (OTA).

Versi

Komponen ini memiliki versi berikut:

2.18.x
2.17.x
2.16.x
2.15.x
2.14.x
2.13.x
2.12.x
2.11.x
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

Persyaratan perangkat

catatan

Anda dapat menggunakan AWS IoT Device Tester for AWS IoT Greengrass untuk memverifikasi bahwa perangkat Anda dapat menjalankan perangkat lunak AWS IoT Greengrass Core dan berkomunikasi dengan AWS Cloud. Untuk informasi selengkapnya, lihat Penggunaan AWS IoT Device Tester untuk AWS IoT Greengrass V2.

Linux

Penggunaan Wilayah AWS yang mendukung AWS IoT Greengrass V2. Untuk daftar Wilayah yang didukung, lihat AWS IoT Greengrass V2 titik akhir dan kuota di Referensi Umum AWS.
Ruang disk minimum 256 MB tersedia untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang di-deploy ke perangkat inti.
Minimum 96 MB RAM dialokasikan untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang berjalan pada perangkat inti. Untuk informasi selengkapnya, lihat Kontrol alokasi memori dengan opsi JVM.
Java Runtime Environment (JRE) versi 8 atau lebih tinggi. Java harus tersedia pada variabel lingkungan PATH pada perangkat. Untuk menggunakan Java untuk mengembangkan komponen khusus, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang Amazon Corretto atau OpenJDK. Diperlukan versi 8 atau lebih tinggi.
Pustaka GNU C (glibc) versi 2.25 atau lebih besar.
Anda dapat menjalankan perangkat lunak AWS IoT Greengrass Core sebagai pengguna root. Gunakan sudo, misalnya. Anda juga dapat menjalankan perangkat lunak AWS IoT Greengrass Core sebagai pengguna non-root. Untuk informasi selengkapnya, lihat Penyiapan AWS IoT Greengrass V2 perangkat inti sebagai non-root.
Pengguna root yang menjalankan perangkat lunak AWS IoT Greengrass Core, sepertiroot, harus memiliki izin untuk berjalan sudo dengan pengguna dan grup apa pun. File /etc/sudoers harus memberikan izin kepada pengguna ini untuk menjalankan sudo sebagai grup lain. Izin untuk pengguna di /etc/sudoers seharusnya terlihat seperti contoh berikut.
```
root    ALL=(ALL:ALL) ALL
```
Perangkat inti harus dapat melakukan permintaan keluar ke satu set titik akhir dan port. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.
Direktori /tmp harus dipasang dengan izin exec.
Semua perintah shell berikut:
- ps -ax -o pid,ppid
- sudo
- sh
- kill
- cp
- chmod
- rm
- ln
- echo
- exit
- id
- uname
- grep
Perangkat Anda mungkin juga memerlukan perintah shell opsional berikut:
- (Opsional)systemctl. Perintah ini digunakan untuk mengatur perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem.
- (Opsional)useradd,groupadd, danusermod. Perintah ini digunakan untuk mengatur pengguna ggc_user sistem dan grup ggc_group sistem.
- (Opsional)mkfifo. Perintah ini digunakan untuk menjalankan fungsi Lambda sebagai komponen.
Untuk mengonfigurasi batas sumber daya sistem untuk proses komponen, perangkat Anda harus menjalankan kernel Linux versi 2.6.24 atau yang lebih baru.
Untuk menjalankan fungsi Lambda, perangkat Anda harus memenuhi persyaratan tambahan. Untuk informasi selengkapnya, lihat Persyaratan fungsi Lambda.

penting

Pada Ubuntu 25.10 dan yang lebih baru, sudo implementasi default tidak mendukung flag -E (menjaga lingkungan). Tanpa tanda ini, sistem tidak meneruskan variabel lingkungan ke komponen yang berjalan sebagai pengguna sistem yang berbeda. Akibatnya, komponen-komponen tersebut gagal memulai.

Untuk mengatasi masalah ini, beralih ke sudo implementasi klasik (sudo.ws). Anda harus membuat perubahan ini karena AWS IoT Greengrass menggunakan -E flag untuk meneruskan variabel lingkungan ke proses komponen.


sudo update-alternatives --set sudo /usr/bin/sudo.ws

Windows

Penggunaan Wilayah AWS yang mendukung AWS IoT Greengrass V2. Untuk daftar Wilayah yang didukung, lihat AWS IoT Greengrass V2 titik akhir dan kuota di Referensi Umum AWS.
Ruang disk minimum 256 MB tersedia untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang di-deploy ke perangkat inti.
Minimum 160 MB RAM dialokasikan untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang berjalan pada perangkat inti. Untuk informasi selengkapnya, lihat Kontrol alokasi memori dengan opsi JVM.
Java Runtime Environment (JRE) versi 8 atau lebih tinggi. Java harus tersedia pada variabel sistem PATH pada perangkat. Untuk menggunakan Java untuk mengembangkan komponen khusus, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang Amazon Corretto atau OpenJDK. Diperlukan versi 8 atau lebih tinggi..

catatan
Untuk menggunakan versi 2.5.0 dari inti Greengrass, Anda harus menggunakan versi 64-bit dari Java Runtime Environment (JRE). Greengrass nucleus versi 2.5.1 mendukung JRE 32-bit dan 64-bit.
Pengguna yang menginstal perangkat lunak AWS IoT Greengrass Core harus menjadi administrator.
Anda harus menginstal perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem. Tentukan --setup-system-service true kapan Anda menginstal perangkat lunak.
Setiap pengguna yang menjalankan proses komponen harus ada di LocalSystem akun, dan nama serta kata sandi pengguna harus berada di instance Credential Manager untuk LocalSystem akun tersebut. Anda dapat mengatur pengguna ini ketika Anda mengikuti instruksi untuk menginstal perangkat lunak AWS IoT Greengrass Core.
Perangkat inti harus dapat melakukan permintaan keluar ke satu set titik akhir dan port. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Platform yang didukung

AWS IoT Greengrass secara resmi mendukung perangkat yang menjalankan platform berikut. Perangkat dengan platform yang tidak termasuk dalam daftar ini mungkin berfungsi, tetapi AWS IoT Greengrass pengujian hanya pada platform yang ditentukan ini.

Pertimbangan fitur

Beberapa AWS IoT Greengrass fitur saat ini tidak didukung di perangkat Windows. Tinjau perbedaan fitur untuk mengonfirmasi apakah perangkat Windows memenuhi persyaratan Anda. Untuk informasi selengkapnya, lihat Kompatibilitas fitur Greengrass.

Untuk membangun sistem Linux-based operasi khusus, Anda dapat menggunakan BitBake resep untuk AWS IoT Greengrass dalam meta-aws proyek. meta-awsProyek ini menyediakan resep yang dapat Anda gunakan untuk membangun kemampuan perangkat lunak AWS tepi dalam sistem Linux tertanam yang dibangun dengan OpenEmbedded dan kerangka kerja pembangunan Proyek Yocto. Proyek Yocto adalah proyek kolaborasi sumber terbuka yang membantu Anda membangun Linux-based sistem khusus untuk aplikasi tertanam terlepas dari arsitektur perangkat keras. BitBake Resep untuk AWS IoT Greengrass menginstal, mengonfigurasi, dan secara otomatis menjalankan perangkat lunak AWS IoT Greengrass Core di perangkat Anda.

Platform Linux juga dapat berjalan AWS IoT Greengrass dalam wadah Docker. Untuk informasi selengkapnya, lihat Jalankan perangkat lunak AWS IoT Greengrass Core dalam wadah Docker.

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 inti Greengrass dan perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat Persyaratan perangkat.

Komponen inti Greengrass didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan.

Komponen inti Greengrass harus memiliki konektivitas ke AWS IoT data, Cre AWS IoT dentials, dan Amazon S3.

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 instalasi

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 menciptakan AWS sumber daya yang diperlukan untuk Anda, atau instalasi manual tempat Anda membuat AWS sumber daya sendiri. Untuk informasi selengkapnya, lihat Instal perangkat lunak AWS IoT Greengrass Core.

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

Konfigurasi

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

iotRoleAlias

Alias AWS IoT peran yang menunjuk ke peran IAM pertukaran token. Penye AWS IoT dia kredenSIAL mengambil peran ini untuk memungkinkan perangkat inti Greengrass berinteraksi dengan AWS layanan. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan layanan AWS.

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

interpolateComponentConfiguration

(Opsional) Anda dapat mengaktifkan inti Greengrass untuk menginterpolasi variabel resep komponen dalam konfigurasi komponen dan menggabungkan pembaruan konfigurasi. Kami menyarankan Anda mengatur opsi ini true agar perangkat inti dapat menjalankan komponen Greengrass yang menggunakan variabel resep dalam konfigurasinya.

Fitur ini tersedia untuk v2.6.0 dan 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

Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan memulai ulang agar perubahan diterapkan.

Objek ini berisi informasi berikut:

noProxyAddresses

(Opsional) Daftar alamat IP atau nama host yang dipisahkan koma yang dikecualikan dari proxy.

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 mengabaikan bidang username danpassword.
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 mengotentikasi server proxy.

password

(Opsional) Kata sandi yang mengotentikasi server proxy.

mqtt

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

penting

Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan memulai ulang agar perubahan 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. Nilai ini harus lebih besar daripingTimeoutMs.

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. Nilai ini harus kurang darikeepAliveTimeoutMs.

Default: 30000 (30 detik)

operationTimeoutMs

(Opsional) Jumlah waktu dalam milidetik yang klien menunggu operasi MQTT (seperti CONNECT atau) untuk diselesaikan. PUBLISH Opsi ini tidak berlaku untuk pesan MQTT PING atau tetap hidup.

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

standaloneMqttTimeoutMs

(Opsional) Waktu, dalam milidetik, dimana nukleus menunggu koneksi MQTT mandiri selama operasi sakelar konektivitas IoT. Batas waktu ini mencakup pemeriksaan konektivitas pra-penerbangan dan laporan status yang dikirim nukleus ke akun sumber setelah peralihan berhasil.

Fitur ini membutuhkan v2.18.0 atau yang lebih baru dari komponen ini.

Default: 60000 (60 detik)

Rentang yang valid: Nilai minimum 1

spooler

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

storageType

Jenis penyimpanan untuk menyimpan pesan. Jika storageType disetel keDisk, pluginName dapat dikonfigurasi. Anda dapat menentukan Memory atau Disk.

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

penting

Jika spooler MQTT dis storageType etel ke Disk dan Anda ingin menurunkan inti Greengrass dari versi 2.11.x ke versi sebelumnya, Anda harus mengubah konfigurasi kembali ke. Memory Satu-satunya konfigurasi untuk itu storageType yang didukung di Greengrass nucleus versi 2.10.x dan sebelumnya adalah. Memory Tidak mengikuti panduan ini dapat mengakibatkan spooler pecah. Ini akan menyebabkan perangkat inti Greengrass Anda tidak dapat mengirim pesan MQTT ke. AWS Cloud

Default: Memory

pluginName

(Opsional) Nama komponen plugin. Komponen ini hanya akan digunakan jika storageType disetel keDisk. Opsi ini default ke aws.greengrass.DiskSpooler dan akan menggunakan. Greengrass-provided Spooler disk

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

Default: "aws.greengrass.DiskSpooler"

maxSizeInBytes

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

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 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 yang lebih baru dari komponen inti Greengrass.

Default: 100

sessionExpirySeconds

(Opsional) Jumlah waktu dalam detik yang dapat Anda minta agar sesi berlangsung dari IoT Core. Defaultnya adalah waktu maksimum yang didukung oleh AWS IoT Core.

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

Default: 604800 (7 days)

minimumReconnectDelaySeconds

(Opsional) Pilihan untuk perilaku koneksi ulang. Jumlah minimum waktu dalam detik untuk MQTT untuk menyambung kembali.

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

Default: 1

maximumReconnectDelaySeconds

(Opsional) Pilihan untuk perilaku koneksi ulang. Jumlah waktu maksimum dalam detik untuk MQTT untuk menyambung kembali.

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

Default: 120

minimumConnectedTimeBeforeRetryResetSeconds

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

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

Default: 30

jvmOptions

(Opsional) Opsi JVM untuk digunakan untuk menjalankan perangkat lunak AWS IoT Greengrass Core. Untuk informasi tentang opsi JVM yang direkomendasikan untuk menjalankan perangkat lunak AWS IoT Greengrass Core, lihatKontrol alokasi memori dengan opsi JVM.

penting

Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan memulai ulang agar perubahan diterapkan.

iotDataEndpoint

T AWS IoT itik akhir data untuk Anda Akun AWS.

Saat Anda menjalankan perangkat lunak AWS IoT Greengrass Core dengan --provision true opsi, perangkat lunak mendapatkan data dan titik akhir kredenSIAL Anda dari AWS IoT dan menyetelnya di komponen inti.

iotCredEndpoint

Titik akhir AWS IoT kredenSIAL untuk Anda Akun AWS.

greengrassDataPlaneEndpoint

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

(Opsional) Titik akhir bidang data Greengrass untuk digunakan. Setel iotdata untuk menggunakan titik akhir yang sama dengan titik akhir data IoT yang ditentukan diiotDataEndpoint.

Anda harus mengatur opsi ini ke iotdata dalam kasus berikut:

Anda menggunakan sertifikat perangkat yang ditandatangani oleh otoritas sertifikat pribadi (CA). Untuk informasi selengkapnya, lihat Menggunakan sertifikat perangkat yang ditandatangani oleh CA pribadi.
Anda menerapkan pembaruan konfigurasi inti untuk mengalihkan konektivitas IoT perangkat ke Wilayah Akun AWS atau yang berbeda. Tanpa pengaturan ini, bidang data tetap terikat ke akun asli setelah sakelar konektivitas. Ini merusak unduhan artefak komponen dan operasi bidang kontrol. Untuk informasi selengkapnya, lihat Ganti perangkat inti Greengrass ke perangkat yang berbeda Akun AWS atau Wilayah.

Anda dapat mengatur opsi ini selama penerapan atau instalasi menggunakan argumen --init-config penginstal.

Default: "" (string kosong - menggunakan titik akhir layanan Greengrass)

greengrassDataPlanePort

Fitur ini tersedia di v2.0.4 dan 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 terhubung AWS IoT Greengrass untuk menerima penerapan.

Pilih dari salah satu pilihan berikut:

443
8443

Default: 8443

awsRegion

Wilayah AWS Untuk digunakan.

runWithDefault

Pengguna sistem yang digunakan untuk menjalankan komponen.

penting

Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan memulai ulang agar perubahan diterapkan.

Objek ini berisi informasi berikut:

posixUser

Nama atau ID pengguna sistem dan, secara opsional, grup sistem yang digunakan 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 lunak AWS IoT Greengrass Core menggunakan grup utama untuk pengguna. Misalnya, Anda dapat menentukan ggc_user atau ggc_user:ggc_group. Untuk informasi selengkapnya, lihat Konfigurasikan pengguna yang menjalankan komponen.

Ketika Anda menjalankan peng AWS IoT Greengrass instal perangkat lunak inti dengan --component-default-user ggc_user:ggc_group opsi, perangkat lunak menetapkan parameter ini di komponen inti.

windowsUser

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

Nama pengguna Windows yang akan digunakan untuk menjalankan komponen ini pada perangkat inti Windows. Pengguna harus ada di setiap perangkat inti Windows, dan nama serta kata sandinya harus disimpan dalam instance LocalSystem Credentials Manager akun. Untuk informasi selengkapnya, lihat Konfigurasikan pengguna yang menjalankan komponen.

Ketika Anda menjalankan peng AWS IoT Greengrass instal perangkat lunak inti dengan --component-default-user ggc_user opsi, perangkat lunak menetapkan parameter ini di komponen inti.

systemResourceLimits

Fitur ini tersedia di v2.4.0 dan yang lebih baru dari komponen ini. AWS IoT Greengrass saat 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 komponen individual saat membuat penerapan. Untuk informasi selengkapnya, lihat Konfigurasikan 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 ini 2 untuk membatasi setiap proses komponen hingga 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini 0.25 untuk membatasi setiap proses komponen hingga 25 persen penggunaan CPU. Jika Anda menetapkan nilai ini ke angka yang lebih besar dari jumlah inti CPU, perangkat lunak AWS IoT Greengrass Core tidak membatasi penggunaan CPU komponen.
memory: Jumlah maksimum RAM (dalam kilobyte) yang dapat digunakan setiap proses komponen pada perangkat inti.

s3EndpointType

(Opsional) Jenis titik akhir S3. Parameter ini hanya akan berlaku untuk Wilayah AS Timur (Virginia Utaraus-east-1) (). Mengatur parameter ini dari Wilayah lain akan diabaikan. Pilih dari salah satu pilihan berikut:

REGIONAL— Klien S3 dan URL yang telah ditandatangani menggunakan titik akhir regional.
GLOBAL— Klien S3 dan URL yang telah ditandatangani menggunakan titik akhir lama.
DUALSTACK— URL yang ditandatangani sebelumnya S3 menggunakan titik akhir dualstack.

Default: GLOBAL

fipsMode

(Opsional) Menyebabkan Greengrass menggunakan titik akhir FIPS. Untuk informasi selengkapnya tentang cara mengaktifkan titik akhir FIPS, lihat titik akhir FIPS.

Pilih dari salah satu pilihan berikut:

trueKetika disetel ke true, titik akhir akan menggunakan titik akhir FIPS.
falseJika salah, titik akhir tidak akan menggunakan titik akhir FIPS.

Default: false

logging

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

Objek ini berisi informasi berikut:

level

(Opsional) Tingkat minimum pesan log untuk output.

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 log Greengrass CLI atau berinteraksi dengan log secara terprogram.

Default: TEXT

outputType

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

FILE- Perangkat lunak AWS IoT Greengrass Core mengeluarkan log ke file di direktori yang Anda tentukanoutputDirectory.
CONSOLE— Perangkat lunak AWS IoT Greengrass Core mencetak log kestdout. 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 lunak AWS IoT Greengrass Core 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 inti Greengrass juga menyertakan log dari komponen plugin. Setelah ukuran total file log komponen melebihi ukuran maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen tersebut.

Parameter ini setara dengan parameter batas ruang Manajer log disk komponen pengelola log (diskSpaceLimit), yang dapat Anda tentukan untuk inti Greengrass (sistem) dan setiap komponen. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dari dua nilai sebagai ukuran log total 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 /greengrass/v2 mana folder AWS IoT Greengrass root.

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.

Minimum: 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 kesehatan 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.

Minimal: 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.

Minimal: 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)

bootConfigTlogCompactionThresholdBytes

Parameter ini tersedia di v2.18.3 dan yang lebih baru dari komponen ini.

(Opsional) Ambang batas ukuran, dalam byte, di mana inti Greengrass memadatkan log transaksi konfigurasi (config.tlog) saat perangkat inti dimulai.

Pemadatan tidak mengubah konfigurasi Anda. Ini hanya menghapus entri usang dari log, yang mengurangi waktu startup dan penggunaan disk pada perangkat inti.

Untuk menonaktifkan pemadatan waktu boot, atur nilai ini ke 0 atau nilai negatif.

Tentukan ambang batas sebagai sejumlah byte, seperti10000000. Nukleus juga menerima notasi ilmiah, seperti1e7. Jika Anda menetapkan nilai yang bukan angka, seperti20MB, nukleus menggunakan nilai default dan merekam peringatan di lognya. Nilai yang tidak valid tidak mematikan pemadatan.

catatan

Pemadatan tidak mencegah perangkat Anda memulai. Jika nukleus tidak dapat memadatkan log, perangkat inti dimulai secara normal dengan log yang tidak dipadatkan dan mencatat kesalahan dalam lognya. Nukleus mencoba lagi saat berikutnya perangkat inti dimulai.

Standar: 10000000 (10 MB)

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 di v2.5.0 dan 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 habis waktu.

Objek ini berisi informasi berikut:

connectionTimeoutMs

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

Default: 2000 (2 detik)

socketTimeoutMs

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

Default: 30000 (30 detik)

deploymentConfigurationTimeSource

Parameter ini tersedia di v2.15.0 dan yang lebih baru dari komponen ini.

(Opsional) Stempel waktu yang digunakan saat memproses penerapan. Defaultnya adalahdeploymentCreationTime.

Objek ini berisi nilai-nilai berikut:

deploymentCreationTime

Nilai default darideploymentConfigurationTimeSource. Perangkat menggunakan stempel waktu pembuatan penerapan untuk menyelesaikan konflik kunci konfigurasi selama pemrosesan. Ketika perilaku ini dipilih, konfigurasi perangkat lokal yang dipegang oleh nukleus mungkin memiliki cap waktu yang lebih besar daripada penerapan yang masuk dan menolak perubahan konfigurasi masuk yang sekarang dianggap usang.

deploymentProcessingTime

Perangkat menggunakan stempel waktu lokal untuk menyelesaikan konflik kunci konfigurasi selama pemrosesan penerapan. Saat diproses, perangkat memperbarui konfigurasi berdasarkan stempel waktu pemrosesan daripada stempel waktu pembuatan penerapan. Perilaku ini mengasumsikan jam perangkat dikalibrasi dengan benar.

Konfigurasikan pengaturan inti ini di image atau instalasi perangkat awal Anda daripada melalui penerapan saat Anda ingin perangkat baru menggunakan perilaku ini pada koneksi pertama. Gunakan --init-config opsi penginstal nucleus classic untuk konfigurasi ini.

Konfigurasi awal ini sangat penting karena perangkat memproses beberapa penerapan dalam urutan yang sewenang-wenang. Tanpa konfigurasi awal yang tepat, perangkat mungkin memproses penerapan menggunakan deploymentCreationTime perilaku default sebelum menerima penerapan yang menetapkan konfigurasi inti ke. deploymentProcessingTime

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.

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.18.3	Fitur baru Menambahkan parameter `bootConfigTlogCompactionThresholdBytes` konfigurasi untuk mengaktifkan pemadatan log transaksi konfigurasi saat boot, yang mengklaim kembali ruang disk pada perangkat inti. Perbaikan bug dan peningkatan Memperbaiki masalah di mana penerapan pertama yang gagal dapat menyebabkan inti kehilangan keanggotaan grup perangkat dan menghapus komponen yang diinstal setelah restart.
2.18.2	Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus dapat menulis nilai konfigurasi yang tidak berubah ke penyimpanan konfigurasi.
2.18.1	Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus mungkin gagal mengambil kredenSIAL setelah kegagalan koneksi sementara.
2.18.0	Fitur baru Menambahkan dukungan untuk mengalihkan AWS IoT konektivitas perangkat inti ke wilayah Akun AWS atau yang berbeda melalui penyebaran konfigurasi nukleus. Nukleus memvalidasi konektivitas ke titik akhir baru sebelum menerapkan perubahan, dan melaporkan status penyebaran terminal ke akun sumber. Menambahkan dukungan untuk Windows Server 2025. Perbaikan bug dan peningkatan Memperbaiki masalah waktu startup pada perangkat systemd dengan memulai perangkat lunak AWS IoT Greengrass Core hanya setelah jam sistem disinkronkan. Memperbaiki masalah di mana komponen mungkin mengalami langganan basi setelah menutup aliran IPC lokal selama permintaan berlangganan yang sedang berlangsung. Perbaikan bug umum dan perbaikan.
2.17.0	Fitur baru Menginstal semua sertifikat CA Root Amazon selama penyediaan otomatis. Menambahkan siklus proses uninstall yang berjalan saat penerapan menghapus komponen. Memungkinkan menginstal perangkat lunak Greengrass Core sebagai pengguna Linux biasa.
2.16.1	Perbaikan bug dan peningkatan Menambahkan konfigurasi untuk interval coba ulang kredensi setelah kegagalan Layanan Exchange Token.
2.16.0	Fitur baru Nucleus sekarang mendukung cgroups V2. Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus tidak akan membersihkan penerapan basi saat penerapan dibatalkan.
2.15.1	Perbaikan bug dan peningkatan Memperbaiki masalah dimana nukleus gagal membersihkan proses komponen setelah batas waktu shutdown 30 detik selama penerapan bootstrap.
2.15.0	Fitur baru Menambahkan fitur telemetri untuk menyertakan informasi sistem host seperti CPU dan detail OS. Untuk informasi selengkapnya, lihat halaman komponen telemetri. Menambahkan `deploymentConfigurationTimeSource` konfigurasi. Untuk informasi selengkapnya, lihat konfigurasi komponen inti. Perbaikan bug dan peningkatan Nucleus sekarang memprioritaskan penggunaan versi lokal dan artefak secara default, meningkatkan konsistensi penerapan dan mengurangi dependensi eksternal. Pengguna dapat mengganti perilaku ini dengan menentukan preferensi alternatif dalam dokumen penerapan. Menambahkan log peringatan baru ketika pengguna Windows yang disediakan tidak cocok dengan set karakter yang biasanya diterima oleh Windows.
2.14.3	Perbaikan bug dan peningkatan Memungkinkan layanan pertukaran token untuk memulai ulang pada perubahan konfigurasi port. Memperbaiki masalah ketika layanan status armada tidak mengirim pesan perubahan status komponen untuk lambda yang tidak disematkan jika tidak dipicu. Memperbaiki masalah di mana komponen tidak dimatikan dengan anggun saat versi komponen baru diterapkan. Memperbaiki masalah di mana kait injeksi plugin bawaan dijalankan dua kali sehingga menghasilkan peristiwa siklus hidup tambahan dan pencatatan duplikat. Meningkatkan pencatatan siklus hidup komponen pada perangkat Windows.
2.14.2	Perbaikan bug dan peningkatan Memperbaiki masalah di mana klien HTTP tidak dikonfigurasi dengan auth bersama.
2.14.1	Perbaikan bug dan peningkatan Memperbaiki masalah di mana komponen tidak dihentikan dengan benar pada instalasi baru Greengrass.
2.14.0	Awas Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru. Fitur baru Dukungan titik akhir dual-stack baru memungkinkan komunikasi jaringan IPv6. Peningkatan ketahanan terhadap kegagalan restart nukleus dan korupsi `Launch` direktori. Perbaikan bug dan peningkatan Memperbaiki kebocoran memori dalam penutupan PubSub langganan IPC. Memperbaiki siklus hidup komponen yang masuk ke status ERRORED karena batas waktu startup saat kondisi skipif benar. Memperbaiki masalah ketika perangkat inti gagal terhubung AWS IoT Core ketika kebijakan TLS disetel ke TLS13_1_3_2022_10.
2.13.0	Fitur baru Mendukung titik akhir FIPS di Nucleus. Perbaikan bug dan peningkatan Batalkan peningkatan penerapan: Penerapan sekarang dapat dibatalkan saat konfigurasi baru digabungkan dan sambil menunggu layanan dimulai.
2.12.6	Perbaikan bug dan peningkatan Memperbaiki masalah yang menyebabkan crash saat startup pada prosesor ARMv8 tertentu, termasuk Jetson Nano.
2.1.5	Perbaikan bug dan peningkatan Memperbaiki masalah di mana rollback penerapan terkadang macet saat memutar kembali komponen yang sebelumnya rusak dengan dependensi keras. Memperbaiki masalah dimana nukleus tidak menerbitkan pembaruan status setelah penyediaan armada. Menambahkan percobaan ulang untuk `GetDeploymentConfiguration` API setelah mendapatkan kesalahan 404.
2.12.4	Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus memasuki kondisi kebuntuan selama startup pada beberapa perangkat Linux.
2.12.3	Awas Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru. Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus tidak melaporkan status komponen yang benar setelah nukleus diluncurkan kembali dan selama pemulihan komponen. Perbaikan bug umum dan perbaikan.
2.12.2	Perbaikan bug dan peningkatan Memperbaiki masalah di mana log lama tidak dibersihkan dengan benar. Perbaikan bug umum dan perbaikan.
2.12.1	Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus dapat menduplikasi langganan MQTT ke topik penerapan yang mengarah ke pencatatan tambahan dan penerbitan MQTT.
2.12.0	Fitur baru Memungkinkan Anda menjalankan langkah-langkah siklus hidup bootstrap sebagai bagian dari penerapan rollback.
2.11.3	Perbaikan bug dan peningkatan Memperbaiki masalah di nukleus di mana komponen dapat memulai dengan tidak benar ketika dependensinya gagal. Fitur baru Menambahkan tipe titik akhir s3 yang dapat dikonfigurasi.
2.11.2	Perbaikan bug dan peningkatan Memperbaiki masalah pada klien inti MQTT 5 yang mungkin tampak offline ketika sejumlah besar (> 50) langganan digunakan. Menambahkan percobaan ulang untuk kegagalan docker dial TCP.
2.11.1	Perbaikan bug dan peningkatan Memperbaiki masalah di mana nukleus tidak dimulai jika tugas bootstrap gagal dan file metadata penerapan rusak. Memperbaiki masalah di mana komponen Lambda sesuai permintaan tidak dilaporkan dalam pembaruan status penerapan. Menambahkan dukungan untuk ID kebijakan otorisasi duplikat.
2.11.0	Fitur baru Memungkinkan Anda membatalkan penerapan lokal. Memungkinkan Anda mengonfigurasi kebijakan penanganan kegagalan untuk penerapan lokal. Menambahkan dukungan untuk plugin spooler disk.
2.10.3	Perbaikan bug dan peningkatan Memperbaiki masalah saat Greengrass tidak berlangganan pemberitahuan penerapan saat menggunakan penyedia PKCS #11.
2.10.2	Perbaikan bug dan peningkatan Memungkinkan penguraian siklus hidup komponen yang tidak peka huruf besar/kecil. Memperbaiki masalah di mana variabel PATH lingkungan tidak dibuat ulang dengan benar. Memperbaiki pengkodean URI proxy untuk komponen termasuk pengelola aliran untuk nama pengguna dengan karakter khusus.
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 di, ini mengembalikan perilaku ke perilaku pra-2.10.0
2.0.0	Fitur baru Menambahkan `interpolateComponentConfiguration` dukungan untuk ekspresi reguler kosong. Greengrass sekarang melakukan interpolasi dari objek konfigurasi root. Menambahkan dukungan untuk MQTT5. Menambahkan mekanisme untuk memuat komponen plugin dengan cepat tanpa pemindaian. Mengaktifkan Greengrass untuk menghemat ruang disk dengan menghapus gambar Docker yang tidak digunakan. Perbaikan bug dan peningkatan Memperbaiki masalah saat rollback meninggalkan nilai konfigurasi tertentu dari penerapan. Memperbaiki masalah di mana inti Greengrass memvalidasi urutan AWS domain di non-kredenSIAL khusus dan titik AWS akhir data. Memperbarui resolusi ketergantungan multi-grup untuk menyelesaikan kembali semua dependensi grup melalui AWS Cloud negosiasi, alih-alih mengunci ke versi aktif. Pembaruan ini juga menghapus kode kesalahan penerapan`INSTALLED_COMPONENT_NOT_FOUND`. Memperbarui inti Greengrass untuk melewatkan pengunduhan gambar Docker ketika sudah ada secara lokal. Memperbarui inti Greengrass untuk memulai ulang langkah pemasangan komponen sebelum batas waktu berakhir. Peningkatan dan perbaikan kecil tambahan.
2.9.6	Perbaikan bug dan peningkatan Memperbaiki masalah ketika penerapan Greengrass gagal dengan kesalahan LAUNCH_DIRECTORY_CORRUPTED dan reboot perangkat berikutnya gagal memulai Greengrass. Kesalahan ini dapat terjadi ketika Anda memindahkan perangkat Greengrass di antara beberapa grup hal dengan penerapan yang mengharuskan 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 ketika penerapan gagal saat wilayah metadata resep lokal tidak cocok dengan wilayah peluncuran inti Greengrass. Inti Greengrass sekarang bernegosiasi ulang dengan awan ketika 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 karakter 1024. Memperbarui skrip bootstrap untuk Windows untuk membaca jalur root Greengrass dengan benar jika jalur itu menyertakan spasi. Memperbarui berlangganan AWS IoT Core sehingga menghapus pesan klien jika respons langganan tidak terkirim. 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 diduplikasi. Menambahkan pembacaan dan penulisan file yang lebih kuat untuk menghindari dan memulihkan dari korupsi. Mencoba lagi penarikan gambar docker pada kesalahan terkait jaringan tertentu. Menambahkan `noProxyAddresses` opsi untuk koneksi MQTT.
2.9.2	Perbaikan bug dan peningkatan Memperbaiki masalah ketika konfigurasi `interpolateComponentConfiguration` tidak berlaku untuk penerapan yang sedang berlangsung. Menggunakan OSHI untuk membuat daftar semua proses anak.
2.9.1	Perbaikan bug dan peningkatan Menambahkan perbaikan di mana Greengrass memulai ulang jika penerapan menghapus komponen plugin.
2.9.0	Fitur baru Menambahkan kemampuan untuk membuat subpenerapan yang mencoba lagi penerapan dengan subset perangkat yang lebih kecil. Fitur ini menciptakan cara yang lebih efisien untuk menguji dan menyelesaikan penerapan yang gagal. Perbaikan bug dan peningkatan Meningkatkan dukungan untuk sistem yang tidak memiliki`useradd`,`groupadd`, dan`usermod`. Peningkatan dan perbaikan kecil tambahan.
2.8.1	Perbaikan bug dan peningkatan Memperbaiki masalah di mana kode kesalahan penerapan tidak dihasilkan dengan benar dari kesalahan Greengrass API. Memperbaiki masalah saat pembaruan status armada mengirim informasi yang tidak akurat saat komponen mencapai `ERRORED` status selama penerapan. Memperbaiki masalah di mana penerapan 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 penerapan yang mencakup kode kesalahan terperinci ketika ada masalah saat menerapkan komponen ke perangkat inti. Untuk informasi selengkapnya, lihat Kode kesalahan penyebaran terperinci. Memperbarui inti Greengrass untuk melaporkan respons status kesehatan komponen yang mencakup kode kesalahan terperinci ketika komponen memasuki `ERRORED` status `BROKEN` atau. Untuk informasi selengkapnya, lihat Kode status komponen terperinci. 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 ketika konfigurasinya berubah. Memperbaiki masalah di mana nukleus restart selama penerapan bootstrap menyebabkan penerapan gagal. Memperbaiki masalah di Windows di mana instalasi gagal ketika jalur root berisi spasi. Memperbaiki masalah ketika komponen dimatikan selama penerapan 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 ke AWS IoT Greengrass cloud saat perangkat inti menerapkan penerapan lokal. Menambahkan dukungan untuk sertifikat klien yang ditandatangani oleh otoritas sertifikat kustom (CA), di mana CA tidak terdaftar AWS IoT. Untuk menggunakan fitur ini, Anda dapat mengatur opsi `greengrassDataPlaneEndpoint` konfigurasi baru ke`iotdata`. Untuk informasi selengkapnya, lihat Menggunakan sertifikat perangkat yang ditandatangani oleh CA pribadi. Perbaikan bug dan peningkatan Memperbaiki masalah di mana inti Greengrass memutar kembali penerapan dalam skenario tertentu ketika nukleus dihentikan atau dimulai ulang. Nukleus sekarang melanjutkan penyebaran setelah nukleus dimulai ulang. Memperbarui penginstal Greengrass untuk menghormati `--start` argumen ketika Anda menentukan untuk mengatur perangkat lunak sebagai layanan sistem. Memperbarui perilaku SubscribeToComponentUpdates untuk menyetel ID penerapan dalam peristiwa di mana nukleus memperbarui komponen. Peningkatan dan perbaikan kecil tambahan.
2.6.0	Fitur baru Menambahkan dukungan untuk wildcard MQTT saat Anda berlangganan topik lokal publish/subscribe . Untuk informasi selengkapnya, lihat Pesan lokal publikasi/berlangganan dan SubscribeToTopic. Menambahkan dukungan untuk variabel resep dalam konfigurasi komponen, selain variabel `component_dependency_name:configuration:json_pointer` resep. Anda dapat menggunakan variabel resep ini ketika Anda menentukan komponen `DefaultConfiguration` dalam resep atau ketika Anda mengonfigurasi komponen dalam penerapan. Untuk mengaktifkan fitur ini, atur opsi ComponentConfiguration konfigurasi interpolasi ke. `true` Untuk informasi selengkapnya, lihat Variabel resep dan Gunakan variabel resep dalam menggabungkan pembaruan. Menambahkan dukungan penuh untuk `` wildcard dalam kebijakan otorisasi komunikasi antar proses (IPC). Anda sekarang dapat menentukan `` karakter dalam string sumber daya untuk mencocokkan kombinasi karakter apa pun. Untuk informasi selengkapnya, lihat Wildcard dalam kebijakan otorisasi. Menambahkan dukungan untuk komponen khusus 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 penerapan dan komponen lokal. Perbaikan bug dan peningkatan Memperbaiki masalah di mana komponen dependen tidak akan bereaksi ketika dependensi keras mereka dimulai ulang atau mengubah status dalam skenario tertentu. Meningkatkan pesan kesalahan yang dilaporkan perangkat inti ke layanan AWS IoT Greengrass cloud saat penerapan gagal. Memperbaiki masalah di mana inti Greengrass menerapkan penyebaran sesuatu dua kali dalam skenario tertentu saat nukleus dimulai ulang. Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat rilis di GitHub.
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 pribadi dan sertifikat perangkat dengan aman. Untuk informasi selengkapnya, lihat Integrasi keamanan perangkat keras. Perbaikan bug dan peningkatan Memperbaiki masalah di mana penerapan tidak pernah selesai saat Anda menerapkan komponen dengan skrip penginstalan yang rusak dalam skenario tertentu. Meningkatkan kinerja selama startup. Peningkatan dan perbaikan kecil tambahan.
2.5.5	Fitur baru Menambahkan variabel `GG_ROOT_CA_PATH` lingkungan untuk komponen, sehingga Anda dapat mengakses sertifikat otoritas sertifikat root (CA) di komponen khusus. Perbaikan bug dan peningkatan Menambahkan dukungan untuk perangkat Windows yang menggunakan bahasa tampilan selain bahasa Inggris. Memperbarui cara inti Greengrass mengurai argumen penginstal Boolean Argumen penginstal, sehingga Anda dapat menentukan argumen Boolean tanpa nilai Boolean untuk menentukan nilai. `true` Misalnya, Anda sekarang dapat menentukan al `--provision` ih-alih `--provision true` menginstal dengan penyediaan sumber daya otomatis. Memperbaiki masalah di mana perangkat inti tidak melaporkan statusnya ke layanan AWS IoT Greengrass cloud setelah penyediaan dalam skenario tertentu. Peningkatan dan perbaikan kecil tambahan.
2.5.4	Perbaikan bug dan peningkatan Perbaikan bug umum dan perbaikan.
2.5.3	Fitur baru Menambahkan dukungan untuk integrasi keamanan perangkat keras. Anda dapat menggunakan modul keamanan perangkat keras (HSM) untuk menyimpan kunci pribadi dan sertifikat perangkat dengan aman. Untuk informasi selengkapnya, lihat Integrasi keamanan perangkat keras. Perbaikan bug dan peningkatan Memperbaiki masalah dengan pengecualian runtime saat nukleus membuat koneksi MQTT dengan AWS IoT Core.
2.5.2	Perbaikan bug dan peningkatan Memperbaiki masalah di mana setelah pembaruan inti Greengrass, layanan Windows gagal memulai lagi setelah Anda menghentikannya atau me-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 perilaku penghapusan grup hal untuk perangkat inti yang AWS IoT kebijakannya tidak memberikan `greengrass:ListThingGroupsForCoreDevice` izin. Dengan versi ini, penerapan berlanjut, mencatat peringatan, dan tidak menghapus komponen saat Anda menghapus perangkat inti dari grup benda. Untuk informasi selengkapnya, lihat Menyebarkan AWS IoT Greengrass komponen ke perangkat. Memperbaiki masalah dengan variabel lingkungan sistem yang disediakan oleh inti Greengrass untuk proses komponen Greengrass. Anda sekarang dapat me-restart komponen untuk menggunakan variabel lingkungan sistem terbaru.
2.5.0	Fitur baru Menambahkan dukungan untuk perangkat inti yang menjalankan Windows. Ubah perilaku penghapusan kelompok benda. Dengan versi ini, Anda dapat menghapus perangkat inti dari grup benda untuk menghapus komponen grup benda itu di penerapan berikutnya. Sebagai hasil dari perubahan ini, AWS IoT kebijakan perangkat inti harus memiliki `greengrass:ListThingGroupsForCoreDevice` izin. Jika Anda menggunakan peng AWS IoT Greengrass instal perangkat lunak inti untuk menyediakan sumber daya, AWS IoT kebijakan default memungkinkan`greengrass:*`, yang mencakup izin ini. Untuk informasi selengkapnya, lihat Otentikasi 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 parameter `windowsUser` 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 Konfigurasikan pengguna yang menjalankan komponen. Menambahkan opsi `httpClient` konfigurasi baru yang dapat Anda gunakan untuk menyesuaikan batas waktu 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 dari `DEBUG` level `INFO` ke level, sehingga log lebih berguna. Menghapus `iot:DescribeCertificate` izin dari peran pertukaran token default yang dibuat oleh inti Greengrass saat Anda menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan otomatis. Izin ini tidak digunakan oleh inti Greengrass. Memperbaiki masalah sehingga skrip penyediaan otomatis tidak memerlukan `iam:GetPolicy` izin jika `iam:CreatePolicy` tersedia untuk kebijakan yang sama. Peningkatan dan perbaikan kecil tambahan.
2.4.0	Fitur baru Menambahkan dukungan untuk batas sumber daya sistem. Anda dapat mengonfigurasi jumlah maksimum penggunaan CPU dan RAM yang dapat digunakan setiap proses komponen pada perangkat inti. Untuk informasi selengkapnya, lihat Konfigurasikan batas sumber daya sistem untuk komponen. Menambahkan operasi IPC untuk menjeda dan melanjutkan komponen. Untuk informasi selengkapnya, lihat PauseComponent dan ResumeComponent. Menambahkan dukungan untuk penyediaan plugin. Anda dapat menentukan file JAR untuk dijalankan selama instalasi untuk menyediakan sumber AWS daya yang diperlukan untuk perangkat inti Greengrass. Inti Greengrass menyertakan antarmuka yang dapat Anda terapkan untuk mengembangkan plugin penyediaan khusus. Untuk informasi selengkapnya, lihat Menginstal AWS IoT Greengrass Perangkat lunak inti dengan penyediaan sumber daya khusus. Menambahkan `thing-name-policy` argumen opsional ke peng AWS IoT Greengrass instal perangkat lunak inti. Anda dapat menggunakan opsi ini untuk menentukan kebijakan yang ada atau AWS IoT kebijakan kustom saat Anda menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya otomatis. Perbaikan bug dan peningkatan Memperbarui konfigurasi logging saat startup. Ini memperbaiki masalah di mana konfigurasi logging tidak diterapkan saat startup. Memperbarui symlink pemuat inti untuk menunjuk ke penyimpanan komponen di folder root Greengrass selama instalasi. Pembaruan ini memungkinkan Anda untuk menghapus file JAR dan artefak inti lainnya yang Anda unduh saat menginstal perangkat lunak AWS IoT Greengrass Core. Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat rilis di GitHub.
2.3.0	Fitur baru Menambahkan dukungan untuk dokumen konfigurasi deployment hingga 10 MB, naik dari 7 KB (untuk deployment yang menargetkan objek) atau 31 KB (untuk deployment yang menargetkan objek grup). Untuk menggunakan fitur ini, AWS IoT kebijakan perangkat inti harus mengizinkan `greengrass:GetDeploymentConfiguration` izin tersebut. Jika Anda menggunakan peng AWS IoT Greengrass instal perangkat lunak Core untuk menyediakan sumber daya, AWS IoT kebijakan perangkat inti Anda memungkinkan`greengrass:*`, yang mencakup izin ini. Untuk informasi selengkapnya, lihat Otentikasi dan otorisasi perangkat untuk AWS IoT Greengrass. Menambahkan variabel resep `iot:thingName`. Anda dapat menggunakan variabel resep ini untuk mendapatkan nama perangkat AWS IoT inti dalam resep. Untuk informasi selengkapnya, lihat Variabel resep. Perbaikan bug dan peningkatan Peningkatan dan perbaikan kecil tambahan. Untuk informasi lebih lanjut, lihat rilis di GitHub.
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 rilis di GitHub.
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 rilis di GitHub. 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 rilis di GitHub.
2.0.5	Perbaikan bug dan peningkatan Merutekan lalu lintas dengan benar melalui proxy jaringan yang dikonfigurasi saat mengunduh AWS komponen yang disediakan. 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 pembuatan kebijakan peran pertukaran token AWS Identity and Access Management (IAM) 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 rilis di GitHub.
2.0.3	Versi awal.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Komponen yang disediakan oleh AWS

Greengrass nucleus lite