View a markdown version of this page

Menginstal AWS IoT Greengrass Perangkat lunak inti dengan AWS IoT penyediaan armada - AWS IoT Greengrass

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

Menginstal AWS IoT Greengrass Perangkat lunak inti dengan AWS IoT penyediaan armada

Fitur ini tersedia untuk v2.4.0 dan yang lebih baru Komponen inti Greengrass.

Dengan AWS IoT penyediaan armada, Anda dapat mengonfigurasi AWS IoT untuk menghasilkan dan mengirimkan dengan aman X.509 sertifikat perangkat dan kunci pribadi ke perangkat Anda saat terhubung ke AWS IoT untuk pertama kalinya. AWS IoT menyediakan sertifikat klien yang ditandatangani oleh otoritas sertifikat Root Amazon (CA). Anda juga dapat mengkonfigurasi AWS IoT untuk menentukan grup benda, jenis benda, dan izin untuk perangkat inti Greengrass yang Anda sediakan dengan penyediaan armada. Anda mendefinisikan a templat penyediaan untuk mendefinisikan bagaimana AWS IoT menyediakan setiap perangkat. Template penyediaan menentukan item, kebijakan, dan sumber daya sertifikat yang akan dibuat untuk perangkat saat penyediaan. Untuk informasi lebih lanjut, lihat Templat penyediaan di AWS IoT Core Panduan Pengembang.

AWS IoT Greengrass menyediakan AWS IoT plugin penyediaan armada yang dapat Anda gunakan untuk menginstal AWS IoT Greengrass Perangkat lunak inti menggunakan AWS sumber daya yang dibuat oleh AWS IoT penyediaan armada. Plugin penyediaan armada menggunakan penyediaan dengan klaim. Perangkat menggunakan sertifikat klaim penyediaan dan kunci pribadi untuk mendapatkan unik X.509 sertifikat perangkat dan kunci pribadi yang dapat mereka gunakan untuk operasi reguler. Anda dapat menyematkan sertifikat klaim dan kunci pribadi di setiap perangkat selama pembuatan, sehingga pelanggan Anda dapat mengaktifkan perangkat nanti saat setiap perangkat online. Anda dapat menggunakan sertifikat klaim dan kunci pribadi yang sama untuk beberapa perangkat. Untuk informasi lebih lanjut, lihat Penyediaan dengan klaim di AWS IoT Core Panduan Pengembang.

catatan

Plugin penyediaan armada untuk Inti greengrass saat ini tidak mendukung penyimpanan file kunci pribadi dan sertifikat dalam modul keamanan perangkat keras (HSM). Untuk menggunakan HSM dengan Inti greengrass, instal AWS IoT Greengrass Perangkat lunak inti dengan penyediaan manual. Greengrass nukleus lite v2.5.0 dan yang lebih baru mendukung TPM dengan penyediaan armada secara native.

Untuk menginstal AWS IoT Greengrass Perangkat lunak inti dengan AWS IoT penyediaan armada, Anda harus mengatur sumber daya di Akun AWS itu AWS IoT digunakan untuk menyediakan perangkat inti Greengrass. Sumber daya ini mencakup templat penyediaan, sertifikat klaim, dan Peran IAM pertukaran token. Setelah membuat sumber daya ini, Anda dapat menggunakannya kembali untuk menyediakan beberapa perangkat inti dalam armada. Untuk informasi selengkapnya, lihat Siapkan penyediaan AWS IoT armada untuk perangkat inti Greengrass.

penting

Sebelum Anda mengunduh AWS IoT Greengrass Perangkat lunak inti, periksa apakah perangkat inti Anda memenuhi persyaratan untuk menginstal dan menjalankan AWS IoT Greengrass Perangkat lunak inti v2.0.

Prasyarat

