AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Jalankan fungsi Lambda pada AWS IoT Greengrass core

AWS IoT Greengrass menyediakan lingkungan waktu aktif Lambda terkontainerisasi untuk kode yang ditetapkan pengguna yang Anda tulis di AWS Lambda. Fungsi Lambda yang di-deploy ke AWS IoT Greengrass core berjalan di waktu aktif Lambda lokal Core. Fungsi Lambda lokal dapat dipicu oleh peristiwa lokal, pesan dari cloud, dan sumber lain, yang membawa fungsionalitas komputasi lokal ke perangkat klien. Sebagai contoh, Anda dapat menggunakan fungsi Greengrass Lambda untuk memfilter data perangkat sebelum mengirimkan data ke cloud.

Untuk men-deploy fungsi Lambda ke core, Anda menambahkan fungsi ke grup Greengrass (dengan referensi fungsi Lambda yang ada), mengonfigurasi pengaturan khusus grup untuk fungsi, dan kemudian men-deploy grup. Jika fungsi mengakses AWS layanan, Anda juga harus menambahkan izin yang diperlukan untuk peran grup Greengrass.

Anda dapat mengonfigurasi parameter yang menentukan bagaimana fungsi Lambda berjalan, termasuk izin, isolasi, batas memori, dan banyak lagi. Untuk informasi selengkapnya, lihat Mengontrol eksekusi fungsi Greengrass Lambda dengan menggunakan konfigurasi grup khusus.

Tabel berikut mencantumkan data yang didukung AWS Lambda waktu aktif dan versi AWS IoT Greengrass perangkat lunak Core yang dapat mereka jalankan.

* Anda dapat menjalankan fungsi Lambda yang menggunakan waktu aktif ini pada versi yang didukung dari AWS IoT Greengrass, tetapi Anda tidak dapat membuatnya di AWS Lambda. Jika runtime pada perangkat Anda berbeda dari runtime AWS Lambda yang ditentukan untuk fungsi tersebut, Anda dapat memilih runtime sendiri dengan menggunakan in. FunctionRuntimeOverride FunctionDefintionVersion Untuk informasi lebih lanjut, lihat CreateFunctionDefinition. Untuk informasi selengkapnya tentang runtime yang didukung, lihat Kebijakan dukungan Runtime di Panduan AWS LambdaPengembang.

SDK untuk fungsi Greengrass Lambda

AWS menyediakan tiga SDK yang dapat digunakan oleh fungsi Greengrass Lambda yang berjalan pada AWS IoT Greengrass core. SDK ini terkandung dalam paket yang berbeda, sehingga fungsi dapat menggunakannya secara bersamaan. Untuk menggunakan SDK dalam fungsi Greengrass Lambda, memasukkannya ke dalam paket deployment fungsi Lambda yang Anda upload ke AWS Lambda.

Untuk informasi lebih lanjut tentang cara membuat paket deployment, lihat Buat dan paketkan fungsi Lambda dalam tutorial Memulai atau Membuat paket deployment dalam AWS Lambda Panduan Developer.

Memigrasi fungsi Lambda berbasis cloud

SDK Core AWS IoT Greengrass mengikuti model pemrograman AWS SDK, yang membuatnya mudah untuk port fungsi Lambda yang dikembangkan untuk cloud pada fungsi Lambda yang berjalan dengan AWS IoT Greengrass core.

Sebagai contoh, fungsi Python Lambda berikut menggunakan AWS SDK for Python (Boto3) untuk mempublikasikan pesan ke topik some/topic di cloud:

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

Untuk port fungsi pada AWS IoT Greengrass core, di pernyataan import dan client inisialisasi, mengubah nama modul boto3 ke greengrasssdk, seperti yang ditunjukkan dalam contoh berikut:

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

Kesamaan antara model pemrograman juga memungkinkan Anda untuk mengembangkan fungsi Lambda Anda di cloud dan kemudian memigrasikannya ke AWS IoT Greengrass dengan sedikit usaha. Lambda yang dapat di eksekusi tidak berjalan di cloud, sehingga Anda tidak dapat menggunakan AWS SDK untuk mengembangkannya di cloud sebelum deployment.

Fungsi Referensi Lambda dengan alias atau versi

Grup Greengrass dapat referensi fungsi Lambda dengan alias (direkomendasikan) atau dengan versi. Menggunakan alias membuatnya lebih mudah untuk mengelola pembaruan kode karena Anda tidak perlu mengubah tabel langganan atau definisi grup ketika kode fungsi diperbarui. Sebaliknya, Anda hanya mengarahkan alias ke versi fungsi baru. Alias menyelesaikan ke nomor versi selama deployment grup. Ketika Anda menggunakan alias, versi yang diselesaikan telah diperbarui ke versi di mana alias menunjuk ke ketika deployment.

AWS IoT Greengrass tidak mendukung alias Lambda untuk versi $TERBARU ini. $TERBARU versi tidak terikat untuk tetap, versi fungsi diterbitkan dan dapat diubah setiap ketika, yang bertentangan dengan prinsip AWS IoT Greengrass versi tetap.

Sebuah praktek umum untuk menjaga fungsi Greengrass Lambda Anda diperbarui dengan perubahan kode adalah dengan menggunakan alias bernama PRODUCTION dalam grup Greengrass dan langganan Anda. Ketika Anda mempromosikan versi baru dari fungsi Lambda Anda ke dalam produksi, arahkan alias ke versi stabil terbaru dan kemudian redeploy grupnya. Anda juga dapat menggunakan metode ini untuk kembali ke versi sebelumnya.

