Inti Greengrass - AWS IoT Greengrass
VersiPersyaratan perangkatPlatform yang didukungSistem operasiPersyaratanDependensiDownload dan InstalasiKonfigurasiFile log lokalChangelog

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

Inti Greengrass

Komponen inti Greengrass aws.greengrass.Nucleus () adalah komponen wajib dan persyaratan minimum untuk menjalankan perangkat lunak Core AWS IoT Greengrass 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

Mulai Greengrass versi 2.14.0, versi runtime perangkat nukleus yang dioptimalkan jejak memori tersedia untuk perangkat edge yang dibatasi. Lihat Greengrass nucleus lite untuk informasi lebih lanjut tentang konfigurasi dan penggunaannya.

penting

Saat versi komponen nukleus berubah, atau saat Anda mengubah parameter konfigurasi tertentu, perangkat lunak AWS IoT Greengrass Inti—yang menyertakan inti dan semua komponen lain di perangkat Anda—akan dimulai ulang untuk menerapkan perubahan.

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 AWS yang disediakan mungkin secara otomatis diterapkan ke perangkat inti Anda jika Anda menambahkan perangkat baru ke grup sesuatu, 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 perangkat lunak AWS IoT Greengrass Core (OTA).

Versi

Komponen ini memiliki versi berikut:

  • 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 menggunakannya AWS IoT Device Tester AWS IoT Greengrass untuk memverifikasi bahwa perangkat Anda dapat menjalankan perangkat lunak AWS IoT Greengrass Core dan berkomunikasi dengan perangkat lunak AWS Cloud. Untuk informasi selengkapnya, lihat Menggunakan AWS IoT Device Tester untuk AWS IoT Greengrass V2.

Linux

  • Penggunaan sebuah Wilayah AWSyang 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 minimal 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 kustom, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang Amazon Corretto atau OpenJDK. Versi 8 atau lebih tinggi diperlukan.

  • Pustaka GNU C (glibc) versi 2.25 atau lebih besar.

  • Anda harus menjalankan perangkat lunak AWS IoT Greengrass Core sebagai pengguna root. Gunakan sudo, misalnya.

  • Pengguna root yang menjalankan perangkat lunak AWS IoT Greengrass Core, sepertiroot, harus memiliki izin untuk menjalankan 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.

Windows

  • Penggunaan sebuah Wilayah AWSyang 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 minimal 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 kustom, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang Amazon Corretto atau OpenJDK. Versi 8 atau lebih tinggi diperlukan..

    catatan

    Untuk menggunakan versi 2.5.0 dari inti Greengrass, Anda harus menggunakan Java Runtime Environment (JRE) versi 64-bit. Greengrass nucleus versi 2.5.1 mendukung 32-bit dan 64-bit. JREs

  • 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 dan kata sandi pengguna harus ada di instance Credential Manager untuk LocalSystem akun tersebut. Anda dapat mengatur pengguna ini ketika Anda mengikuti petunjuk 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.

Linux

Arsitektur:

  • Armv7l

  • Armv8 () AArch64

  • x86_64

Windows

Arsitektur:

  • x86_64

Versi:

  • Windows 10

  • Windows 11

  • Windows Server 2019

  • Windows Server 2022

catatan

Beberapa AWS IoT Greengrass fitur saat ini tidak didukung pada perangkat Windows. Untuk informasi selengkapnya, lihat Kompatibilitas fitur Greengrass dan Pertimbangan fitur.

Pertimbangan fitur

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

Untuk membangun sistem operasi berbasis Linux kustom, Anda dapat menggunakan BitBake resep untuk AWS IoT Greengrass dalam proyek. meta-aws meta-awsProyek ini menyediakan resep yang dapat Anda gunakan untuk membangun kemampuan perangkat lunak AWS edge dalam sistem Linux tertanam yang dibangun dengan OpenEmbeddeddan kerangka kerja Yocto Project build. Proyek Yocto adalah proyek kolaborasi open source yang membantu Anda membangun sistem berbasis Linux 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 Core. AWS IoT Greengrass 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 AWS IoT data ke, AWS IoT Credentials, 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.

