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

Konfigurasikan perangkat lunak inti AWS IoT Greengrass

Perangkat lunak inti AWS IoT Greengrass menyediakan opsi yang dapat Anda gunakan untuk mengonfigurasi perangkat lunak. Anda dapat membuat deployment untuk mengonfigurasi perangkat lunak inti AWS IoT Greengrass pada setiap perangkat inti.

Deploy komponen nukleus Greengrass s

AWS IoT Greengrass menyediakan perangkat lunak inti AWS IoT Greengrass sebagai komponen yang dapat Anda deploy ke perangkat inti Greengrass Anda. Anda dapat membuat deployment untuk menerapkan konfigurasi yang sama untuk beberapa perangkat inti Greengrass. Untuk informasi selengkapnya, lihat Inti Greengrass dan Perbarui perangkat lunak inti AWS IoT Greengrass (OTA).

Konfigurasikan nukleus Greengrass sebagai layanan sistem

Anda harus mengonfigurasi perangkat lunakAWS IoT Greengrass inti sebagai layanan sistem dalam sistem init perangkat Anda untuk melakukan hal berikut:

Konfigurasikan nukleus sebagai layanan sistem (Linux)

Perangkat Linux mendukung sistem init yang berbeda, seperti initd, systemd, dan SystemV. Anda menggunakan--setup-system-service true argumen ketika Anda menginstal perangkat lunakAWS IoT Greengrass inti untuk memulai nukleus sebagai layanan sistem dan mengonfigurasinya untuk dimulai ketika perangkat melakukan boot. Installer mengonfigurasi perangkat lunakAWS IoT Greengrass inti sebagai layanan sistem dengan systemd.

Anda juga dapat mengkonfigurasi nukleus secara manual untuk dijalankan sebagai layanan sistem. Contoh berikut adalah file layanan untuk systemd.

[Unit]
Description=Greengrass Core

[Service]
Type=simple
PIDFile=/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader

[Install]
WantedBy=multi-user.target

Setelah Anda mengonfigurasi layanan sistem, Anda dapat menjalankan perintah berikut untuk mengonfigurasi permulaan perangkat pada boot dan untuk memulai atau menghentikan perangkat lunakAWS IoT Greengrass inti.

Konfigurasikan nukleus sebagai layanan sistem (Windows)

Anda menggunakan--setup-system-service true argumen ketika Anda menginstal perangkat lunakAWS IoT Greengrass inti untuk memulai nukleus sebagai layanan Windows dan mengonfigurasinya untuk dimulai ketika perangkat melakukan boot.

Setelah mengonfigurasi layanan, Anda dapat menjalankan perintah berikut untuk mengonfigurasi permulaan perangkat pada boot dan untuk memulai atau menghentikan perangkat lunakAWS IoT Greengrass inti. Anda harus menjalankan Command Prompt atau PowerShell sebagai administrator untuk menjalankan perintah ini.

Windows Command Prompt (CMD)

• Untuk memeriksa status layanan

  sc query "greengrass"

• Untuk mengaktifkan nukleus untuk dimulai saat perangkat melakukan boot.

  sc config "greengrass" start=auto

• Untuk menghentikan nukleus agar tidak dimulai saat perangkat melakukan boot.

  sc config "greengrass" start=disabled

• Untuk memulai perangkat lunakAWS IoT Greengrass inti.

  sc start "greengrass"

• Untuk menghentikan perangkat lunakAWS IoT Greengrass Core.

  sc stop "greengrass"

  catatan

  Pada perangkat Windows, perangkat lunakAWS IoT Greengrass Core mengabaikan sinyal shutdown ini saat mematikan proses komponen Greengrass. Jika perangkat lunakAWS IoT Greengrass Core mengabaikan sinyal shutdown saat Anda menjalankan perintah ini, tunggu beberapa detik, dan coba lagi.

PowerShell

• Untuk memeriksa status layanan

  Get-Service -Name "greengrass"

• Untuk mengaktifkan nukleus untuk dimulai saat perangkat melakukan boot.

  Set-Service -Name "greengrass" -Status stopped -StartupType automatic

• Untuk menghentikan nukleus agar tidak dimulai saat perangkat melakukan boot.

  Set-Service -Name "greengrass" -Status stopped -StartupType disabled

