Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya otomatis

Untuk mengatur perangkat Linux untuk AWS IoT Greengrass V2

1. Instal runtime Java, yang dibutuhkan perangkat lunak AWS IoT Greengrass Core untuk dijalankan. Kami menyarankan Anda menggunakan Amazon Corretto atau JDK Buka versi dukungan jangka panjang. Versi 8 atau lebih tinggi diperlukan. Perintah berikut menunjukkan cara menginstal Buka JDK di perangkat Anda.

   • Untuk distribusi berbasis Debian atau berbasis Ubuntu:

     sudo apt install default-jdk

   • Untuk distribusi berbasis Red Hat:

     sudo yum install java-11-openjdk-devel

   • Untuk Amazon Linux 2:

     sudo amazon-linux-extras install java-openjdk11

   • Untuk Amazon Linux 2023:

     sudo dnf install java-11-amazon-corretto -y

   Ketika instalasi selesai, jalankan perintah berikut untuk memverifikasi bahwa Java berjalan pada perangkat Linux Anda.

   java -version

   Perintah mencetak versi Java yang berjalan pada perangkat. Misalnya, pada distribusi berbasis Debian, output mungkin terlihat mirip dengan sampel berikut.

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. (Opsional) Buat pengguna dan grup sistem default yang menjalankan komponen pada perangkat. Anda juga dapat memilih untuk membiarkan penginstal perangkat lunak AWS IoT Greengrass Core membuat pengguna dan grup ini selama instalasi dengan argumen --component-default-user installer. Untuk informasi selengkapnya, lihat Argumen penginstal.

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. Verifikasi bahwa pengguna yang menjalankan perangkat lunak AWS IoT Greengrass Core (biasanyaroot), memiliki izin untuk menjalankan sudo dengan pengguna dan grup apa pun.

   1. Jalankan perintah berikut untuk membuka /etc/sudoers file.

      sudo visudo

   2. Verifikasi bahwa izin untuk pengguna terlihat seperti contoh berikut.

      root    ALL=(ALL:ALL) ALL

4. (Opsional) Untuk menjalankan fungsi Lambda kontainer, Anda harus mengaktifkan cgroups v1, dan Anda harus mengaktifkan dan memasang memori dan perangkat cgroups. Jika Anda tidak berencana untuk menjalankan fungsi Lambda kontainer, Anda dapat melewati langkah ini.

   Untuk mengaktifkan opsi cgroups ini, boot perangkat dengan parameter kernel Linux berikut.

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   Untuk informasi tentang melihat dan menyetel parameter kernel untuk perangkat Anda, lihat dokumentasi untuk sistem operasi dan boot loader. Ikuti instruksi untuk mengatur parameter kernel secara permanen.

5. Instal semua dependensi lain yang diperlukan pada perangkat Anda seperti yang ditunjukkan oleh daftar persyaratan di. Persyaratan perangkat

Untuk mengatur perangkat Windows untuk AWS IoT Greengrass V2

1. Instal runtime Java, yang dibutuhkan perangkat lunak AWS IoT Greengrass Core untuk dijalankan. Kami menyarankan Anda menggunakan Amazon Corretto atau JDK Buka versi dukungan jangka panjang. Versi 8 atau lebih tinggi diperlukan.

2. Periksa apakah Java tersedia pada variabel PATHsistem, dan tambahkan jika tidak. LocalSystem Akun menjalankan perangkat lunak AWS IoT Greengrass Core, jadi Anda harus menambahkan Java ke variabel PATH sistem alih-alih variabel PATH pengguna untuk pengguna Anda. Lakukan hal-hal berikut:

   1. Tekan tombol Windows untuk membuka menu mulai.

   2. Ketik environment variables untuk mencari opsi sistem dari menu mulai.

   3. Di hasil pencarian menu mulai, pilih Edit variabel lingkungan sistem untuk membuka jendela Properti sistem.

   4. Pilih variabel Lingkungan... untuk membuka jendela Variabel Lingkungan.

   5. Di bawah Variabel sistem, pilih Path, lalu pilih Edit. Di jendela variabel Edit lingkungan, Anda dapat melihat setiap jalur pada baris terpisah.

   6. Periksa apakah jalur ke bin folder instalasi Java ada. Jalannya mungkin terlihat mirip dengan contoh berikut.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. Jika bin folder instalasi Java hilang dari Path, pilih Baru untuk menambahkannya, lalu pilih OK.

