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

Dari bagian perangkat lunak AWS IoT Greengrass inti 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_64 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_64 dan sistem operasi Linux.
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
```
2. 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 atau PuTTY 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-filesBiasanya~/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.
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, jalankancd /home/pi.
```
cd path-to-transferred-files
```
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.
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
```
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, di bawah Kelola, di bawah Perangkat Greengrass, pilih Grup (V1).
  2. Pada halaman grup Greengrass, pilih grup yang Anda buat sebelumnya.
  3. Di bawah Ikhtisar, pilih Inti Greengrass.
  4. Pada halaman detail inti, salin AWS IoT ARN, dan simpan untuk digunakan dalam file konfigurasi AWS IoT Greengrass Core.
2. 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, pilih Pengaturan.
  2. Di bawah titik akhir data perangkat, salin Endpoint, dan simpan untuk digunakan dalam file konfigurasi AWS IoT Greengrass Core.
3. 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, lihatAWS IoT Greengrass file konfigurasi inti.
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, lihatKonfigurasikan sistem init untuk memulai Greengrass daemon.

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, lihatPemecahan masalah AWS IoT Greengrass.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Buat grup Greengrass

Modul 3 (bagian 1): Fungsi Lambda aktif AWS IoT Greengrass