• Untuk memulai perangkat lunakAWS IoT Greengrass inti.

  Start-Service -Name "greengrass"

• Untuk menghentikan perangkat lunakAWS IoT Greengrass Core.

  Stop-Service -Name "greengrass"

  catatan

  Pada perangkat Windows, perangkat lunakAWS IoT Greengrass Core mengabaikan sinyal shutdown ini saat mematikan proses komponen Greengrass. Jika perangkat lunakAWS IoT Greengrass Core mengabaikan sinyal shutdown saat Anda menjalankan perintah ini, tunggu beberapa detik, dan coba lagi.

Kontrol alokasi memori dengan opsi JVM

Jika Anda menjalankan AWS IoT Greengrass pada perangkat dengan memori terbatas, Anda dapat menggunakan opsi mesin virtual Java (JVM) untuk mengontrol ukuran tumpukan maksimum, mode pengumpulan sampah, dan opsi compiler, yang mengontrol jumlah memori yang digunakan oleh perangkat lunak inti AWS IoT Greengrass. Ukuran tumpukan di JVM menentukan berapa banyak memori yang dapat digunakan aplikasi sebelum pengumpulan sampah terjadi, atau sebelum aplikasi kehabisan memori. Ukuran tumpukan maksimum menentukan jumlah maksimum memori yang dapat dialokasikan oleh JVM ketika memperluas tumpukan selama aktivitas yang berat.

Untuk mengontrol alokasi memori, buat deployment baru atau revisi deployment yang ada yang mencakup komponen inti, dan tentukan opsi JVM Anda di parameter konfigurasi jvmOptions dalam konfigurasi komponen inti.

Tergantung pada kebutuhan Anda, Anda dapat menjalankan perangkat lunak inti AWS IoT Greengrass dengan alokasi memori yang berkurang atau dengan alokasi memori minimum.

Alokasi memori yang berkurang

Untuk menjalankan perangkat lunak inti AWS IoT Greengrass dengan alokasi memori yang berkurang, kami sarankan Anda menggunakan pembaruan penggabungan konfigurasi contoh berikut untuk mengatur opsi JVM dalam konfigurasi inti Anda:

{
  "jvmOptions": "-Xmx64m -XX:+UseSerialGC -XX:TieredStopAtLevel=1"
}

Alokasi memori minimum

Untuk menjalankan perangkat lunak inti AWS IoT Greengrass dengan alokasi memori minimum, kami sarankan Anda menggunakan pembaruan penggabungan konfigurasi contoh berikut untuk mengatur opsi JVM dalam konfigurasi inti Anda:

{
  "jvmOptions": "-Xmx32m -XX:+UseSerialGC -Xint"
}

Konfigurasi ini menggabungkan pembaruan dengan menggunakan opsi JVM berikut:

Untuk informasi tentang pembuatan pembaruan penggabungan konfigurasi, lihat Perbarui konfigurasi komponen.

Mengkonfigurasi pengguna yang menjalankan komponen

Perangkat lunak inti AWS IoT Greengrass dapat menjalankan proses komponen sebagai pengguna dan grup sistem yang berbeda dari komponen yang menjalankan perangkat lunak tersebut. Hal ini akan meningkatkan keamanan, karena Anda dapat menjalankan perangkat lunakAWS IoT Greengrass inti sebagai root, atau sebagai pengguna administrator, tanpa memberikan izin untuk komponen yang berjalan pada perangkat inti.

Tabel berikut menunjukkan jenis komponen yang dapat dijalankan oleh perangkat lunakAWS IoT Greengrass inti sebagai pengguna yang Anda tentukan. Untuk informasi selengkapnya, lihat Jenis komponen.

Anda harus membuat pengguna komponen sebelum Anda dapat menentukannya dalam konfigurasi penyebaran. Pada perangkat berbasis Windows, Anda juga harus menyimpan nama pengguna dan kata sandi untuk pengguna di instance pengelola kredensi LocalSystem akun. Untuk informasi selengkapnya, lihat Menyiapkan pengguna komponen di perangkat Windows.