Download 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 di mana 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 untuk diterapkan. Untuk informasi selengkapnya tentang mengapa dan bagaimana komponen ini, lihat Konfigurasikan perangkat lunak AWS IoT Greengrass Inti.

iotRoleAlias

Alias AWS IoT peran yang menunjuk ke peran IAM pertukaran token. Penyedia AWS IoT kredensyal mengasumsikan peran ini untuk memungkinkan perangkat inti Greengrass berinteraksi dengan layanan. AWS Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

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 dimulai 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 dan. username password

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

password

(Opsional) Kata sandi yang mengautentikasi 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 dimulai 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 MQTT PING atau pesan 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

spooler

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

storageType

Jenis penyimpanan untuk menyimpan pesan. Jika storageType diatur 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 storageType disetel ke Disk dan Anda ingin menurunkan versi inti Greengrass dari versi 2.11.x ke versi sebelumnya, Anda harus mengubah konfigurasi kembali ke. Memory Satu-satunya konfigurasi untuk storageType itu didukung di Greengrass nucleus versi 2.10.x dan sebelumnya adalah. Memory Tidak mengikuti panduan ini dapat mengakibatkan spooler rusak. 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 diatur keDisk. Opsi ini default ke aws.greengrass.DiskSpooler dan akan menggunakan GreenGrass yang disediakan. 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 oleh broker.

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

Default: 100

sessionExpirySeconds

(Opsional) Jumlah waktu dalam hitungan 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) Opsi untuk perilaku rekoneksi. Jumlah minimum waktu dalam hitungan 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) Opsi untuk perilaku rekoneksi. Jumlah maksimum waktu dalam hitungan 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) Opsi untuk perilaku rekoneksi. Jumlah waktu dalam hitungan detik koneksi harus aktif sebelum penundaan coba lagi diatur 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 yang akan digunakan untuk menjalankan perangkat lunak AWS IoT Greengrass Core. Untuk informasi tentang opsi JVM yang direkomendasikan untuk menjalankan perangkat lunak AWS IoT Greengrass Core, lihat. Kontrol alokasi memori dengan opsi JVM

penting

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

iotDataEndpoint

Titik akhir AWS IoT data untuk Anda Akun AWS.

Ketika 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 mengaturnya dalam komponen nukleus.

iotCredEndpoint

Titik akhir AWS IoT kredensial untuk Anda. Akun AWS

Ketika 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 mengaturnya dalam komponen nukleus.

greengrassDataPlaneEndpoint

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

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

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

Saat Anda menjalankan penginstal perangkat lunak AWS IoT Greengrass Core 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 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 Credentials Manager LocalSystem akun. Untuk informasi selengkapnya, lihat Konfigurasikan pengguna yang menjalankan komponen.

Saat Anda menjalankan penginstal perangkat lunak AWS IoT Greengrass Core 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 di 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 Konfigurasikan batas sumber daya sistem untuk komponen.

Objek ini berisi informasi berikut:

cpus

Jumlah maksimum waktu CPU yang dapat digunakan oleh setiap proses komponen pada perangkat inti. Total waktu CPU perangkat inti setara dengan jumlah inti CPU perangkat. Misalnya, pada perangkat inti dengan 4 core CPU, Anda dapat mengatur nilai ini 2 untuk membatasi proses setiap komponen hingga 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini 0.25 untuk membatasi proses setiap 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 oleh setiap proses komponen pada perangkat inti.

s3EndpointType

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

  • REGIONAL— Klien S3 dan URL presigned menggunakan endpoint regional.

  • GLOBAL— Klien S3 dan URL presigned menggunakan endpoint lama.

  • DUALSTACK— URL presigned S3 menggunakan endpoint 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.

  • falseKetika false, titik akhir tidak akan menggunakan titik akhir FIPS.

Default: false

logging

