Instal perangkat lunak AWS IoT Greengrass inti (CLI) - AWS IoT Greengrass

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

Instal perangkat lunak AWS IoT Greengrass inti (CLI)

Untuk menginstal dan mengonfigurasi perangkat lunak inti AWS IoT Greengrass

  1. Pada perangkat inti Greengrass Anda, jalankan perintah berikut untuk beralih ke direktori home.

    Linux or Unix
    cd ~
    Windows Command Prompt (CMD)
    cd %USERPROFILE%
    PowerShell
    cd ~

  2. 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.

  3. Unzip perangkat lunak inti AWS IoT Greengrass ke folder di perangkat Anda. Ganti GreengrassInstallerdengan 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. Jalankan perintah berikut untuk meluncurkan penginstal perangkat lunak inti AWS IoT Greengrass. Perintah ini melakukan hal berikut:

    • Buat sumber daya AWS yang dibutuhkan perangkat inti untuk beroperasi.

    • Siapkan perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem yang berjalan saat boot. Pada perangkat Linux, ini membutuhkan sistem init Systemd.

      penting

      Pada perangkat inti Windows, Anda harus mengatur perangkat lunak AWS IoT Greengrass inti sebagai layanan sistem.

    • Terapkan komponen AWS IoT GreengrassCLI, yang merupakan alat baris perintah yang memungkinkan Anda mengembangkan komponen Greengrass khusus pada perangkat inti.

    • Tentukan untuk menggunakan pengguna ggc_user sistem untuk menjalankan komponen perangkat lunak pada perangkat inti. Pada perangkat Linux, perintah ini juga menentukan untuk menggunakan grup ggc_group sistem, dan penginstal membuat pengguna dan grup sistem untuk Anda.

    Ganti nilai argumen dalam perintah Anda sebagai berikut.

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

    2. GreengrassInstaller. Path ke folder tempat Anda membongkar penginstal perangkat lunak inti AWS IoT Greengrass.

    3. region. Wilayah AWS tempat untuk menemukan atau membuat sumber daya.

    4. MyGreengrassCore. Nama objek AWS IoT untuk perangkat inti Greengrass Anda. Jika objek tidak ada, installer akan membuatnya. Penginstal mengunduh sertifikat tersebut untuk diautentikasi sebagai objek 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 objek AWS IoT 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. ThingPolicyGreenGrassV2IoT. 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. GreenGrassV2 TokenExchangeRole. Nama IAM role yang memungkinkan perangkat inti Greengrass untuk mendapatkan kredensial AWS sementara. 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. Nama IAM role yang memungkinkan perangkat inti Greengrass untuk mendapatkan kredensial sementara nanti. Jika alias peran tidak ada, penginstal akan membuatnya dan mengarahkannya ke IAM role 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 \
  --deploy-dev-tools 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 ^
  --deploy-dev-tools 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 `
  --deploy-dev-tools true
    catatan

    Jika Anda menjalankan AWS IoT Greengrass pada perangkat dengan memori terbatas, Anda dapat mengendalikan jumlah memori yang digunakan oleh perangkat lunak inti AWS IoT Greengrass. Untuk mengontrol alokasi memori, Anda dapat mengatur pilihan ukuran tumpukan JVM di konfigurasi parameter jvmOptions dalam komponen nukleus anda. Untuk informasi selengkapnya, lihat Kontrol alokasi memori dengan opsi JVM.

    Ketika Anda menjalankan perintah ini, Anda akan melihat pesan berikut untuk menunjukkan bahwa installer berhasil.

    Successfully configured Nucleus with provisioned resource details!
Configured Nucleus to deploy aws.greengrass.Cli component
Successfully set up Nucleus as a system service
    catatan

    Jika Anda memiliki perangkat Linux dan tidak memiliki systemd, penginstal tidak akan mengatur perangkat lunak sebagai layanan sistem, dan Anda tidak akan melihat pesan sukses untuk menyiapkan inti sebagai layanan sistem.