3. Buka Windows Command Prompt (cmd.exe) sebagai administrator.

4. Buat pengguna default di LocalSystem akun di perangkat Windows. Ganti password dengan password yang aman.

   net user /add ggc_user password

   Tip

   Bergantung pada konfigurasi Windows Anda, kata sandi pengguna mungkin diatur untuk kedaluwarsa pada tanggal di masa mendatang. Untuk memastikan aplikasi Greengrass Anda terus beroperasi, lacak kapan kata sandi kedaluwarsa, dan perbarui sebelum kedaluwarsa. Anda juga dapat mengatur kata sandi pengguna agar tidak pernah kedaluwarsa.

   • Untuk memeriksa kapan pengguna dan kata sandinya kedaluwarsa, jalankan perintah berikut.

     net user ggc_user | findstr /C:expires

   • Untuk mengatur kata sandi pengguna agar tidak pernah kedaluwarsa, jalankan perintah berikut.

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • Jika Anda menggunakan Windows 10 atau yang lebih baru di mana wmicperintah tidak digunakan lagi, jalankan perintah berikut. PowerShell

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. Unduh dan instal PsExecutilitas dari Microsoft pada perangkat.

6. Gunakan PsExec utilitas untuk menyimpan nama pengguna dan kata sandi untuk pengguna default dalam contoh Credential Manager untuk LocalSystem akun tersebut. Ganti password dengan kata sandi pengguna yang Anda tetapkan sebelumnya.

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   Jika PsExec License Agreementterbuka, pilih Acceptuntuk menyetujui lisensi dan jalankan perintah.

   catatan

   Pada perangkat Windows, LocalSystem akun menjalankan inti Greengrass, dan Anda harus menggunakan utilitas untuk menyimpan PsExec informasi pengguna default di akun. LocalSystem Menggunakan aplikasi Credential Manager menyimpan informasi ini di akun Windows dari pengguna yang saat ini masuk, bukan LocalSystem akun.

Untuk memberikan AWS kredensi ke perangkat

• Berikan AWS kredensi Anda ke perangkat sehingga penginstal dapat menyediakan AWS IoT dan IAM sumber daya untuk perangkat inti Anda. Untuk meningkatkan keamanan, sebaiknya Anda mendapatkan kredensi sementara untuk IAM peran yang hanya mengizinkan izin minimum yang diperlukan untuk penyediaan. Untuk informasi selengkapnya, lihat Kebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya.

  catatan

  Penginstal tidak menyimpan atau menyimpan kredensial Anda.

  Di perangkat Anda, lakukan salah satu hal berikut untuk mengambil kredensil dan membuatnya tersedia untuk penginstal perangkat lunak AWS IoT Greengrass Core:

  • (Disarankan) Gunakan kredenal temporay dari AWS IAM Identity Center

    1. Berikan ID kunci akses, kunci akses rahasia, dan token sesi dari Pusat IAM Identitas. Untuk informasi selengkapnya, lihat Penyegaran kredenal manual di Mendapatkan dan menyegarkan kredenal sementara di panduan pengguna Pusat IAMIdentitas.

    2. Jalankan perintah berikut untuk memberikan kredensil ke perangkat lunak AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Gunakan kredenal keamanan sementara dari peranIAM:

    1. Berikan ID kunci akses, kunci akses rahasia, dan token sesi dari IAM peran yang Anda asumsikan. Untuk informasi selengkapnya tentang cara mengambil kredenal ini, lihat Meminta kredenal keamanan sementara di Panduan Pengguna. IAM

    2. Jalankan perintah berikut untuk memberikan kredensil ke perangkat lunak AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Gunakan kredensi jangka panjang dari pengguna: IAM

    1. Berikan ID kunci akses dan kunci akses rahasia untuk IAM pengguna Anda. Anda dapat membuat IAM pengguna untuk penyediaan yang kemudian Anda hapus. Untuk IAM kebijakan yang akan diberikan kepada pengguna, lihatKebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya. Untuk informasi selengkapnya tentang cara mengambil kredensi jangka panjang, lihat Mengelola kunci akses untuk IAM pengguna di Panduan Pengguna. IAM

    2. Jalankan perintah berikut untuk memberikan kredensil ke perangkat lunak AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

    3. (Opsional) Jika Anda membuat IAM pengguna untuk menyediakan perangkat Greengrass Anda, hapus pengguna tersebut.

    4. (Opsional) Jika Anda menggunakan ID kunci akses dan kunci akses rahasia dari IAM pengguna yang ada, perbarui kunci untuk pengguna sehingga tidak lagi valid. Untuk informasi selengkapnya, lihat Memperbarui kunci akses di panduan AWS Identity and Access Management pengguna.