Untuk menginstal AWS IoT Greengrass Perangkat lunak inti dengan AWS IoT penyediaan armada, Anda harus terlebih dahulu mengatur AWS IoT penyediaan armada untuk perangkat inti Greengrass. Setelah Anda menyelesaikan langkah-langkah ini sekali, Anda dapat menggunakan penyediaan armada untuk menginstal AWS IoT Greengrass Perangkat lunak inti pada sejumlah perangkat.

Mengambil AWS IoT titik akhir

Dapatkan AWS IoT titik akhir untuk Anda Akun AWS, dan simpan untuk digunakan nanti. Perangkat Anda menggunakan titik akhir ini untuk tersambung ke AWS IoT. Lakukan hal-hal berikut:

  1. Dapatkan AWS IoT titik akhir data untuk Anda Akun AWS.

    aws iot describe-endpoint --endpoint-type iot:Data-ATS

    Respons tersebut serupa dengan contoh berikut ini, jika permintaannya berhasil.

    { "endpointAddress": "device-data-prefix-ats.iot.us-west-2.amazonaws.com" }
  2. Dapatkan AWS IoT titik akhir kredensional untuk Anda Akun AWS.

    aws iot describe-endpoint --endpoint-type iot:CredentialProvider

    Respons tersebut serupa dengan contoh berikut ini, jika permintaannya berhasil.

    { "endpointAddress": "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" }

Unduh sertifikat ke perangkat

Perangkat menggunakan sertifikat klaim dan kunci pribadi untuk mengotentikasi permintaannya untuk penyediaan AWS sumber daya dan memperoleh X.509 sertifikat perangkat. Anda dapat menyematkan sertifikat klaim dan kunci pribadi ke perangkat selama pembuatan, atau menyalin sertifikat dan kunci ke perangkat selama instalasi. Di bagian ini, Anda menyalin sertifikat klaim dan kunci pribadi ke perangkat. Anda juga mengunduh sertifikat otoritas sertifikat (CA) Amazon Root ke perangkat.

penting

Kunci pribadi klaim penyediaan harus diamankan setiap saat, termasuk pada perangkat inti Greengrass. Kami menyarankan Anda menggunakan Amazon CloudWatch metrik dan log untuk memantau indikasi penyalahgunaan, seperti penggunaan sertifikat klaim yang tidak sah untuk menyediakan perangkat. Jika Anda mendeteksi penyalahgunaan, nonaktifkan sertifikat klaim penyediaan sehingga tidak dapat digunakan untuk penyediaan perangkat. Untuk informasi lebih lanjut, lihat Pemantauan AWS IoT di AWS IoT Core Panduan Pengembang.

Untuk membantu Anda mengelola jumlah perangkat dengan lebih baik, dan perangkat mana, yang mendaftarkan diri di perangkat Anda Akun AWS, Anda dapat menentukan hook pra-penyediaan saat membuat template penyediaan armada. Pengait pra-penyediaan adalah AWS Lambda fungsi yang memvalidasi parameter template yang disediakan perangkat selama pendaftaran. Misalnya, Anda dapat membuat hook pra-penyediaan yang memeriksa ID perangkat terhadap database untuk memverifikasi bahwa perangkat memiliki izin untuk penyediaan. Untuk informasi lebih lanjut, lihat Pre-provisioning kait di AWS IoT Core Panduan Pengembang.