Saat mengonfigurasi pengguna komponen pada perangkat berbasis Linux, Anda juga dapat menentukan grup secara opsional. Anda menentukan pengguna dan grup yang dipisahkan dengan titik dua (:) dalam format berikut:user:group. Jika Anda tidak menentukan grup, perangkat lunak inti AWS IoT Greengrass akan default ke grup utama pengguna. Anda dapat menggunakan nama atau ID untuk mengidentifikasi pengguna dan grup.

Pada perangkat berbasis Linux, Anda juga dapat menjalankan komponen sebagai pengguna sistem yang tidak ada, yang juga disebut sebagai pengguna yang tidak dikenal, untuk meningkatkan keamanan. Proses Linux dapat memberi sinyal ke setiap proses lain yang dijalankan oleh pengguna yang sama. Pengguna yang tidak dikenal tidak menjalankan proses yang lain, sehingga Anda dapat menjalankan komponen sebagai pengguna yang tidak dikenal untuk mencegah komponen memberi sinyal ke komponen lain pada perangkat inti. Untuk menjalankan komponen sebagai pengguna yang tidak dikenal, tentukan ID pengguna yang tidak ada pada perangkat inti. Anda juga dapat menentukan ID grup yang tidak ada untuk dijalankan sebagai grup yang tidak dikenal.

Anda dapat mengonfigurasi pengguna untuk setiap komponen dan untuk setiap perangkat inti.

Menyiapkan pengguna komponen di perangkat Windows

Konfigurasikan default komponen pengguna komponen

Anda dapat menggunakan deployment untuk mengonfigurasi pengguna default pada perangkat inti. Dalam deployment ini, Anda akan memperbarui konfigurasi komponen inti.

Buat penyebaran yang menentukan pembaruan konfigurasi berikut untukaws.greengrass.Nucleus komponen.

Linux

{
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Windows

{
  "runWithDefault": {
    "windowsUser": "ggc_user"
  }
}

catatan

Pengguna yang Anda tentukan harus ada, dan nama pengguna dan kata sandi untuk pengguna ini harus disimpan dalam instance pengelola kredensi LocalSystem akun di perangkat Windows Anda. Untuk informasi selengkapnya, lihat Menyiapkan pengguna komponen di perangkat Windows.

Contoh berikut menentukan deployment untuk perangkat berbasis Linux yang mengonfigurasiggc_user sebagai pengguna default danggc_group sebagai grup default. Pembaruan konfigurasi merge memerlukan objek JSON berserial.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.9.4",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"posixUser\":\"ggc_user:ggc_group\"}}"
      }
    }
  }
}

Mengkonfigurasi batas sumber daya sistem untuk komponen

Anda dapat mengonfigurasi jumlah maksimum penggunaan CPU dan RAM yang dapat digunakan setiap proses komponen pada perangkat inti.

Tabel berikut menunjukkan jenis daya sistem daya sistem daya sistem daya sistem daya sistem daya sistem daya sistem. Untuk informasi selengkapnya, lihat Jenis komponen.

Anda dapat mengonfigurasi batas sumber daya sistem daya sistem daya sistem untuk setiap komponen dan untuk setiap perangkat inti.

Mengkonfigurasi batas sumber daya sistem default

Anda dapat menerapkan komponen inti Greengrass untuk mengonfigurasi batas sumber daya sistem default untuk perangkat inti. Untuk mengonfigurasi batas sumber daya sistem default, buat deployment yang menentukan pembaruan konfigurasi berikut untukaws.greengrass.Nucleus komponen tersebut.

{
  "runWithDefault": {
    "systemResourceLimits": {
      "cpu": cpuTimeLimit,
      "memory": memoryLimitInKb
    }
  }
}

Contoh berikut mendefinisikan penerapan yang mengonfigurasi batas waktu CPU2, yang setara dengan penggunaan 50% pada perangkat dengan 4 inti CPU. Contoh ini juga mengkonfigurasi penggunaan memori untuk 100 MB.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.9.4",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"systemResourceLimits\":\"cpu\":2,\"memory\":102400}}}"
      }
    }
  }
}

Hubungkan pada port 443 atau melalui proksi jaringan

