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. # Modul 2: Menginstal perangkat lunak AWS IoT Greengrass Inti Modul ini menunjukkan cara menginstal perangkat lunak AWS IoT Greengrass Core pada perangkat yang Anda pilih. Dalam modul ini, Anda pertama kali membuat Greengrass dan core. Kemudian, Anda mengunduh, mengonfigurasi, dan mulai perangkat lunak pada perangkat core Anda. Untuk informasi lebih lanjut tentang AWS IoT Greengrass fungsionalitas perangkat lunak Core, lihat [Konfigurasikan AWS IoT Greengrass inti](gg-core.md). Sebelum Anda mulai, pastikan bahwa Anda telah menyelesaikan langkah-langkah penyiapan dalam [Modul 1](module1.md) untuk perangkat yang Anda pilih. **Tip** AWS IoT Greengrass juga menyediakan opsi lain untuk menginstal perangkat lunak AWS IoT Greengrass Core. Misalnya, Anda dapat menggunakan pengaturan perangkat [Greengrass untuk mengonfigurasi lingkungan Anda dan menginstal versi terbaru perangkat](quick-start.md) lunak Core. AWS IoT Greengrass Atau, pada platform Debian yang didukung, Anda dapat menggunakan [manajer paket APT](install-ggc.md#ggc-package-manager) untuk menginstal atau meningkatkan perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat [Instal perangkat lunak AWS IoT Greengrass Inti](install-ggc.md). Modul ini akan memakan waktu kurang dari 30 menit untuk menyelesaikannya. **Topics** + [Menyediakan AWS IoT sesuatu untuk digunakan sebagai inti Greengrass](provision-core.md) + [Buat AWS IoT Greengrass grup untuk inti](create-group.md) + [Instal dan jalankan AWS IoT Greengrass pada perangkat inti](start-greengrass.md) # Menyediakan AWS IoT sesuatu untuk digunakan sebagai inti Greengrass *Greengrass* core adalah perangkat yang menjalankan perangkat lunak Core untuk mengelola proses AWS IoT Greengrass IoT lokal. Untuk menyiapkan inti Greengrass, Anda membuat sesuatu, AWS IoT *yang* mewakili perangkat atau entitas logis yang terhubung ke. AWS IoT Ketika Anda mendaftarkan perangkat sebagai AWS IoT sesuatu, perangkat itu dapat menggunakan sertifikat digital dan kunci yang memungkinkannya untuk mengakses AWS IoT. Anda menggunakan [AWS IoT kebijakan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) untuk mengizinkan perangkat berkomunikasi dengan AWS IoT dan AWS IoT Greengrass layanan. Di bagian ini, Anda mendaftarkan perangkat Anda sebagai AWS IoT sesuatu untuk menggunakannya sebagai inti Greengrass. **Untuk menciptakan AWS IoT sesuatu** 1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot) tersebut. 1. Di bawah **Kelola**, perluas **Semua perangkat**, lalu pilih **Things**. 1. Pada halaman **Things**, pilih **Create things**. 1. Pada halaman **Create things**, pilih **Create single thing**, lalu pilih **Next**. 1. Pada halaman **Tentukan properti benda**, lakukan hal berikut: 1. Untuk **nama Thing**, masukkan nama yang mewakili perangkat Anda, seperti**MyGreengrassV1Core**. 1. Pilih **Berikutnya**. 1. Pada halaman **Konfigurasi sertifikat perangkat**, pilih **Berikutnya**. 1. Pada halaman **Lampirkan kebijakan ke sertifikat**, lakukan salah satu hal berikut: + Pilih kebijakan yang ada yang memberikan izin yang diperlukan oleh core, lalu pilih **Create** thing. Modal terbuka di mana Anda dapat mengunduh sertifikat dan kunci yang digunakan perangkat untuk terhubung ke file AWS Cloud. + Buat lampiran kebijakan baru yang memberikan izin perangkat inti. Lakukan hal-hal berikut: 1. Pilih **Buat kebijakan**. Halaman **Buat kebijakan** terbuka di tab baru. 1. Pada halaman **Buat kebijakan**, lakukan hal berikut: 1. Untuk **nama Kebijakan**, masukkan nama yang menjelaskan kebijakan, seperti**GreengrassV1CorePolicy**. 1. Pada tab **Pernyataan kebijakan**, di bawah **Dokumen kebijakan**, pilih **JSON**. 1. Masukkan dokumen kebijakan berikut. Kebijakan ini memungkinkan inti untuk berkomunikasi dengan AWS IoT Core layanan, berinteraksi dengan bayangan perangkat, dan berkomunikasi dengan AWS IoT Greengrass layanan. Untuk informasi tentang cara membatasi akses kebijakan ini berdasarkan kasus penggunaan Anda, lihat[AWS IoT Kebijakan minimal untuk perangkat AWS IoT Greengrass inti](device-auth.md#gg-config-sec-min-iot-policy). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Subscribe", "iot:Connect", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "greengrass:*" ], "Resource": [ "*" ] } ] } ``` ------ 1. Pilih **Buat** untuk membuat kebijakan. 1. Kembali ke tab browser dengan halaman **Lampirkan kebijakan ke sertifikat** terbuka. Lakukan hal-hal berikut: 1. Dalam daftar **Kebijakan**, pilih kebijakan yang Anda buat, seperti **GreengrassV1CorePolicy**. Jika Anda tidak melihat kebijakan, pilih tombol segarkan. 1. Pilih **Buat sesuatu**. Modal terbuka di mana Anda dapat mengunduh sertifikat dan kunci yang digunakan inti untuk terhubung AWS IoT. 1. Kembali ke tab browser dengan halaman **Lampirkan kebijakan ke sertifikat** terbuka. Lakukan hal-hal berikut: 1. Dalam daftar **Kebijakan**, pilih kebijakan yang Anda buat, seperti **GreengrassV1CorePolicy**. Jika Anda tidak melihat kebijakan, pilih tombol segarkan. 1. Pilih **Buat sesuatu**. Modal terbuka di mana Anda dapat mengunduh sertifikat dan kunci yang digunakan inti untuk terhubung AWS IoT. 1. Dalam modal **Unduh sertifikat dan kunci**, unduh sertifikat perangkat. **penting** Sebelum Anda memilih **Selesai**, unduh sumber daya keamanan. Lakukan hal-hal berikut: 1. Untuk **sertifikat Perangkat**, pilih **Unduh** untuk mengunduh sertifikat perangkat. 1. Untuk **file kunci Publik**, pilih **Unduh** untuk mengunduh kunci publik untuk sertifikat. 1. Untuk **file kunci pribadi**, pilih **Unduh** untuk mengunduh file kunci pribadi untuk sertifikat. 1. Review [Autentikasi Server](https://docs.aws.amazon.com/iot/latest/developerguide/server-authentication.html) dalam *AWS IoT Panduan Developer* dan memilih root sertifikat CA yang sesuai. Kami merekomendasikan Anda menggunakan Amazon Trust Services (ATS) titik akhir dan ATS root sertifikat CA. Di bawah **sertifikat Root CA**, pilih **Unduh** untuk sertifikat CA root. 1. Pilih **Selesai**. Catat ID sertifikat yang umum dalam nama file untuk sertifikat dan kunci perangkat. Anda membutuhkannya nanti. # Buat AWS IoT Greengrass grup untuk inti AWS IoT Greengrass *grup* berisi pengaturan dan informasi lain tentang komponennya, seperti perangkat klien, fungsi Lambda, dan konektor. Sebuah grup mendefinisikan konfigurasi untuk inti, termasuk bagaimana komponennya dapat berinteraksi satu sama lain. Di bagian ini, Anda membuat grup untuk inti Anda. **Tip** Untuk contoh yang menggunakan AWS IoT Greengrass API untuk membuat dan menerapkan grup, lihat repositori [gg\$1group\$1setup aktif](https://github.com/awslabs/aws-greengrass-group-setup). GitHub **Untuk membuat grup untuk inti** 1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot) tersebut. 1. **Di bawah **Kelola**, perluas perangkat **Greengrass**, dan pilih Grup (V1).** **catatan** Jika Anda tidak melihat menu perangkat **Greengrass**, ubah ke menu yang mendukung. Wilayah AWS AWS IoT Greengrass V1 Untuk daftar Wilayah yang didukung, lihat [AWS IoT Greengrass V1 titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/greengrass.html) di. *Referensi Umum AWS* Anda harus [membuat AWS IoT hal untuk inti Anda](provision-core.md) di Wilayah di mana AWS IoT Greengrass V1 tersedia. 1. **Pada halaman grup **Greengrass**, pilih Buat grup.** 1. Pada halaman grup **Create Greengrass**, lakukan hal berikut: 1. Untuk nama grup **Greengrass, masukkan nama yang menggambarkan grup**, seperti. **MyGreengrassGroup** 1. Untuk inti **Greengrass**, pilih hal yang Anda buat AWS IoT sebelumnya, seperti **MyGreengrassV1Core**. Konsol secara otomatis memilih sertifikat perangkat untuk Anda. 1. Pilih **Buat grup**. # Instal dan jalankan AWS IoT Greengrass pada perangkat inti **catatan** Tutorial ini memberikan instruksi bagi Anda untuk menjalankan perangkat lunak AWS IoT Greengrass Core pada Raspberry Pi, tetapi Anda dapat menggunakan perangkat apa pun yang didukung. Di bagian ini, Anda mengonfigurasi, menginstal, dan menjalankan perangkat lunak AWS IoT Greengrass Core pada perangkat inti Anda. **Untuk menginstal dan menjalankan AWS IoT Greengrass** 1. Dari bagian [perangkat lunak AWS IoT Greengrass inti](what-is-gg.md#gg-core-download-tab) dalam panduan ini, unduh paket instalasi perangkat lunak AWS IoT Greengrass Core. Pilih paket yang paling sesuai dengan arsitektur CPU, distribusi, dan OS perangkat core Anda. + Untuk Raspberry Pi, unduh paket untuk arsitektur ARMv7L dan sistem operasi Linux. + Untuk EC2 contoh Amazon, unduh paket untuk arsitektur x86\$164 dan sistem operasi Linux. + Untuk NVIDIA Jetson TX2, unduh paket untuk arsitektur Armv8 (AArch64) dan sistem operasi Linux. + Untuk Intel Atom, unduh paket untuk arsitektur x86\$164 dan sistem operasi Linux. 1. Pada langkah sebelumnya, Anda mengunduh lima file ke komputer Anda: + `greengrass-OS-architecture-1.11.6.tar.gz`- File terkompresi ini berisi perangkat lunak AWS IoT Greengrass Core yang berjalan pada perangkat inti. + `certificateId-certificate.pem.crt`— File sertifikat perangkat. + `certificateId-public.pem.key`— File kunci publik sertifikat perangkat. + `certificateId-private.pem.key`— File kunci pribadi sertifikat perangkat. + `AmazonRootCA1.pem`— File otoritas sertifikat root Amazon (CA). Pada langkah ini, Anda mentransfer file-file ini dari komputer Anda ke perangkat inti Anda. Lakukan hal-hal berikut: 1. Jika Anda tidak tahu alamat IP perangkat inti Greengrass Anda, buka terminal pada perangkat inti dan jalankan perintah berikut. **catatan** Perintah ini mungkin tidak mengembalikan alamat IP yang benar untuk beberapa perangkat. Konsultasikan dokumentasi untuk perangkat Anda untuk mengambil alamat IP perangkat Anda. ``` hostname -I ``` 1. Transfer file-file ini dari komputer Anda ke perangkat inti Anda. Langkah transfer file bervariasi tergantung pada sistem operasi komputer Anda. Pilih sistem operasi Anda untuk langkah-langkah yang menunjukkan cara untuk mentransfer file ke perangkat Raspberry Pi Anda. **catatan** Untuk Raspberry Pi, nama pengguna default adalah **pi** dan kata sandi default-nya adalah **raspberry**. Untuk NVIDIA Jetson TX2, nama pengguna default adalah **nvidia** dan kata sandi default adalah. **nvidia** ------ #### [ Windows ] Untuk mentransfer file terkompresi dari komputer Anda ke perangkat core Raspberry Pi, gunakan alat seperti [WinSCP](https://winscp.net/eng/download.php) atau [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) **pscp** perintah. Untuk menggunakan **pscp** perintah, buka jendela Command Prompt pada komputer Anda dan jalankan hal berikut: ``` cd path-to-downloaded-files pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi ``` **catatan** Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak AWS IoT Greengrass Core Anda. ------ #### [ macOS ] Untuk mentransfer file terkompresi dari Mac Anda ke perangkat core Raspberry Pi, buka jendela Terminal pada komputer Anda dan jalankan perintah berikut. *path-to-downloaded-files*Biasanya`~/Downloads`. **catatan** Anda mungkin diminta untuk memasukkan dua kata sandi. Jika demikian, kata sandi pertama adalah untuk `sudo` perintah Mac dan yang kedua adalah kata sandi untuk Raspberry Pi. ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **catatan** Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak AWS IoT Greengrass Core Anda. ------ #### [ UNIX-like system ] Untuk mentransfer file terkompresi dari komputer Anda ke perangkat core Raspberry Pi, buka jendela terminal pada komputer Anda dan jalankan perintah berikut: ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **catatan** Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak AWS IoT Greengrass Core Anda. ------ #### [ Raspberry Pi web browser ] Jika Anda menggunakan browser web Raspberry Pi untuk mengunduh file terkompresi, file harus berada di `~/Downloads` folder Pi, seperti`/home/pi/Downloads`. Jika tidak, file terkompresi harus berada di `~` folder Pi, seperti`/home/pi`. ------ 1. Pada perangkat inti Greengrass, buka terminal, dan arahkan ke folder yang berisi AWS IoT Greengrass perangkat lunak inti dan sertifikat. Ganti *path-to-transferred-files* dengan jalur tempat Anda mentransfer file pada perangkat inti. Misalnya, pada Raspberry Pi, jalankan`cd /home/pi`. ``` cd path-to-transferred-files ``` 1. Buka paket perangkat lunak AWS IoT Greengrass Core pada perangkat inti. Jalankan perintah berikut untuk membongkar arsip perangkat lunak yang Anda transfer ke perangkat inti. Perintah ini menggunakan `-C /` argumen untuk membuat `/greengrass` folder di folder root perangkat inti. ``` sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C / ``` **catatan** Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak AWS IoT Greengrass Core Anda. 1. Pindahkan sertifikat dan kunci ke folder perangkat lunak AWS IoT Greengrass inti. Jalankan perintah berikut untuk membuat folder untuk sertifikat dan memindahkan sertifikat dan kunci ke sana. Ganti *path-to-transferred-files* dengan jalur tempat Anda mentransfer file pada perangkat inti, dan ganti *certificateId* dengan ID sertifikat di nama file. Misalnya, pada Raspberry Pi, ganti *path-to-transferred-files* dengan **/home/pi** ``` sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs ``` 1. Perangkat lunak AWS IoT Greengrass Core menggunakan file konfigurasi yang menentukan parameter untuk perangkat lunak. File konfigurasi ini menentukan jalur file untuk file sertifikat dan AWS Cloud titik akhir yang akan digunakan. Pada langkah ini, Anda membuat file konfigurasi perangkat lunak AWS IoT Greengrass Core untuk inti Anda. Lakukan hal-hal berikut: 1. Dapatkan Nama Sumber Daya Amazon (ARN) untuk hal AWS IoT inti Anda. Lakukan hal-hal berikut: 1. **Di [AWS IoT konsol](https://console.aws.amazon.com/iot), di bawah **Kelola**, di bawah Perangkat **Greengrass**, pilih Grup (V1).** 1. Pada halaman grup **Greengrass**, pilih grup yang Anda buat sebelumnya. 1. Di bawah **Ikhtisar**, pilih **Inti Greengrass**. 1. Pada halaman detail inti, salin **AWS IoT ARN**, dan simpan untuk digunakan dalam file konfigurasi AWS IoT Greengrass Core. 1. Dapatkan titik akhir data AWS IoT perangkat untuk Anda Akun AWS di Wilayah saat ini. Perangkat menggunakan titik akhir ini untuk terhubung AWS sebagai AWS IoT sesuatu. Lakukan hal-hal berikut: 1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot), pilih **Pengaturan**. 1. Di bawah **titik akhir data perangkat**, salin **Endpoint**, dan simpan untuk digunakan dalam file konfigurasi AWS IoT Greengrass Core. 1. Buat file konfigurasi perangkat lunak AWS IoT Greengrass inti. Misalnya, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuat file . ``` sudo nano /greengrass/config/config.json ``` Ganti isi file dengan dokumen JSON berikut. ``` { "coreThing" : { "caPath": "AmazonRootCA1.pem", "certPath": "certificateId-certificate.pem.crt", "keyPath": "certificateId-private.pem.key", "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core", "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com", "ggHost": "greengrass-ats.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes" } }, "managedRespawn": false, "crypto": { "caPath": "file:///greengrass/certs/AmazonRootCA1.pem", "principals": { "SecretsManager": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key" }, "IoTCertificate": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key", "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt" } } } } ``` Kemudian, lakukan hal berikut: + Jika Anda mengunduh sertifikat CA root Amazon yang berbeda dari Amazon Root CA 1, ganti setiap instance *AmazonRootCA1.pem* dengan nama file CA root Amazon. + Ganti setiap instance *certificateId* dengan ID sertifikat atas nama sertifikat dan file kunci. + Ganti *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core* dengan ARN dari hal inti Anda yang Anda simpan sebelumnya. + Ganti *MyGreengrassV1core* dengan nama inti Anda. + Ganti *device-data-prefix-ats.iot.region.amazonaws.com* dengan titik akhir data AWS IoT perangkat yang Anda simpan sebelumnya. + Ganti *region* dengan Anda Wilayah AWS. Untuk informasi selengkapnya tentang opsi konfigurasi yang dapat Anda tentukan dalam file konfigurasi ini, lihat[AWS IoT Greengrass file konfigurasi inti](gg-core.md#config-json). 1. Pastikan bahwa perangkat core Anda tersambung ke internet. Kemudian, mulai AWS IoT Greengrass pada perangkat inti Anda. ``` cd /greengrass/ggc/core/ sudo ./greengrassd start ``` Anda akan melihat `Greengrass successfully started` pesan. Perhatikan PID. **catatan** Untuk mengatur perangkat inti Anda untuk memulai AWS IoT Greengrass pada boot sistem, lihat[Konfigurasikan sistem init untuk memulai Greengrass daemon](gg-core.md#start-on-boot). Anda dapat menjalankan perintah berikut untuk mengonfirmasi bahwa perangkat lunak AWS IoT Greengrass Core (Greengrass daemon) berfungsi. Ganti *PID-number* dengan PID Anda: ``` ps aux | grep PID-number ``` Anda akan melihat entri untuk PID dengan path ke Greengrass daemon yang sedang berjalan (sebagai contoh, `/greengrass/ggc/packages/1.11.6/bin/daemon`). Jika Anda mengalami masalah mulai AWS IoT Greengrass, lihat[Pemecahan masalah AWS IoT Greengrass](gg-troubleshooting.md).