Untuk mengunduh sertifikat klaim ke perangkat
  1. Salin sertifikat klaim dan kunci pribadi ke perangkat. Jika SSH dan SCP diaktifkan pada komputer pengembangan dan perangkat, Anda dapat menggunakan scp perintah pada komputer pengembangan Anda untuk mentransfer sertifikat klaim dan kunci pribadi. Berikut contoh perintah mentransfer file-file ini ke folder bernama claim-certs di komputer pengembangan Anda ke perangkat. Ganti device-ip-address dengan alamat IP perangkat Anda.

    scp -r claim-certs/ device-ip-address:~
  2. Buat folder akar Greengrass pada perangkat tersebut. Anda nantinya akan menginstal AWS IoT Greengrass Perangkat lunak inti ke folder ini.

    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 karakter 260.

    Linux or Unix
    • Ganti /greengrass/v2 dengan folder yang akan digunakan.

    sudo mkdir -p /greengrass/v2
    Windows Command Prompt
    • Ganti C:\greengrass\v2 dengan folder yang akan digunakan.

    mkdir C:\greengrass\v2
    PowerShell
    • Ganti C:\greengrass\v2 dengan folder yang akan digunakan.

    mkdir C:\greengrass\v2
  3. (Hanya Linux) Tetapkan izin induk folder root Greengrass.

    • Ganti /greengrass dengan induk dari folder root.

    sudo chmod 755 /greengrass
  4. Pindahkan sertifikat klaim ke folder root Greengrass.

    • Ganti /greengrass/v2 atau C:\greengrass\v2 dengan folder root Greengrass.

    Linux or Unix
    sudo mv ~/claim-certs /greengrass/v2
    Windows Command Prompt (CMD)
    move %USERPROFILE%\claim-certs C:\greengrass\v2
    PowerShell
    mv -Path ~\claim-certs -Destination C:\greengrass\v2
  5. Unduh sertifikat otoritas sertifikat root Amazon (CA). AWS IoT sertifikat dikaitkan dengan sertifikat CA root Amazon secara default.

    Linux or Unix
    sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
    Windows Command Prompt (CMD)
    curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
    PowerShell
    iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

Siapkan lingkungan perangkat

Ikuti langkah-langkah di bagian ini untuk mengatur perangkat Linux atau Windows untuk digunakan sebagai perangkat Anda AWS IoT Greengrass perangkat inti.

Siapkan perangkat Linux

Cara mengatur perangkat Linux untuk AWS IoT Greengrass V2
  1. Instal runtime Java, yang AWS IoT Greengrass Perangkat lunak inti perlu dijalankan. Kami menyarankan Anda menggunakan Amazon Correct atau OpenJDK versi dukungan jangka panjang. Diperlukan versi 8 atau lebih tinggi. Perintah berikut menunjukkan cara menginstal OpenJDK di perangkat Anda.

    • Untuk Debian-based atau Ubuntu-based distribusi:

      sudo apt install default-jdk
    • Untuk Merah Hat-based distribusi:

      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 di perangkat Linux Anda.

    java -version

    Perintah mencetak versi Java yang berjalan pada perangkat. Misalnya, pada Debian-based distribusi, 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 AWS IoT Greengrass Penginstal perangkat lunak inti membuat pengguna dan grup ini selama instalasi dengan --component-default-user argumen penginstal. Untuk informasi selengkapnya, lihat Argumen penginstal.

    sudo useradd --system --create-home ggc_user sudo groupadd --system ggc_group
  3. Pastikan bahwa pengguna yang menjalankan AWS IoT Greengrass Perangkat lunak inti (biasanya root), memiliki izin untuk menjalankan sudo dengan pengguna dan grup apa pun.

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

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

      root ALL=(ALL:ALL) ALL
  4. (Opsional) Untuk jalankan fungsi Lambda yang dikontainer, Anda harus mengaktifkan cgroup v1, dan Anda harus mengaktifkan dan memasang memori dan pesawat c kelompok. Jika Anda tidak berencana untuk menjalankan fungsi Lambda dalam wadah, 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 Anda. 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.

Menyiapkan perangkat Windows

catatan

Fitur ini tersedia untuk v2.5.0 dan yang lebih baru Komponen inti Greengrass.