(Opsional) Konfigurasi pencatatan untuk perangkat inti. Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan log Greengrass, lihat. Memantau 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 CLI Greengrass 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 tentukan. outputDirectory

  • 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 Greengrass nucleus 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 disk komponen pengelola log (diskSpaceLimit), yang dapat Anda tentukan untuk inti Greengrass (sistem) dan setiap komponen. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum 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 mana /greengrass/v2 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.

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

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 waktu tunggu ini untuk mencegah permintaan HTTP dari waktu habis.

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)

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

Perbaikan bug dan peningkatan

  • Memungkinkan layanan pertukaran token untuk memulai ulang pada perubahan konfigurasi port.

  • Memperbaiki masalah saat layanan status armada tidak mengirim pesan perubahan status komponen untuk lambda yang tidak disematkan jika tidak dipicu.

  • Memperbaiki masalah saat komponen tidak dimatikan dengan baik 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 timbal balik.

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

Fitur baru

  • Dukungan endpoint dual-stack baru memungkinkan IPv6 komunikasi jaringan.

  • Peningkatan ketahanan terhadap kegagalan restart nukleus dan korupsi Launch direktori.

Perbaikan bug dan peningkatan

  • Memperbaiki kebocoran memori dalam penutupan langganan IPC PubSub .

  • Perbaikan menjalankan siklus hidup komponen di mana ia masuk ke status ERRORED karena batas waktu startup ketika kondisi skipif benar.

  • Memperbaiki masalah saat perangkat inti gagal tersambung AWS IoT Core saat kebijakan TLS disetel ke _1_3_2022_10. TLS13

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 sedang digabungkan dan sambil menunggu layanan dimulai.

2.12.6
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang menyebabkan crash saat startup pada ARMv8 prosesor tertentu, termasuk Jetson Nano.

2.12.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 di mana nukleus tidak mempublikasikan pembaruan status setelah penyediaan armada.

  • Menambahkan percobaan ulang untuk GetDeploymentConfiguration API setelah mendapatkan 404 kesalahan.

2.12.4
Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat nukleus memasuki kondisi kebuntuan selama startup di beberapa perangkat Linux.

2.12.3
Awas

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

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 ia mungkin memulai komponen dengan tidak benar ketika dependensinya gagal.

Fitur baru

  • Menambahkan tipe endpoint s3 yang dapat dikonfigurasi.

2.11.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah di klien nukleus MQTT 5 yang mungkin muncul offline saat sejumlah besar (> 50) langganan sedang digunakan.

  • Menambahkan percobaan lagi untuk kegagalan TCP docker dial.

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 saat komponen Lambda sesuai permintaan tidak dilaporkan dalam pembaruan status penerapan.

  • Menambahkan dukungan untuk kebijakan otorisasi duplikat. IDs

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 notifikasi 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 manajer aliran untuk nama pengguna dengan karakter khusus.

2.10.1
Perbaikan bug dan peningkatan

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

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

2.10.0
Fitur baru

  • Menambahkan interpolateComponentConfiguration dukungan untuk ekspresi reguler kosong. Greengrass sekarang diinterpolasi dari objek konfigurasi root.

  • Menambahkan dukungan untuk MQTT5.

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

  • 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 domain dalam non-kredensi kustom AWS dan titik akhir data.AWS

  • 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 INSTALLED_COMPONENT_NOT_FOUND kesalahan penerapan.

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

  • Memperbarui inti 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 saat penerapan 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 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 saat 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.

  • Pembaruan berlangganan AWS IoT Core sehingga menghapus pesan klien jika respons langganan tidak dikirim.

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

2.9.3
Perbaikan bug dan peningkatan

  • Memastikan klien MQTT IDs tidak diduplikasi.

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

  • Mencoba ulang gambar docker menarik kesalahan terkait jaringan tertentu.

  • Menambahkan noProxyAddresses opsi untuk koneksi MQTT.

2.9.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat 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 dimulai ulang jika penerapan 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 gagal.

Perbaikan bug dan peningkatan

  • Meningkatkan dukungan untuk sistem yang tidak memiliki useraddgroupadd,, dan usermod

  • Peningkatan dan perbaikan kecil tambahan.