Arus komunikasi untuk fungsi Greengrass Lambda

Fungsi Greengrass Lambda mendukung beberapa metode komunikasi dengan anggota lain dari grup AWS IoT Greengrass ini, layanan lokal, dan layanan cloud (layanan AWS sudah termasuk).

Komunikasi menggunakan pesan MQTT

fungsi Lambda dapat mengirim dan menerima pesan MQTT menggunakan pola mempublikasikan-berlangganan yang dikendalikan oleh langganan.

Aliran komunikasi ini memungkinkan fungsi Lambda untuk bertukar pesan dengan entitas berikut:

Langganan menentukan sumber pesan, target pesan, dan topik (atau subjek) yang digunakan untuk mengarahkan pesan dari sumber ke target. Pesan yang dipublikasikan ke fungsi Lambda dilewatkan ke handler terdaftar fungsi ini. Langganan memungkinkan lebih banyak keamanan dan memberikan interaksi yang dapat diprediksi. Untuk informasi selengkapnya, lihat Langganan yang dikelola di dalam alur kerja pesan MQTT.

Arus komunikasi lainnya

Mengambil input topik MQTT (atau subjek)

AWS IoT Greengrassmenggunakan langganan untuk mengontrol pertukaran pesan MQTT antara perangkat klien, fungsi Lambda, dan konektor dalam grup, dan dengan AWS IoT atau layanan bayangan lokal. Langganan menentukan sumber pesan, target pesan, dan topik MQTT yang digunakan untuk rute pesan. Ketika target adalah fungsi Lambda, handler fungsi dipanggil ketika sumber menerbitkan pesan. Untuk informasi selengkapnya, lihat Komunikasi menggunakan pesan MQTT.

Contoh berikut menunjukkan bagaimana fungsi Lambda bisa mendapatkan input topik dari context yang diteruskan ke handler. Hal ini dilakukan dengan mengakses kunci subject dari hierarki konteks (context.client_context.custom['subject']). Contoh ini juga mengurai input pesan JSON dan kemudian menerbitkan topik dan pesan yang diurai.

import greengrasssdk
import logging

client = greengrasssdk.client('iot-data')

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

Untuk menguji fungsi, tambahkan ke grup Anda menggunakan pengaturan konfigurasi default. Kemudian, tambahkan langganan berikut dan deploy grupnya. Untuk petunjuk, lihat Modul 3 (bagian 1): Fungsi Lambda padaAWS IoT Greengrass.

Setelah deployment selesai, mengaktifkan fungsi.

Konfigurasi siklus hidup untuk fungsi Greengrass Lambda

Siklus hidup fungsi Greengrass Lambda menentukan kapan fungsi dimulai dan bagaimana menciptakan dan menggunakan kontainer. Siklus hidup juga menentukan bagaimana variabel dan logika preprocessing yang berada di luar fungsi handler dipertahankan.

AWS IoT Greengrass dukungan siklus hidup sesuai permintaan (default) atau berumur panjang:

Untuk informasi lebih lanjut tentang penggunaan kembali kontainer, lihat Memahami Penggunaan Kembali Kontainer di AWS Lambda dalam Blog Komputasi AWS ini.

Lambda yang dapat dieksekusi

Fitur ini tersedia untuk AWS IoT Greengrass Core v1.6 dan yang lebih baru.

Sebuah Lambda yang dapat dieksekusi adalah jenis fungsi Greengrass Lambda yang dapat Anda gunakan untuk menjalankan kode biner di lingkungan core. Ini memungkinkan Anda menjalankan fungsionalitas khusus perangkat secara asli dan mendapat manfaat dari jejak kode kompilasi yang lebih kecil. Lambda yang dapat dieksekusi dapat dipanggil oleh beberapa peristiwa, memanggil fungsi lainnya, dan mengakses sumber daya lokal.

Lambda yang dapat dieksekusi mendukung jenis encoding biner saja (tidak JSON), tetapi jika tidak, anda dapat mengelola mereka dalam kelompok Greengrass Anda dan menyebarkan mereka seperti fungsi Greengrass Lambda lainnya. Namun, proses menciptakan Lambda yang dapat dieksekusi berbeda dari menciptakan Python, Java, dan Node.js Lambda fungsi:

Lambda yang dapat dieksekusi harus menerapkan panggilan tertentu dan pola pemrograman dalam kode fungsi mereka. Misalnya, metode main harus:

Cuplikan berikut adalah main metode dari contoh kode simple_handler.c pada. GitHub

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

Untuk informasi lebih lanjut tentang persyaratan, kendala, dan rincian implementasi lainnya, lihat AWS IoT Greengrass Core SDK for C.

Buat Lambda yang dapat dieksekusi

Setelah Anda mengkompilasi kode Anda bersama dengan SDK, gunakan API AWS Lambda untuk membuat fungsi Lambda dan mengunggah kompilasi yang dapat dieksekusi milik Anda.

Contoh berikut menggunakan perintah CLI buat fungsi untuk membuat Lambda yang dapat dieksekusi. Perintah menentukan:

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

Selanjutnya, gunakan API AWS Lambda untuk menerbitkan versi dan membuat alias.

Kemudian, menambahkan Lambda yang dapat dieksekusi untuk grup Greengrass, mengonfigurasinya untuk menerima data input biner dalam pengaturan grup tertentu, dan men-deploy grup. Anda dapat melakukannya di konsol AWS IoT Greengrass tersebut atau menggunakan API AWS IoT Greengrass ini.