Cara mengatur perangkat Windows untuk AWS IoT Greengrass V2
  1. Instal runtime Java, yang AWS IoT Greengrass Perangkat lunak inti perlu dijalankan. Kami menyarankan Anda menggunakan Amazon Correct atau OpenJDK versi dukungan jangka panjang. Diperlukan versi 8 atau lebih tinggi.

  2. Periksa apakah Java tersedia di JALAN variabel sistem, dan tambahkan jika tidak. The LocalSystem akun menjalankan AWS IoT Greengrass Perangkat lunak inti, jadi Anda harus menambahkan Java ke variabel sistem PATH alih-alih variabel pengguna PATH untuk pengguna Anda. Lakukan hal-hal berikut:

    1. Tekan tombol Windows untuk membuka menu mulai.

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

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

    4. Memilih Variabel lingkungan... untuk membuka Variabel Lingkungan jendela.

    5. Di bawah Variabel sistem, pilih Jalur, dan kemudian memilih Sunting. Di Edit variabel lingkungan jendela, Anda dapat melihat setiap jalur pada baris terpisah.

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

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin
    7. Jika instalasi Java bin folder hilang dari Jalur, pilih Baru untuk menambahkannya, dan kemudian memilih BAIK.

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

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

    net user /add ggc_user password
    Tip

    Tergantung pada konfigurasi Windows Anda, kata sandi pengguna mungkin disetel 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 lebih baru di mana wmic perintah tidak digunakan lagi, jalankan yang berikut PowerShell perintah.

      Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}
  5. Unduh dan instal PsExec utilitas dari Microsoft di perangkat.

  6. Gunakan PsExec utilitas untuk menyimpan nama pengguna dan kata sandi untuk pengguna default di instance Credential Manager untuk LocalSystem akun. 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 Agreement buka, pilih Accept untuk menyetujui lisensi dan menjalankan perintah.

    catatan

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

Unduh AWS IoT Greengrass Perangkat lunak inti

Anda dapat mengunduh versi terbaru dari AWS IoT Greengrass Perangkat lunak inti dari lokasi berikut:

catatan

Anda dapat mengunduh versi tertentu dari AWS IoT Greengrass Perangkat lunak inti dari lokasi berikut. Ganti version dengan versi untuk diunduh.

https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-version.zip
Untuk mengunduh AWS IoT Greengrass Perangkat lunak inti
  1. Di perangkat inti Anda, unduh AWS IoT Greengrass Perangkat lunak inti ke file bernama greengrass-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 versi JDK yang Anda instal. Ganti jdk17.0.6_10 dengan versi JDK 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 versi JDK yang Anda instal. Ganti jdk17.0.6_10 dengan versi JDK yang Anda instal.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip
    2. jarsigner pemanggilan 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 Jarsigner -certs pilihan bersama dengan -verify dan -verbose opsi, output juga mencakup informasi sertifikat penandatangan terperinci.

  3. Buka zip AWS IoT Greengrass Perangkat lunak inti 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 AWS IoT Greengrass Perangkat lunak inti.

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

Jika Anda menginstal versi inti Greengrass lebih awal dari v2.4.0, jangan hapus folder ini setelah Anda menginstal AWS IoT Greengrass Perangkat lunak inti. The AWS IoT Greengrass Perangkat lunak inti menggunakan file dalam folder ini untuk dijalankan.

Jika Anda mengunduh versi terbaru perangkat lunak, Anda menginstal v2.4.0 atau yang lebih baru, dan Anda dapat menghapus folder ini setelah Anda menginstal AWS IoT Greengrass Perangkat lunak inti.

Unduh AWS IoT Plugin penyediaan armada

Anda dapat mengunduh versi terbaru AWS IoT plugin penyediaan armada dari lokasi berikut:

catatan

Anda dapat mengunduh versi tertentu dari AWS IoT plugin penyediaan armada dari lokasi berikut. Ganti version dengan versi untuk diunduh. Untuk informasi selengkapnya tentang setiap versi plugin penyediaan armada, lihat AWS IoT changelog plugin penyediaan armada.

https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-version.jar

Plugin penyediaan armada adalah open source. Untuk melihat kode sumbernya, lihat AWS IoT Plugin penyediaan armada di atas GitHub.

Untuk mengunduh AWS IoT Plugin penyediaan armada
  • Di perangkat Anda, unduh AWS IoT plugin penyediaan armada ke file bernama aws.greengrass.FleetProvisioningByClaim.jar. Ganti GreengrassInstaller dengan folder yang ingin Anda gunakan.

    Linux or Unix
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar
    Windows Command Prompt (CMD)
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar
    PowerShell
    iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar -OutFile GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

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