2.8.1
Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat kode kesalahan penerapan tidak dihasilkan dengan benar dari kesalahan Greengrass API.

  • Memperbaiki masalah saat pembaruan status armada mengirimkan 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 dalam 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 saat komponen memasuki status atau. BROKEN ERRORED 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 saat nukleus dimulai ulang selama penerapan bootstrap menyebabkan penerapan gagal.

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

  • Memperbaiki masalah saat komponen dimatikan selama penerapan menggunakan skrip shutdown versi baru.

  • Berbagai peningkatan shutdown.

  • Peningkatan dan perbaikan kecil tambahan.

2.7.0
Fitur baru

  • Memperbarui inti Greengrass untuk mengirim pembaruan status ke cloud saat perangkat AWS IoT Greengrass inti menerapkan penerapan lokal.

  • Menambahkan dukungan untuk sertifikat klien yang ditandatangani oleh otoritas sertifikat khusus (CA), di mana CA tidak terdaftar AWS IoT. Untuk menggunakan fitur ini, Anda dapat mengatur opsi greengrassDataPlaneEndpoint konfigurasi baru keiotdata. 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 saat nukleus dihentikan atau dimulai ulang. Nukleus sekarang melanjutkan penyebaran setelah nukleus dimulai kembali.

  • Memperbarui penginstal Greengrass untuk menghormati --start argumen saat 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 penerbitan/berlangganan lokal. 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 saat menentukan komponen DefaultConfiguration dalam resep atau saat Anda mengonfigurasi komponen dalam penerapan. Untuk mengaktifkan fitur ini, atur opsi interpolateComponentConfigurationkonfigurasi ketrue. Untuk informasi selengkapnya, lihat Variabel resep dan Gunakan variabel resep dalam menggabungkan pembaruan.

  • Menambahkan dukungan penuh untuk kebijakan * otorisasi wildcard in interprocess communication (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 CLI Greengrass. 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 kerasnya memulai 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 penerapan 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 root certificate authority (CA) di komponen kustom.

Perbaikan bug dan peningkatan

  • Menambahkan dukungan untuk perangkat Windows yang menggunakan bahasa tampilan selain bahasa Inggris.

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

  • Memperbaiki masalah saat 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 yang lebih baru dari komponen ini.

Perbaikan bug dan peningkatan

  • Menambahkan dukungan untuk versi 32-bit dari Java Runtime Environment (JRE) pada Windows.

  • Mengubah perilaku penghapusan grup 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 sesuatu. 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 grup 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 penginstal perangkat lunak AWS IoT Greengrass inti untuk menyediakan sumber daya, AWS IoT kebijakan default mengizinkangreengrass:*, yang menyertakan 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 tingkat INFO ke tingkat, sehingga log lebih berguna.

  • Menghapus iot:DescribeCertificate izin dari peran pertukaran token default yang dibuat oleh inti Greengrass saat Anda menginstal AWS IoT Greengrass perangkat lunak Core dengan penyediaan otomatis. Izin ini tidak digunakan oleh inti Greengrass.

  • Memperbaiki masalah sehingga skrip penyediaan otomatis tidak memerlukan iam:GetPolicy izin jika tersedia untuk kebijakan iam:CreatePolicy yang sama.

  • Peningkatan dan perbaikan kecil tambahan.

2.4.0
Fitur baru
Perbaikan bug dan peningkatan

  • Memperbarui konfigurasi logging saat startup. Ini memperbaiki masalah di mana konfigurasi logging tidak diterapkan saat startup.

  • Memperbarui symlink pemuat nukleus untuk menunjuk ke penyimpanan komponen di folder root Greengrass selama penginstalan. Pembaruan ini memungkinkan Anda untuk menghapus file JAR dan artefak inti lainnya yang Anda unduh saat Anda 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 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

  • Rutekan lalu lintas dengan benar melalui proxy jaringan yang dikonfigurasi saat mengunduh komponen AWS 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.