Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan konektor Greengrass (konsol)
Fitur ini tersedia untuk AWS IoT Greengrass Core v1.7 dan yang lebih baru.
Tutorial ini menunjukkan cara menggunakan Konsol Manajemen AWS untuk bekerja dengan konektor.
Gunakan konektor untuk mempercepat siklus hidup pengembangan Anda. Konektor prebuilt, modul dapat digunakan kembali yang dapat membuatnya lebih mudah untuk berinteraksi dengan layanan, protokol, dan sumber daya. Mereka dapat membantu Anda men-deploy logika bisnis ke perangkat Greengrass lebih cepat. Untuk informasi lebih lanjut, lihat [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md).
Dalam tutorial ini, Anda mengkonfigurasi dan men-deploy [ konektor](twilio-notifications-connector.md) Notifikasi Twilio. Konektor menerima informasi pesan Twilio sebagai input data, dan kemudian memicu pesan teks Twilio. Aliran data ditunjukkan pada diagram berikut.
![\[Aliran data dari fungsi Lambda untuk konektor Notifikasi Twilio ke Twilio.\]](http://docs.aws.amazon.com/id_id/greengrass/v1/developerguide/images/connectors/twilio-solution.png)
Setelah Anda mengkonfigurasi konektor, Anda membuat fungsi Lambda dan langganan.
+ Fungsi mengevaluasi data simulasi dari sensor temperatur. Ini kondisional menerbitkan informasi pesan Twilio untuk topik MQTT. Ini adalah topik yang konektor berlangganan.
+ Langganan membolehkan fungsi untuk menerbitkan topik dan konektor untuk menerima data dari topik tersebut.
Konektor Notifikasi Twilio memerlukan token Twilio auth untuk berinteraksi dengan Twilio API. Token adalah rahasia jenis teks yang dibuat AWS Secrets Manager dan direferensikan dari sumber daya grup. Hal ini memungkinkan AWS IoT Greengrass untuk membuat salinan lokal rahasia pada inti Greengrass, di mana ia dienkripsi dan tersedia untuk konektor. Untuk informasi selengkapnya, lihat [Menyebarkan rahasia ke inti AWS IoT Greengrass](secrets.md).
Tutorial berisi langkah-langkah tingkat tinggi berikut:
1. [Buat rahasia Secrets Manager](#connectors-console-create-secret)
1. [Tambahkan sumber daya rahasia ke grup](#connectors-console-create-resource)
1. [Tambahkan konektor ke grup](#connectors-console-create-connector)
1. [Buat fungsi Lambda paket deployment](#connectors-console-create-deployment-package)
1. [Buat fungsi Lambda](#connectors-console-create-function)
1. [Tambahkan fungsi ke grup](#connectors-console-create-gg-function)
1. [Tambahkan langganan ke grup](#connectors-console-create-subscription)
1. [Men-deploy grup](#connectors-console-create-deployment)
1. [Pengujian solusi](#connectors-console-test-solution)
Tutorial akan memakan waktu sekitar 20 menit untuk menyelesaikannya.
## Prasyarat
Untuk menyelesaikan tutorial ini, Anda memerlukan:
+ Sebuah grup Greengrass dan Greengrass core (v1.9.3 atau yang lebih baru). Untuk mempelajari cara membuat grup Greengrass dan core, lihat [Memulai dengan AWS IoT Greengrass](gg-gs.md). Tutorial Memulai Dengan juga mencakup langkah-langkah untuk menginstal perangkat lunak AWS IoT Greengrass Core.
+ Python 3.7 diinstal pada perangkat inti. AWS IoT Greengrass
+ AWS IoT Greengrass harus dikonfigurasi untuk mendukung rahasia lokal, seperti yang dijelaskan dalam [Persyaratan Rahasia](secrets.md#secrets-reqs).
**catatan**
Persyaratan ini mencakup akses ke rahasia Secrets Manager Anda. Jika Anda menggunakan peran layanan default Greengrass, Greengrass memiliki izin untuk mendapatkan nilai-nilai rahasia dengan nama yang dimulai dengan *Greengrass-*.
+ Akun Twilio SID, token auth, dan nomor telepon berkemampuan Twilio. Setelah Anda membuat proyek Twilio, nilai-nilai ini tersedia dalam dasbor proyek.
**catatan**
Anda dapat menggunakan akun percobaan Twilio. Jika menggunakan akun uji coba, Anda harus menambahkan nomor telepon penerima selain Twilio ke daftar nomor telepon terverifikasi. Untuk informasi lebih lanjut, lihat [ Cara Bekerja dengan Akun Uji Coba Twilio Gratis Anda](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account).
## Langkah 1: Buat rahasia Secrets Manager
Pada langkah ini, Anda menggunakan AWS Secrets Manager konsol untuk membuat rahasia jenis teks untuk token autentikasi Twilio Anda.
1. Masuk ke [AWS Secrets Manager konsol](https://console.aws.amazon.com/secretsmanager/).
**catatan**
Untuk informasi lebih lanjut tentang proses ini, lihat [ Langkah 1: Buat dan simpan rahasia Anda di AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/tutorials_basic.html) dalam *AWS Secrets Manager Panduan Pengguna*.
1. Pilih **Simpan rahasia baru**.
1. Di bawah **Pilih tipe rahasia**, pilih **Jenis rahasia lainnya**.
1. Di bawah **Tentukan key/value pasangan yang akan disimpan untuk rahasia ini**, pada tab **Plaintext**, masukkan token autentikasi Twilio Anda. Hapus semua format JSON dan masukkan hanya nilai token.
1. **Tetap pilih **aws/secretsmanager** untuk kunci enkripsi, lalu pilih Berikutnya.**
**catatan**
Anda tidak dikenakan biaya AWS KMS jika menggunakan kunci AWS terkelola default yang dibuat Secrets Manager di akun Anda.
1. Untuk **Nama rahasia**, masukkan **greengrass-TwilioAuthToken**, dan pilih **Selanjutnya**.
**catatan**
*Secara default, peran layanan Greengrass AWS IoT Greengrass memungkinkan untuk mendapatkan nilai rahasia dengan nama yang dimulai dengan greengrass-.* Untuk informasi lebih lanjut, lihat [persyaratan rahasia](secrets.md#secrets-reqs).
1. Tutorial ini tidak memerlukan rotasi, jadi pilih nonaktifkan rotasi otomatis, lalu pilih **Berikutnya**.
1. Pada halaman **Tinjauan** tersebut, tinjau pengaturan Anda, dan kemudian pilih **Menyimpan**.
Selanjutnya, Anda membuat sumber daya rahasia dalam grup Greengrass Anda yang mereferensi rahasia.
## Langkah 2: Menambahkan sumber daya rahasia ke grup Greengrass
Pada langkah ini, Anda tambahkan *sumber daya rahasia* ke grup Greengrass. Sumber daya ini adalah referensi rahasia yang Anda buat pada langkah sebelumnya.
1. **Di panel navigasi AWS IoT konsol, di bawah **Kelola**, perluas perangkat **Greengrass**, lalu pilih Grup (V1).**
1. Pilih grup yang ingin Anda tambahkan sumber daya rahasia.
1. Pada halaman konfigurasi grup, pilih tab **Sumber Daya**, lalu gulir ke bawah ke bagian **Rahasia**. Bagian **Rahasia** menampilkan sumber daya rahasia milik grup. Anda dapat menambahkan, mengedit, dan menghapus sumber daya rahasia dari bagian ini.
**catatan**
Sebagai alternatif, konsol tersebut mengizinkan Anda membuat sumber rahasia dan rahasia saat Anda mengonfigurasi konektor atau fungsi Lambda. Anda dapat melakukan hal ini dari konektor halaman **Mengonfigurasi parameter** atau fungsi Lambda halaman **Sumber Daya** ini.
1. Pilih **Tambah** di bawah bagian **Rahasia**.
1. Pada halaman **Tambahkan sumber daya rahasia**, masukkan **MyTwilioAuthToken** untuk **nama Sumber Daya**.
1. Untuk **Rahasia**, pilih **greengrass-**. TwilioAuthToken
1. Di bagian **Pilih label (Opsional)**, label AWSCURRENT pementasan mewakili versi terbaru dari rahasia. Label ini selalu disertakan dalam sumber rahasia.
**catatan**
Tutorial ini hanya membutuhkan AWSCURRENT label. Anda dapat secara opsional menyertakan label yang diperlukan oleh fungsi Lambda atau konektor.
1. Pilih **Tambahkan sumber daya**.
## Langkah 3: Tambahkan konektor ke grup Greengrass
Pada langkah ini, Anda mengkonfigurasi parameter untuk [konektor Notifikasi Twilio](twilio-notifications-connector.md) dan menambahkannya ke grup.
1. Pada halaman konfigurasi grup, pilih **Konektor**, dan lalu pilih **Menambahkan konektor**.
1. Pada halaman **Tambah konektor**, pilih **Twilio** Notifications.
1. Pilih versinya.
1. Di bagian **Konfigurasi**:
+ Untuk **sumber daya token autentikasi Twilio**, masukkan sumber daya yang Anda buat di langkah sebelumnya.
**catatan**
Saat Anda memasukkan sumber daya, **ARN properti rahasia token autentikasi Twilio** diisi untuk Anda.
+ Untuk **Default dari nomor telepon**, masukkan nomor telepon berkemampuan Twilio Anda.
+ Untuk **akun Twilio SID**, masukkan akun Twilio SID Anda.
1. Pilih **Tambahkan sumber daya**.
## Langkah 4: Buat fungsi Lambda paket deployment
Untuk membuat fungsi Lambda, Anda harus terlebih dahulu membuat fungsi Lambda *paket deployment* yang berisi kode fungsi dan dependensi. Fungsi Greengrass Lambda membutuhkan [AWS IoT Greengrass Core SDK](lambda-functions.md#lambda-sdks-core) untuk tugas seperti berkomunikasi dengan pesan MQTT di lingkungan core dan mengakses rahasia lokal. Tutorial ini membuat fungsi Python, sehingga Anda menggunakan versi Python dari SDK dalam paket deployment.
1. Dari halaman unduhan [AWS IoT Greengrass Core SDK](what-is-gg.md#gg-core-sdk-download), unduh AWS IoT Greengrass Core SDK untuk Python ke komputer Anda.
1. Unzip paket yang diunduh untuk mendapatkan SDK. SDK adalah folder `greengrasssdk` tersebut.
1. Simpan fungsi kode Python berikut dalam sebuah file lokal bernama `temp_monitor.py`.
```
import greengrasssdk
import json
import random
client = greengrasssdk.client('iot-data')
# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
temp = event['temperature']
# check the temperature
# if greater than 30C, send a notification
if temp > 30:
data = build_request(event)
client.publish(topic='twilio/txt', payload=json.dumps(data))
print('published:' + str(data))
print('temperature:' + str(temp))
return
# build the Twilio request from the input data
def build_request(event):
to_name = event['to_name']
to_number = event['to_number']
temp_report = 'temperature:' + str(event['temperature'])
return {
"request": {
"recipient": {
"name": to_name,
"phone_number": to_number,
"message": temp_report
}
},
"id": "request_" + str(random.randint(1,101))
}
```
1. Zip item berikut ke dalam file bernama `temp_monitor_python.zip`. Saat membuat file ZIP, sertakan hanya kode dan dependensi, bukan folder yang berisi.
+ **temp\$1monitor.py**. Aplikasi logic.
+ **greengrasssdk**. Diperlukan perpustakaan untuk fungsi Python Greengrass Lambda yang menerbitkan pesan MQTT.
Ini adalah paket deployment fungsi Lambda Anda.
Sekarang, buat fungsi Lambda yang menggunakan paket deployment.
## Langkah 5: Buat fungsi Lambda di konsol AWS Lambda
Pada langkah ini, Anda menggunakan AWS Lambda konsol untuk membuat fungsi Lambda dan mengonfigurasinya untuk menggunakan paket penerapan Anda. Kemudian, Anda mempublikasikan versi fungsi dan membuat alias.
1. Pertama, buat fungsi Lambda.
1. Di Konsol Manajemen AWS, pilih **Layanan**, dan buka AWS Lambda konsol.
1. Pilih **Buat fungsi** dan kemudian **Tulis dari awal**.
1. Di bagian **Informasi dasar** tersebut, gunakan nilai-nilai berikut:
+ Untuk **Nama fungsi**, masukkan **TempMonitor**.
+ Untuk **Waktu pengoperasian**, pilih **Python 3.7**.
+ Untuk **Izin**, pertahankan pengaturan default. Hal ini menciptakan peran eksekusi yang memberikan izin Lambda basic. Peran ini tidak digunakan oleh AWS IoT Greengrass
1. Di bagian bawah halaman, pilih **Buat Fungsi**.
1. Selanjutnya, daftarkan handler dan unggah paket deployment fungsi Lambda Anda.
1. Pada tab **Kode** ini, di bawah **Sumber kode**, pilih **Unggah dari**. Dari dropdown, pilih **file .zip**.
![\[Unggah dari dropdown dengan file .zip disorot.\]](http://docs.aws.amazon.com/id_id/greengrass/v1/developerguide/images/lra-console/upload-deployment-package.png)
1. Pilih **Unggah**, lalu pilih paket deployment `temp_monitor_python.zip` Anda. Lalu, pilih **Simpan**.
1. Pada tab **Kode** fungsi, di bawah **Pengaturan waktu aktif**, pilih **Edit**, dan kemudian masukkan nilai-nilai berikut.
+ Untuk **Waktu pengoperasian**, pilih **Python 3.7**.
+ Untuk **Handler**, masukkan **temp\$1monitor.function\$1handler**
1. Pilih **Simpan**.
**catatan**
Tombol **Uji** di AWS Lambda konsol tidak berfungsi dengan fungsi ini. AWS IoT Greengrass Core SDK tidak berisi modul yang diperlukan untuk menjalankan fungsi Greengrass Lambda Anda secara independen di konsol. AWS Lambda Modul-modul ini (misalnya, `greengrass_common`) dipasok ke fungsi setelah mereka di-deploy ke core Greengrass Anda.
1. Sekarang, publikasikan versi pertama fungsi Lambda Anda dan membuat [alias untuk versi](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html).
**catatan**
Grup Greengrass dapat mereferensi 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.
1. Dari menu **Tindakan** ini, pilih **Terbitkan versi baru**.
1. Untuk **Versi Deskripsi**, masukkan **First version**, lalu pilih **Publikasikan**.
1. Pada halaman konfigurasi **TempMonitor: 1**, dari menu **Tindakan**, pilih **Buat alias**.
1. Pada halaman **Buat alias baru** ini, gunakan nilai-nilai berikut:
+ Untuk **Nama**, masukkan **GG\$1TempMonitor**.
+ Untuk **Versi**, pilih **1**.
**catatan**
AWS IoT Greengrass **tidak mendukung alias Lambda untuk versi \$1LATEST.**
1. Pilih **Buat**.
Sekarang Anda siap untuk menambahkan fungsi Lambda ke grup Greengrass Anda.
## Langkah 6: Tambahkan fungsi Lambda ke grup Greengrass
Dalam langkah ini, Anda menambahkan fungsi Lambda ke grup lalu mengonfigurasi siklus hidup dan lingkungan variabel. Untuk informasi selengkapnya, lihat [Mengontrol eksekusi fungsi Greengrass Lambda dengan menggunakan konfigurasi grup khusus](lambda-group-config.md).
1. Pada halaman konfigurasi grup, pilih tab **fungsi Lambda**.
1. **Di bawah **fungsi Lambda Saya**, pilih Tambah.**
1. Pada halaman **fungsi Add Lambda, pilih **TempMonitor**fungsi** Lambda Anda.
1. Untuk **versi fungsi Lambda**, pilih **Alias**: GG\$1. TempMonitor
1. Pilih **Tambahkan fungsi Lambda**.
## Langkah 7: Menambahkan langganan ke grup Greengrass
Pada langkah ini, Anda menambahkan langganan yang memungkinkan fungsi Lambda untuk mengirim input data ke konektor. Konektor mendefinisikan topik MQTT yang berlangganan, jadi langganan ini menggunakan salah satu topik. Ini adalah topik yang sama bahwa fungsi contoh menerbitkan.
Untuk tutorial ini, Anda juga membuat langganan yang memungkinkan fungsi menerima pembacaan suhu simulasi dari AWS IoT dan memungkinkan AWS IoT untuk menerima informasi status dari konektor.
1. Pada halaman konfigurasi grup, pilih tab **Langganan**, lalu pilih **Tambah Langganan**.
1. Pada halaman **Buat langganan**, konfigurasikan sumber dan target, sebagai berikut:
1. Untuk **tipe Sumber**, pilih **fungsi Lambda**, lalu pilih. **TempMonitor**
1. Untuk **tipe Target**, pilih **Connector**, lalu pilih **Twilio** Notifications.
1. Untuk **filter Topik**, pilih**twilio/txt**.
1. Pilih **Buat langganan**.
1. Ulangi langkah 1 - 4 untuk membuat langganan yang memungkinkan AWS IoT untuk mempublikasikan pesan ke fungsi.
1. Untuk **jenis Sumber**, pilih **Layanan**, lalu pilih **IoT Cloud**.
1. Untuk **Pilih target**, pilih **fungsi Lambda**, lalu pilih. **TempMonitor**
1. Untuk **Filter topik**, masukkan **temperature/input**.
1. Ulangi langkah 1 - 4 untuk membuat langganan yang membolehkan konektor menerbitkan pesan AWS IoT.
1. Untuk **tipe Source**, pilih **Connector**, lalu pilih **Twilio** Notifications.
1. Untuk **jenis Target**, pilih **Layanan**, lalu pilih **IoT Cloud**.
1. Untuk **filter Topik**, **twilio/message/status** dimasukkan untuk Anda. Ini adalah topik yang telah ditetapkan yang diterbitkan oleh konektor.
## Langkah 8: Men-deploy grup Greengrass
Men-deploy grup ke perangkat core.
1. Pastikan AWS IoT Greengrass inti sedang berjalan. Jalankan perintah berikut di terminal Raspberry Pi Anda, sesuai kebutuhan.
1. Untuk memeriksa apakah daemon sedang berjalan:
```
ps aux | grep -E 'greengrass.*daemon'
```
Jika outputnya berisi entri `root` untuk `/greengrass/ggc/packages/ggc-version/bin/daemon`, maka daemon sedang berjalan.
**catatan**
Versi di jalur tergantung pada versi perangkat lunak AWS IoT Greengrass Core yang diinstal pada perangkat inti Anda.
1. Untuk memulai daemon:
```
cd /greengrass/ggc/core/
sudo ./greengrassd start
```
1. Pada halaman konfigurasi grup, pilih **Deploy**.
1.
1. **Di tab **Fungsi Lambda, di bawah bagian Fungsi** **Lambda Sistem**, pilih **detektor IP** dan pilih Edit.**
1. Dalam kotak dialog **Edit pengaturan detektor IP**, pilih **Secara otomatis mendeteksi dan mengganti titik akhir broker MQTT**.
1. Pilih **Simpan**.
Hal ini mengaktifkan perangkat untuk secara otomatis memperoleh informasi konektivitas untuk core, seperti alamat IP, DNS, dan nomor port. Deteksi otomatis direkomendasikan, tetapi AWS IoT Greengrass juga mendukung titik akhir yang ditentukan secara manual. Anda hanya diminta untuk metode penemuan pertama kalinya bahwa grup di-deploy.
**catatan**
Jika diminta, berikan izin untuk membuat peran layanan [Greengrass dan kaitkan dengan peran layanan](service-role.md) Anda saat ini. Akun AWS Wilayah AWS Peran ini memungkinkan AWS IoT Greengrass untuk mengakses sumber daya Anda dalam AWS layanan.
Halaman **Deployment** menampilkan timestamp deployment, ID versi, dan status. Setelah selesai, status yang ditampilkan untuk penerapan harus **Selesai**.
Untuk langkah-langkah penyelesaian masalah, lihat [Pemecahan masalah AWS IoT Greengrass](gg-troubleshooting.md).
**catatan**
Sebuah grup Greengrass dapat berisi hanya satu versi dari konektor pada suatu waktu. Untuk informasi tentang peningkatan versi konektor, lihat [Versi upgrade konektor](connectors.md#upgrade-connector-versions).
## Pengujian solusi
1. Di halaman beranda AWS IoT konsol, pilih **Uji**.
1. Untuk **Berlangganan topik**, gunakan nilai berikut, dan lalu pilih **Langganan**. Konektor Notifikasi Twilio menerbitkan informasi status untuk topik ini.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v1/developerguide/connectors-console.html)
1. Untuk **Publikasikan ke topik**, gunakan nilai-nilai berikut, dan kemudian pilih **Publikasikan** untuk memanggil fungsi.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v1/developerguide/connectors-console.html)
Jika berhasil, penerima menerima pesan teks dan konsol menampilkan `success` status dari [output data](twilio-notifications-connector.md#twilio-notifications-connector-data-output).
Sekarang, ubah `temperature` dalam pesan input untuk **29** dan terbitkan. Karena ini kurang dari 30, TempMonitor fungsinya tidak memicu pesan Twilio.
## Lihat juga
+ [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md)
+ [AWS-disediakan konektor Greengrass](connectors-list.md)