Untuk mengunduh perangkat lunak AWS IoT Greengrass Core

1. Di perangkat inti Anda, unduh perangkat lunak AWS IoT Greengrass Core ke file bernamagreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   Dengan mengunduh perangkat lunak ini, Anda menyetujui Perjanjian Lisensi Perangkat Lunak Greengrass Core.

2. (Opsional) Untuk memverifikasi tanda tangan perangkat lunak inti Greengrass

   catatan

   Fitur ini tersedia dengan Greengrass nucleus versi 2.9.5 dan yang lebih baru.

   1. Gunakan perintah berikut untuk memverifikasi tanda tangan artefak inti Greengrass Anda:

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      Nama file mungkin terlihat berbeda tergantung pada JDK versi yang Anda instal. Ganti jdk17.0.6_10 dengan JDK versi yang Anda instal.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      Nama file mungkin terlihat berbeda tergantung pada JDK versi yang Anda instal. Ganti jdk17.0.6_10 dengan JDK versi yang Anda instal.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

   2. jarsignerPemanggilan menghasilkan output yang menunjukkan hasil verifikasi.

      1. Jika file zip inti Greengrass ditandatangani, output berisi pernyataan berikut:

         jar verified.

      2. Jika file zip inti Greengrass tidak ditandatangani, output berisi pernyataan berikut:

         jar is unsigned.

   3. Jika Anda memberikan -certs opsi Jarsigner bersama dengan -verify dan -verbose opsi, output juga menyertakan informasi sertifikat penandatangan terperinci.

3. Buka zip perangkat lunak AWS IoT Greengrass Core ke folder di perangkat Anda. Ganti GreengrassInstaller dengan folder yang ingin Anda gunakan.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

4. (Opsional) Jalankan perintah berikut untuk melihat versi perangkat lunak AWS IoT Greengrass Core.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Untuk menginstal perangkat lunak AWS IoT Greengrass Core