Perangkat inti AWS IoT Greengrass berkomunikasi dengan AWS IoT Core menggunakan protokol olahpesan MQTT dengan autentikasi klien TLS. Menurut konvensi, MQTT atas TLS menggunakan port 8883. Namun, sebagai upaya keamanan, lingkungan yang terbatas mungkin akan membatasi lalu lintas masuk dan keluar untuk kisaran kecil port TCP. Sebagai contoh, firewall perusahaan mungkin akan membuka port 443 untuk lalu lintas HTTPS, tetapi menutup port lain yang digunakan untuk protokol yang kurang umum, seperti port 8883 untuk lalu lintas MQTT. Lingkungan terbatas lainnya mungkin mengharuskan semua lalu lintas melalui proksi sebelum terhubung ke internet.

Untuk mengaktifkan komunikasi dalam skenario ini, AWS IoT Greengrass menyediakan opsi konfigurasi berikut:

Konfigurasikan MQTT melalui port 443

Anda dapat mengkonfigurasi MQTT melalui port 443 pada perangkat inti yang ada atau ketika Anda menginstal perangkat lunakAWS IoT Greengrass Core pada perangkat inti baru.

Konfigurasikan MQTT melalui port 443 pada perangkat inti yang ada

Anda dapat menggunakan deployment untuk mengonfigurasi MQTT melalui port 443 pada perangkat inti tunggal atau sekelompok perangkat inti. Dalam deployment ini, Anda akan memperbarui konfigurasi komponen inti. Nukleus akan dimulai ulang ketika Anda memperbarui konfigurasi mqtt-nya.

Untuk mengonfigurasi MQTT melalui port 443, buat deployment yang menentukan pembaruan konfigurasi berikut untuk komponen aws.greengrass.Nucleus.

{
  "mqtt": {
    "port": 443
  }
}

Contoh berikut menentukan deployment yang mengonfigurasi MQTT melalui port 443. Pembaruan konfigurasi merge memerlukan objek JSON berserial.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.9.4",
      "configurationUpdate": {
        "merge": "{\"mqtt\":{\"port\":443}}"
      }
    }
  }
}

Konfigurasikan MQTT melalui port 443 selama instalasi

Anda dapat mengkonfigurasi MQTT melalui port 443 ketika Anda menginstal perangkat lunakAWS IoT Greengrass Core pada perangkat inti. Gunakan argumen--init-config installer untuk mengkonfigurasi MQTT melalui port 443. Anda dapat menentukan argumen ini saat menginstal dengan penyediaan manual, penyediaan armada, atau penyediaan khusus.

Konfigurasikan HTTPS melalui port 443

Fitur ini memerlukan v2.0.4 Inti Greengrass atau lebih baru.

Anda dapat mengkonfigurasi HTTPS melalui port 443 pada perangkat inti yang ada atau ketika Anda menginstal perangkat lunakAWS IoT Greengrass Core pada perangkat inti baru.

Konfigurasikan HTTPS melalui port 443 pada perangkat inti yang ada

Anda dapat menggunakan deployment untuk mengonfigurasi HTTPS melalui port 443 pada perangkat inti tunggal atau sekelompok perangkat inti. Dalam deployment ini, Anda akan memperbarui konfigurasi komponen inti.

Untuk mengonfigurasi HTTPS melalui port 443, buat deployment yang menentukan pembaruan konfigurasi berikut untuk komponen aws.greengrass.Nucleus.

{
  "greengrassDataPlanePort": 443
}

Contoh berikut menentukan deployment yang mengonfigurasi HTTPS melalui port 443. Pembaruan konfigurasi merge memerlukan objek JSON berserial.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.9.4",
      "configurationUpdate": {
        "merge": "{\"greengrassDataPlanePort\":443}"
      }
    }
  }
}

Konfigurasikan HTTPS melalui port 443 selama instalasi

Anda dapat mengkonfigurasi HTTPS melalui port 443 ketika Anda menginstal perangkat lunakAWS IoT Greengrass Core pada perangkat inti. Gunakan argumen--init-config installer untuk mengkonfigurasi HTTPS melalui port 443. Anda dapat menentukan argumen ini saat menginstal dengan penyediaan manual, penyediaan armada, atau penyediaan khusus.

Konfigurasikan proksi jaringan

Ikuti prosedur di bagian ini untuk mengonfigurasi perangkat inti Greengrass untuk terhubung ke internet melalui proksi jaringan HTTP atau HTTPS. Untuk informasi lebih lanjut tentang titik akhir dan port yang digunakan oleh perangkat inti, lihatIzinkan lalu lintas perangkat melalui proxy atau firewall.

Konfigurasikan proksi jaringan pada perangkat inti yang ada

Anda dapat menggunakan deployment untuk mengonfigurasi proksi jaringan pada perangkat inti tunggal atau sekelompok perangkat inti. Dalam deployment ini, Anda akan memperbarui konfigurasi komponen inti. Nukleus akan dimulai ulang ketika Anda memperbarui konfigurasi networkProxy-nya.

Untuk mengonfigurasi proksi jaringan, buat deployment untuk komponen aws.greengrass.Nucleus yang menggabungkan pembaruan konfigurasi berikut. Pembaruan konfigurasi ini berisi objek networkProxy.

{
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "https://my-proxy-server:1100",
      "username": "Mary_Major",
      "password": "pass@word1357"
    }
  }
}

Contoh berikut menentukan deployment yang mengonfigurasi proksi jaringan. Pembaruan konfigurasi merge memerlukan objek JSON berserial.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.9.4",
      "configurationUpdate": {
        "merge": "{\"networkProxy\":{\"noProxyAddresses\":\"http://192.168.0.1,www.example.com\",\"proxy\":{\"url\":\"https://my-proxy-server:1100\",\"username\":\"Mary_Major\",\"password\":\"pass@word1357\"}}}"
      }
    }
  }
}

Konfigurasikan proksi jaringan selama instalasi

Anda dapat mengkonfigurasi proxy jaringan ketika Anda menginstal perangkat lunakAWS IoT Greengrass Core pada perangkat inti. Gunakan argumen--init-config installer untuk mengkonfigurasi proxy jaringan. Anda dapat menentukan argumen ini saat menginstal dengan penyediaan manual, penyediaan armada, atau penyediaan khusus.

Aktifkan perangkat inti untuk mempercayai proxy HTTPS

Ketika Anda mengkonfigurasi perangkat inti untuk menggunakan proxy HTTPS, Anda harus menambahkan rantai sertifikat server proxy ke perangkat inti untuk mengaktifkannya mempercayai proxy HTTPS. Jika tidak, perangkat inti mungkin mengalami kesalahan saat mencoba merutekan lalu lintas melalui proxy. Tambahkan sertifikat CA server proksi ke file sertifikat root CA.

Objek networkProxy

Gunakan objek networkProxy untuk menentukan informasi tentang proksi jaringan. Objek ini berisi informasi berikut:

Menggunakan sertifikat perangkat yang ditandatangani oleh CA privat

Jika Anda menggunakan otoritas sertifikat pribadi khusus (CA), Anda harus menyetel nukleus GreengrassgreengrassDataPlaneEndpoint keiotdata. Anda dapat mengatur opsi ini selama penyebaran atau instalasi menggunakan argumen--init-config installer.

Anda dapat menyesuaikan titik akhir bidang data Greengrass tempat perangkat terhubung. Anda dapat mengatur opsi konfigurasi iniiotdata untuk mengatur titik akhir bidang data Greengrass ke titik akhir yang sama dengan titik akhir data IoT, yang dapat Anda tentukan denganiotDataEndpoint.

Konfigurasikan pengaturan batas waktu dan cache MQTT

Di lingkungan AWS IoT Greengrass, komponen dapat menggunakan MQTT untuk berkomunikasi dengan AWS IoT Core. Perangkat lunak inti AWS IoT Greengrass mengelola pesan MQTT untuk komponen. Ketika perangkat inti kehilangan koneksi ke AWS Cloud, perangkat lunak akan menangkap pesan MQTT untuk mencoba lagi nanti ketika sambungan pulih kembali. Anda dapat mengonfigurasi pengaturan seperti timeout pesan dan ukuran cache. Untuk informasi lebih lanjut, lihat parameter konfigurasi mqtt dan mqtt.spooler pada komponen nukleus Greengrass.

AWS IoT Core memberlakukan kuota layanan pada broker pesan MQTT-nya. Kuota ini mungkin berlaku untuk pesan yang Anda kirim antara perangkat inti dan AWS IoT Core. Untuk informasi lebih lanjut, lihat kuota layanan broker pesan AWS IoT Core di Referensi Umum AWS.