Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Siapkan perangkat inti V2 baru untuk menguji aplikasi V1
Siapkan perangkat AWS IoT Greengrass V2 inti baru untuk menyebarkan dan menguji komponen dan AWS Lambda fungsi AWS yang disediakan untuk aplikasi Anda AWS IoT Greengrass V1 . Anda juga dapat menggunakan perangkat inti V2 ini untuk mengembangkan dan menguji komponen Greengrass kustom tambahan yang menjalankan proses asli pada perangkat inti. Setelah menguji aplikasi pada perangkat inti V2, Anda dapat meningkatkan perangkat inti V1 yang ada ke V2 dan menerapkan komponen V2 yang menyediakan fungsionalitas V1 Anda.
Langkah 1: Instal AWS IoT Greengrass V2 di perangkat baru
Instal perangkat lunak AWS IoT Greengrass Core v2.x pada perangkat baru. Anda dapat mengikuti tutorial memulai untuk menyiapkan perangkat dan mempelajari cara mengembangkan dan menyebarkan komponen. Tutorial ini menggunakan penyediaan otomatis untuk mengatur perangkat dengan cepat. Saat Anda menginstal perangkat lunak AWS IoT Greengrass Core v2.x, tentukan --deploy-dev-tools argumen untuk menerapkan CLI Greengrass, sehingga Anda dapat mengembangkan, menguji, dan men-debug komponen langsung di perangkat. Untuk informasi selengkapnya tentang opsi penginstalan lainnya, termasuk cara menginstal perangkat lunak AWS IoT Greengrass inti di belakang proxy atau menggunakan modul keamanan perangkat keras (HSM), lihatInstal perangkat lunak inti AWS IoT Greengrass.
(Opsional) Aktifkan logging ke Amazon CloudWatch Logs
Untuk mengaktifkan perangkat inti V2 mengunggah log ke Amazon CloudWatch Logs, Anda dapat menerapkan komponen pengelola log AWS yang disediakan. Anda dapat menggunakan CloudWatch Log untuk melihat log komponen, sehingga Anda dapat men-debug dan memecahkan masalah tanpa akses ke sistem file perangkat inti. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.
Langkah 2: Membuat dan menyebarkan AWS IoT Greengrass V2 komponen untuk memigrasi aplikasi AWS IoT Greengrass V1
Anda dapat menjalankan sebagian besar AWS IoT Greengrass V1 aplikasi di AWS IoT Greengrass V2. Anda dapat mengimpor fungsi Lambda sebagai komponen yang berjalan AWS IoT Greengrass V2, dan Anda dapat menggunakan komponen yang AWS disediakan yang menawarkan fungsionalitas yang sama dengan konektor. AWS IoT Greengrass
Anda juga dapat mengembangkan komponen khusus untuk membangun fitur atau runtime apa pun untuk dijalankan di perangkat inti Greengrass. Untuk informasi tentang cara mengembangkan dan menguji komponen secara lokal, lihatBuat AWS IoT Greengrass komponen.
Topik
Impor fungsi Lambda V1
Anda dapat mengimpor fungsi Lambda sebagai AWS IoT Greengrass V2 komponen. Pilih dari pendekatan berikut:
-
Impor V1 Lambda berfungsi langsung sebagai komponen Greengrass.
-
Perbarui fungsi Lambda Anda untuk menggunakan pustaka Greengrass di v2 AWS IoT Device SDK , lalu impor fungsi Lambda sebagai komponen Greengrass.
-
Buat komponen khusus yang menggunakan kode non-Lambda dan AWS IoT Device SDK v2 untuk mengimplementasikan fungsionalitas yang sama dengan fungsi Lambda Anda.
Jika fungsi Lambda Anda menggunakan fitur, seperti pengelola aliran atau rahasia lokal, Anda harus menentukan dependensi pada komponen yang AWS disediakan yang mengemas fitur ini. Ketika Anda menggunakan komponen fungsi Lambda, deployment tersebut juga mencakup komponen untuk setiap fitur yang Anda tetapkan sebagai dependensi. Dalam penerapan, Anda dapat mengonfigurasi parameter, seperti rahasia mana yang akan diterapkan ke perangkat inti. Tidak semua fitur V1 memerlukan dependensi komponen untuk fungsi Lambda Anda pada V2. Daftar berikut menjelaskan cara menggunakan fitur V1 di komponen fungsi Lambda V2 Anda.
-
Akses AWS layanan lain
Jika fungsi Lambda Anda menggunakan AWS kredensional untuk membuat permintaan ke AWS layanan lain, peran pertukaran token perangkat inti harus mengizinkan perangkat inti untuk melakukan operasi AWS yang digunakan fungsi Lambda. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.
-
Manajer aliran
Jika fungsi Lambda Anda menggunakan stream manager, tentukan
aws.greengrass.StreamManagersebagai dependensi komponen ketika Anda mengimpor fungsi tersebut. Saat Anda menggunakan komponen stream manager, tentukan parameter stream manager yang akan ditetapkan untuk perangkat inti target. Peran pertukaran token perangkat inti harus memungkinkan perangkat inti mengakses AWS Cloud tujuan yang Anda gunakan dengan pengelola aliran. Untuk informasi selengkapnya, lihat Manajer pengaliran. -
Rahasia lokal
Jika fungsi Lambda Anda menggunakan rahasia lokal, tentukan
aws.greengrass.SecretManagersebagai dependensi komponen ketika Anda mengimpor fungsi tersebut. Ketika Anda men-deploy komponen secret manager, tentukan sumber daya rahasia yang akan di-deploy ke perangkat inti target. Peran pertukaran token perangkat inti harus memungkinkan perangkat inti untuk mengambil sumber daya rahasia untuk digunakan. Untuk informasi selengkapnya, lihat Secrets manager.Saat Anda menerapkan komponen fungsi Lambda Anda, konfigurasikan agar memiliki kebijakan otorisasi IPC yang memberikan izin untuk menggunakan operasi IPC GetSecretValue di V2. AWS IoT Device SDK
-
Bayangan lokal
Jika fungsi Lambda Anda berinteraksi dengan bayangan lokal, Anda harus memperbarui kode fungsi Lambda untuk menggunakan V2. AWS IoT Device SDK Anda juga harus menentukan
aws.greengrass.ShadowManagersebagai dependensi komponen ketika Anda mengimpor fungsi tersebut. Untuk informasi selengkapnya, lihat Berinteraksilah dengan bayangan perangkat.Saat Anda menerapkan komponen fungsi Lambda Anda, konfigurasikan agar memiliki kebijakan otorisasi IPC yang memberikan izin untuk menggunakan operasi IPC bayangan di V2. AWS IoT Device SDK
-
Langganan
-
Jika fungsi Lambda Anda berlangganan pesan dari sumber cloud, tentukan langganan tersebut sebagai sumber peristiwa saat Anda mengimpor fungsi tersebut.
-
Jika fungsi Lambda Anda berlangganan pesan dari fungsi Lambda lain, atau jika fungsi Lambda Anda menerbitkan pesan ke atau fungsi Lambda AWS IoT Core lainnya, konfigurasikan dan terapkan komponen router langganan lama saat Anda menerapkan fungsi Lambda Anda. Saat Anda men-deploy komponen router langganan warisan, tentukan langganan yang digunakan oleh fungsi Lambda tersebut.
catatan
Komponen router langganan lama hanya diperlukan jika fungsi Lambda Anda menggunakan fungsi
publish()di Core AWS IoT Greengrass SDK. Jika Anda memperbarui kode fungsi Lambda Anda untuk menggunakan antarmuka komunikasi antarproses (IPC) di AWS IoT Device SDK V2, Anda tidak perlu menggunakan komponen router langganan lama. Untuk informasi lebih lanjut, lihat layanan komunikasi antar proses berikut ini: -
Jika fungsi Lambda Anda berlangganan pesan dari perangkat lokal yang terhubung, tentukan langganan tersebut sebagai sumber peristiwa saat Anda mengimpor fungsi tersebut. Anda juga harus mengonfigurasi dan menerapkan komponen jembatan MQTT untuk menyampaikan pesan dari perangkat yang terhubung ke topik penerbitan/langganan lokal yang Anda tentukan sebagai sumber peristiwa.
-
Jika fungsi Lambda Anda menerbitkan pesan ke perangkat lokal yang terhubung, Anda harus memperbarui kode fungsi Lambda untuk menggunakan AWS IoT Device SDK V2 untuk mempublikasikan pesan penerbitan/berlangganan lokal. Anda juga harus mengonfigurasi dan menerapkan komponen jembatan MQTT untuk menyampaikan pesan dari broker pesan penerbitan/berlangganan lokal ke perangkat yang terhubung.
-
-
Volume dan perangkat lokal
Jika fungsi Lambda terkontainerisasi Anda mengakses volume atau perangkat lokal, tentukan volume dan perangkat tersebut saat Anda mengimpor fungsi Lambda. Fitur ini tidak memerlukan dependensi komponen.
Untuk informasi selengkapnya, lihat Jalankan fungsi AWS Lambda.
Gunakan konektor V1
Anda dapat menerapkan komponen yang AWS disediakan yang menawarkan fungsionalitas yang sama dari beberapa AWS IoT Greengrass konektor. Bila Anda membuat deployment, Anda dapat mengonfigurasi parameter konektor.
AWS IoT Greengrass V2 Komponen-komponen berikut menyediakan fungsionalitas konektor Greengrass V1:
Jalankan kontainer Docker
AWS IoT Greengrass V2 tidak menyediakan komponen untuk secara langsung mengganti konektor penerapan aplikasi V1 Docker. Namun, Anda dapat menggunakan komponen pengelola aplikasi Docker untuk mengunduh gambar Docker, dan kemudian membuat komponen khusus yang menjalankan kontainer Docker dari gambar yang diunduh. Lihat informasi yang lebih lengkap di Jalankan kontainer Docker dan Manajer aplikasi Docker.
Jalankan inferensi machine learning
AWS IoT Greengrass V2 menyediakan komponen Amazon SageMaker Edge Manager yang menginstal agen Amazon SageMaker Edge Manager dan memungkinkan Anda menggunakan model yang SageMaker dikompilasi NEO sebagai komponen model pada perangkat inti Greengrass. AWS IoT Greengrass V2 juga menyediakan komponen yang menginstal Deep Learning Runtime
Hubungkan perangkat Greengrass V1
Perangkat yang AWS IoT Greengrass V1 terhubung di disebut perangkat klien di AWS IoT Greengrass V2. AWS IoT Greengrass V2 dukungan untuk perangkat klien kompatibel ke belakang AWS IoT Greengrass V1, sehingga Anda dapat menghubungkan perangkat klien V1 ke perangkat inti V2 tanpa mengubah kode aplikasinya. Untuk mengaktifkan perangkat klien terhubung ke perangkat inti V2, gunakan komponen Greengrass yang memungkinkan dukungan perangkat klien, dan kaitkan perangkat klien ke perangkat inti. Untuk merelai pesan antara perangkat klien, layanan cloud AWS IoT Core , dan komponen Greengrass (termasuk fungsi Lambda), deploy dan konfigurasikan Komponen jembatan MQTT. Anda dapat men-deploy komponen detektor IP untuk secara otomatis mendeteksi informasi konektivitas, atau Anda dapat mengelola titik akhir secara manual. Untuk informasi selengkapnya, lihat Berinteraksilah dengan perangkat IoT lokal.
Aktifkan layanan bayangan lokal
Di AWS IoT Greengrass V2, layanan bayangan lokal diimplementasikan oleh komponen manajer bayangan AWS yang disediakan. AWS IoT Greengrass V2 juga termasuk dukungan untuk bayangan bernama. Untuk mengaktifkan komponen Anda berinteraksi dengan bayangan lokal dan menyinkronkan status bayangan AWS IoT Core, konfigurasikan dan terapkan komponen pengelola bayangan, dan gunakan operasi IPC bayangan dalam kode komponen Anda. Untuk informasi selengkapnya, lihat Berinteraksilah dengan bayangan perangkat.
Integrasikan dengan AWS IoT SiteWise
Jika Anda menggunakan perangkat inti V1 sebagai AWS IoT SiteWise gateway, ikuti petunjuk untuk menyiapkan perangkat inti V2 baru Anda sebagai AWS IoT SiteWise gateway. AWS IoT SiteWise menyediakan skrip instalasi yang menyebarkan AWS IoT SiteWise komponen untuk Anda.
Langkah 3: Uji AWS IoT Greengrass V2 aplikasi Anda
Setelah Anda membuat dan menerapkan komponen V2 ke perangkat inti V2 baru Anda, verifikasi bahwa aplikasi Anda memenuhi harapan Anda. Anda dapat memeriksa log perangkat untuk melihat pesan keluaran standar (stdout) dan kesalahan standar (stderr) komponen Anda. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.
Jika Anda menerapkan CLI Greengrass ke perangkat inti, Anda dapat menggunakannya untuk men-debug komponen dan konfigurasinya. Untuk informasi selengkapnya, lihat Perintah Greengrass CLI.
Setelah Anda memverifikasi bahwa aplikasi Anda bekerja pada perangkat inti V2, Anda dapat menerapkan komponen Greengrass aplikasi Anda ke perangkat inti lainnya. Jika Anda mengembangkan komponen kustom yang menjalankan proses asli atau kontainer Docker, Anda harus terlebih dahulu mempublikasikan komponen tersebut ke AWS IoT Greengrass layanan untuk menerapkannya ke perangkat inti lainnya.