1. Jalankan penginstal AWS IoT Greengrass Core. Ganti nilai argumen dalam perintah Anda sebagai berikut.

   catatan

   Windows memiliki batasan panjang jalur 260 karakter. Jika Anda menggunakan Windows, gunakan folder root seperti C:\greengrass\v2 atau D:\greengrass\v2 untuk menjaga jalur komponen Greengrass di bawah batas 260 karakter.

   1. /greengrass/v2 atau C:\greengrass\v2: Jalur ke folder root yang akan digunakan untuk menginstal perangkat lunak AWS IoT Greengrass Core.

   2. GreengrassInstaller. Jalur ke folder tempat Anda membongkar penginstal perangkat lunak AWS IoT Greengrass Core.

   3. region. Wilayah AWS Di mana untuk menemukan atau membuat sumber daya.

   4. MyGreengrassCore. Nama AWS IoT benda untuk perangkat inti Greengrass Anda. Jika objek tidak ada, installer akan membuatnya. Pemasang mengunduh sertifikat untuk diautentikasi sebagai masalahnya. AWS IoT Untuk informasi selengkapnya, lihat Autentikasi dan otorisasi perangkat untuk AWS IoT Greengrass.

      catatan

      Nama objek tidak dapat berisi karakter titik dua (:).

   5. MyGreengrassCoreGroup. Nama grup AWS IoT benda untuk perangkat inti Greengrass Anda. Jika grup objek tidak ada, installer akan membuatnya dan menambahkan objek padanya. Jika grup objek ada dan memiliki deployment yang aktif, perangkat inti akan men-download dan menjalankan perangkat lunak yang ditetapkan oleh deployment.

      catatan

      Nama grup objek tidak dapat berisi karakter titik dua (:).

   6. GreengrassV2IoTThingPolicy. Nama AWS IoT kebijakan yang memungkinkan perangkat inti Greengrass untuk berkomunikasi dengan dan. AWS IoT AWS IoT Greengrass Jika AWS IoT kebijakan tidak ada, penginstal akan membuat AWS IoT kebijakan permisif dengan nama ini. Anda dapat membatasi izin kebijakan ini untuk kasus penggunaan Anda. Untuk informasi selengkapnya, lihat Kebijakan AWS IoT minimal untuk perangkat inti AWS IoT Greengrass V2.

   7. GreengrassV2TokenExchangeRole. Nama IAM peran yang memungkinkan perangkat inti Greengrass mendapatkan kredenal sementara. AWS Jika peran itu tidak ada, penginstal akan membuatnya dan membuat serta melampirkan kebijakan bernama GreengrassV2TokenExchangeRoleAccess. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

   8. GreengrassCoreTokenExchangeRoleAlias. Alias untuk IAM peran yang memungkinkan perangkat inti Greengrass untuk mendapatkan kredensi sementara nanti. Jika alias peran tidak ada, penginstal membuatnya dan mengarahkannya ke IAM peran yang Anda tentukan. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --aws-region region ^
     --thing-name MyGreengrassCore ^
     --thing-group-name MyGreengrassCoreGroup ^
     --thing-policy-name GreengrassV2IoTThingPolicy ^
     --tes-role-name GreengrassV2TokenExchangeRole ^
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
     --component-default-user ggc_user ^
     --provision true ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --aws-region region `
     --thing-name MyGreengrassCore `
     --thing-group-name MyGreengrassCoreGroup `
     --thing-policy-name GreengrassV2IoTThingPolicy `
     --tes-role-name GreengrassV2TokenExchangeRole `
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
     --component-default-user ggc_user `
     --provision true `
     --setup-system-service true

   penting

   Pada perangkat inti Windows, Anda harus menentukan --setup-system-service true untuk mengatur perangkat lunak AWS IoT Greengrass inti sebagai layanan sistem.

   Installer mencetak pesan berikut jika berhasil:

   • Jika Anda menentukan --provision, penginstal akan mencetak Successfully configured Nucleus with provisioned resource details jika berhasil mengonfigurasi sumber daya.

   • Jika Anda menentukan --deploy-dev-tools, penginstal akan mencetak Configured Nucleus to deploy aws.greengrass.Cli component jika berhasil membuat deployment.

   • Jika Anda menentukan --setup-system-service true, penginstal akan mencetak Successfully set up Nucleus as a system service jika ia mengatur dan menjalankan perangkat lunak sebagai layanan.

   • Jika Anda tidak menentukan --setup-system-service true, penginstal akan mencetak Launched Nucleus successfully jika berhasil dan menjalankan perangkat lunak.

2. Lewati langkah ini jika Anda menginstal v2.0.4 Inti Greengrass atau yang lebih baru. Jika Anda mengunduh versi terbaru dari perangkat lunak, Anda menginstal v2.0.4 atau yang lebih baru.

   Jalankan perintah berikut untuk mengatur izin file yang diperlukan untuk folder root perangkat lunak AWS IoT Greengrass Core Anda. Ganti /greengrass/v2 dengan folder root yang Anda tentukan dalam perintah instalasi Anda, dan ganti /greengrass dengan folder induk untuk folder root Anda.

   sudo chmod 755 /greengrass/v2 && sudo chmod 755 /greengrass