Instal AWS IoT Greengrass Perangkat lunak inti

Jalankan penginstal dengan argumen yang menentukan tindakan berikut:

  • Instal dari file konfigurasi parSIAL yang menentukan untuk menggunakan plugin penyediaan armada untuk penyediaan AWS sumber daya. The AWS IoT Greengrass Perangkat lunak inti menggunakan file konfigurasi yang menentukan konfigurasi setiap komponen Greengrass pada perangkat. Penginstal membuat file konfigurasi lengkap dari file konfigurasi parSIAL yang Anda berikan dan AWS sumber daya yang dibuat oleh plugin penyediaan armada.

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

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

    penting

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

Untuk informasi lebih lanjut tentang argumen yang dapat Anda tentukan, lihat Argumen penginstal.

catatan

Jika Anda berlari AWS IoT Greengrass pada perangkat dengan memori terbatas, Anda dapat mengontrol jumlah memori yang AWS IoT Greengrass Penggunaan perangkat lunak inti. 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.

Untuk menginstal AWS IoT Greengrass Perangkat lunak inti
  1. Periksa versi AWS IoT Greengrass Perangkat lunak inti.

    • Ganti GreengrassInstaller dengan jalur ke folder yang berisi perangkat lunak.

    java -jar ./GreengrassInstaller/lib/Greengrass.jar --version
  2. Gunakan editor teks untuk membuat file konfigurasi bernama config.yaml yang akan disediakan ke penginstal.

    Misalnya, pada Linux-based sistem, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuat file.

    nano GreengrassInstaller/config.yaml

    Salin konten YAML berikut ke dalam file. File konfigurasi parSIAL ini menentukan parameter untuk plugin penyediaan armada. Untuk informasi selengkapnya tentang opsi yang dapat Anda tentukan, lihat Konfigurasikan AWS IoT plugin penyediaan armada.

    Linux or Unix
    --- services: aws.greengrass.Nucleus: version: "2.18.4" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "/greengrass/v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt" claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key" rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup"
    Windows
    --- services: aws.greengrass.Nucleus: version: "2.18.4" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "C:\\greengrass\\v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt" claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key" rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup"

    Kemudian, lakukan hal berikut:

    • Ganti 2.18.4 dengan versi AWS IoT Greengrass Perangkat lunak inti.

    • Ganti setiap contoh /greengrass/v2 atau C:\greengrass\v2 dengan folder root Greengrass.

      catatan

      Pada perangkat Windows, Anda harus menentukan pemisah jalur sebagai garis miring terbalik ganda (\\), seperti C:\\greengrass\\v2.

    • Ganti us-west-2 dengan AWS Wilayah tempat Anda membuat template penyediaan dan sumber daya lainnya.

    • Ganti iotDataEndpoint dengan milikmu AWS IoT titik akhir data.

    • Ganti iotCredentialEndpoint dengan milikmu AWS IoT titik akhir kredenSIAL.

    • Ganti GreengrassCoreTokenExchangeRoleAlias dengan nama alias peran pertukaran token.

    • Ganti GreengrassFleetProvisioningTemplate dengan nama template penyediaan armada.

    • Ganti claimCertificatePath dengan jalur ke sertifikat klaim pada perangkat.

    • Ganti claimCertificatePrivateKeyPath dengan jalur ke kunci pribadi sertifikat klaim pada perangkat.

    • Ganti parameter template (templateParameters) dengan nilai yang digunakan untuk menyediakan perangkat. Contoh ini mengacu pada contoh template yang mendefinisikan ThingName dan ThingGroupName parameter.

    catatan

    Dalam file konfigurasi ini, Anda dapat menyesuaikan opsi konfigurasi lain seperti port dan proxy jaringan untuk digunakan, seperti yang ditunjukkan pada contoh berikut. Untuk informasi selengkapnya, lihat konfigurasi nukleus Greengrass.

    Linux or Unix
    --- services: aws.greengrass.Nucleus: version: "2.18.4" configuration: mqtt: port: 443 greengrassDataPlanePort: 443 networkProxy: noProxyAddresses: "http://192.168.0.1,www.example.com" proxy: url: "http://my-proxy-server:1100" username: "Mary_Major" password: "pass@word1357" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "/greengrass/v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt" claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key" rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup" mqttPort: 443 proxyUrl: "http://my-proxy-server:1100" proxyUserName: "Mary_Major" proxyPassword: "pass@word1357"
    Windows
    --- services: aws.greengrass.Nucleus: version: "2.18.4" configuration: mqtt: port: 443 greengrassDataPlanePort: 443 networkProxy: noProxyAddresses: "http://192.168.0.1,www.example.com" proxy: url: "http://my-proxy-server:1100" username: "Mary_Major" password: "pass@word1357" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "C:\\greengrass\\v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt" claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key" rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup" mqttPort: 443 proxyUrl: "http://my-proxy-server:1100" proxyUserName: "Mary_Major" proxyPassword: "pass@word1357"

    Untuk menggunakan proxy HTTPS, Anda harus menggunakan plugin penyediaan armada versi 1.1.0 atau yang lebih baru. Anda juga harus menentukan rootCaPath di bawah system, seperti yang ditunjukkan pada contoh berikut.

    Linux or Unix
    --- system: rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" services: ...
    Windows
    --- system: rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" services: ...
  3. Jalankan pemasang. Tentukan --trusted-plugin untuk menyediakan plugin penyediaan armada, dan menentukan --init-config untuk menyediakan file konfigurasi.

    • Ganti /greengrass/v2 dengan folder root Greengrass.

    • Ganti setiap contoh GreengrassInstaller dengan folder tempat Anda membongkar penginstal.

    Linux or Unix
    sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \ -jar ./GreengrassInstaller/lib/Greengrass.jar \ --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \ --init-config ./GreengrassInstaller/config.yaml \ --component-default-user ggc_user:ggc_group \ --setup-system-service true
    Windows Command Prompt (CMD)
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^ -jar ./GreengrassInstaller/lib/Greengrass.jar ^ --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ^ --init-config ./GreengrassInstaller/config.yaml ^ --component-default-user ggc_user ^ --setup-system-service true
    PowerShell
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ` -jar ./GreengrassInstaller/lib/Greengrass.jar ` --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ` --init-config ./GreengrassInstaller/config.yaml ` --component-default-user ggc_user ` --setup-system-service true
    penting

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

    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 tidak, installer tersebut tidak akan menghasilkan pesan apa pun jika ia berhasil menginstal perangkat lunak tersebut.

    catatan

    Anda tidak dapat menggunakan argumen deploy-dev-tools untuk men-deploy alat pengembangan lokal ketika Anda menjalankan penginstal tersebut tanpa argumen --provision true. Untuk informasi tentang cara men-deploy Greengrass CLI secara langsung pada perangkat Anda, lihat Antarmuka Baris Perintah Greengrass.

  4. Verifikasi instalasi dengan melihat file di folder root.

    Linux or Unix
    ls /greengrass/v2
    Windows Command Prompt (CMD)
    dir C:\greengrass\v2
    PowerShell
    ls C:\greengrass\v2

    Jika penginstalan berhasil, folder akar berisi beberapa folder, seperti config, packages, dan logs.

Jika Anda menginstal AWS IoT Greengrass Perangkat lunak inti sebagai layanan sistem, installer menjalankan perangkat lunak untuk Anda. Jika tidak, Anda harus menjalankan perangkat lunak itu secara manual. Untuk informasi selengkapnya, lihat Jalankan perangkat lunak AWS IoT Greengrass Core.

Untuk informasi lebih lanjut tentang cara mengkonfigurasi dan menggunakan perangkat lunak dan AWS IoT Greengrass, lihat yang berikut ini: