Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Instal perangkat lunak inti AWS IoT Greengrass dengan penyediaan sumber daya otomatis
Perangkat lunak inti AWS IoT Greengrass mencakup penginstal yang mengatur perangkat Anda sebagai perangkat inti Greengrass. Untuk menyiapkan perangkat dengan cepat, penginstal dapat menyediakan objek AWS IoT, grup objek AWS IoT, IAM role, dan alias peran AWS IoT yang diperlukan perangkat inti untuk beroperasi. Installer juga dapat men-deploy alat pengembangan lokal ke perangkat inti, sehingga Anda dapat menggunakan perangkat tersebut untuk mengembangkan dan menguji komponen perangkat lunak kustom. Installer membutuhkan kredensial AWS untuk menyediakan sumber daya ini dan membuat deployment.
Jika Anda tidak dapat memberikan kredensial AWS untuk perangkat tersebut, Anda dapat menyediakan sumber daya AWS yang dibutuhkan perangkat inti untuk beroperasi. Anda juga dapat men-deploy alat pengembangan ke perangkat inti untuk digunakan sebagai perangkat pengembangan. Hal ini memungkinkan Anda untuk memberikan lebih sedikit izin untuk perangkat ketika Anda menjalankan installer. Untuk informasi selengkapnya, lihat Instal perangkat lunak inti AWS IoT Greengrass dengan penyediaan sumber daya manual.
Sebelum Anda mengunduh perangkat lunak inti AWS IoT Greengrass, periksa apakah perangkat inti Anda memenuhi persyaratan untuk menginstal dan menjalankan perangkat lunak inti v2.0 AWS IoT Greengrass.
Topik
Siapkan Lingkungan perangkat
Ikuti langkah-langkah di bagian ini untuk mengatur perangkat Linux atau Windows yang akan digunakan sebagai perangkatAWS IoT Greengrass inti Anda.
Mengatur perangkat LinuxAWS IoT Greengrass V2
-
Pasang waktu aktif Java, yang diperlukan oleh perangkat lunak inti AWS IoT Greengrass agar berjalan. Kami menyarankan Anda menggunakan Amazon Corretto 11
atau OpenJDK 11 . Perintah berikut menunjukkan kepada Anda bagaimana menginstal OpenJDK pada 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
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)
-
-
(Opsional) Buat pengguna sistem default dan grup yang menjalankan komponen pada perangkat. Anda juga dapat memilih untuk membiarkan penginstal perangkat lunakAWS IoT Greengrass inti membuat pengguna dan grup ini selama instalasi dengan argumen
--component-default-user
penginstal. Untuk informasi selengkapnya, lihat Argumen penginstal.sudo useradd --system --create-home ggc_user sudo groupadd --system ggc_group
-
Verifikasi bahwa pengguna yang menjalankan perangkat lunakAWS IoT Greengrass inti (biasanya
root
) memiliki izin untuk berjalansudo
dengan pengguna dan grup apa pun.-
Jalankan perintah berikut untuk membuka
/etc/sudoers
file.sudo visudo
-
Verifikasi bahwa izin bagi pengguna terlihat seperti contoh berikut.
root ALL=(ALL:ALL) ALL
-
-
(Opsional) Untuk menjalankan fungsi Lambda dalam kontainer, Anda harus mengaktifkan cgroup
v1, dan Anda harus mengaktifkan dan me-mount cgroup memori dan perangkat. Jika Anda tidak berencana untuk menjalankan fungsi Lambda dalam 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 mengatur parameter kernel untuk perangkat Anda, lihat dokumentasi untuk sistem operasi dan boot loader Anda. Ikuti petunjuk untuk mengatur parameter kernel secara permanen.
Tip: Atur parameter kernel pada Raspberry Pi Jika perangkat Anda adalah Raspberry Pi, Anda dapat menyelesaikan langkah-langkah berikut untuk melihat dan memperbarui parameter kernel Linux-nya:
-
Buka file
/boot/cmdline.txt
. File ini menentukan parameter kernel Linux untuk diterapkan saat Raspberry Pi melakukan boot.Sebagai contoh, pada sistem berbasis Linux, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuka file.
sudo nano /boot/cmdline.txt
-
Verifikasi bahwa
/boot/cmdline.txt
file tersebut berisi parameter kernel berikut.systemd.unified_cgroup_hierarchy=0
Parameter menentukan untuk menggunakan cgroups v1 bukan cgroups v2.cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0
Jika
/boot/cmdline.txt
file tidak berisi parameter ini, atau berisi parameter ini dengan nilai yang berbeda, perbarui file agar berisi parameter dan nilai ini. -
Jika Anda memperbarui
/boot/cmdline.txt
file, reboot Raspberry Pi untuk menerapkan perubahan.sudo reboot
-
-
Instal semua dependensi lain yang diperlukan pada perangkat Anda seperti yang ditunjukkan oleh daftar persyaratan diPersyaratan perangkat.
Fitur ini tersedia untuk v2.5.0 dan versi kemudian dari komponen inti Greengrass.
Mengatur perangkat WindowsAWS IoT Greengrass V2
-
Pasang waktu aktif Java, yang diperlukan oleh perangkat lunak inti AWS IoT Greengrass agar berjalan. Kami menyarankan Anda menggunakan Amazon Corretto 11
atau OpenJDK 11 . -
Periksa apakah Java tersedia pada variabel sistem PATH
, dan tambahkan jika tidak. LocalSystem Akun menjalankan perangkat lunakAWS IoT Greengrass Core, jadi Anda harus menambahkan Java ke variabel sistem PATH, bukan variabel pengguna PATH untuk pengguna Anda. Lakukan hal berikut: -
Tekan tombol Windows untuk membuka menu mulai.
-
Ketik
environment variables
untuk mencari opsi sistem dari menu mulai. -
Di hasil pencarian menu mulai, pilih Edit variabel lingkungan sistem untuk membuka jendela Properti sistem.
-
Pilih Variabel lingkungan... untuk membuka jendela Variabel Lingkungan.
-
Di bawah Variabel sistem, pilih Jalur, lalu pilih Edit. Di jendela variabel lingkungan Edit, Anda dapat melihat setiap jalur pada baris terpisah.
-
Periksa apakah path ke
bin
folder instalasi Java hadir. Path mungkin terlihat serupa dengan contoh berikut.C:\Program Files\Amazon Corretto\jdk11.0.13_8\bin
-
Jika
bin
folder instalasi Java hilang dari Path, pilih New untuk menambahkannya, dan kemudian pilih OK.
-
-
Buka Windows Command Prompt (
cmd.exe
) sebagai administrator. -
Buat pengguna default di LocalSystem akun pada perangkat Windows. Ganti
kata sandi
dengan kata sandi yang aman.net user /add ggc_user
password
Tip Tergantung pada konfigurasi Windows Anda, kata sandi pengguna mungkin diatur untuk kedaluwarsa pada tanggal di masa future. 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 kedaluwarsa, jalankan perintah berikut.
wmic UserAccount where "Name='
ggc_user
'" set PasswordExpires=False
-
-
Unduh dan instal PsExecutilitas
dari Microsoft pada perangkat. -
Gunakan PsExec utilitas untuk menyimpan nama pengguna dan kata sandi untuk pengguna default di instance Credential Manager untuk LocalSystem akun tersebut. Ganti
kata sandi
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 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, bukan LocalSystem akun.
Berikan kredensial AWS ke perangkat
Berikan kredensial AWS ke perangkat Anda agar installer dapat menyediakan sumber daya AWS yang diperlukan. Untuk informasi lebih lanjut tentang izin yang diperlukan, lihat Kebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya.
Untuk memberikan kredensial AWS ke perangkat
-
BerikanAWS kredensi ke perangkat agar installer dapat menyediakanAWS IoT dan sumber daya IAM untuk perangkat inti Anda. Untuk meningkatkan keamanan, kami menyarankan agar Anda mendapatkan kredensi sementara untuk IAM role yang memungkinkan hanya izin minimum yang perlu disediakan. 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 dari hal berikut ini untuk mengambil kredensi dan membuatnya tersedia untuk installer perangkat lunakAWS IoT Greengrass inti:
-
Gunakan kredensial jangka panjang dari pengguna IAM:
-
Berikan access key ID dan secret access key untuk pengguna IAM Anda. Untuk informasi selengkapnya tentang cara mengambil kredensial jangka panjang, lihat Mengelola access key untuk pengguna IAM di Panduan Pengguna IAM.
-
Jalankan perintah berikut untuk memberikan kredensial ke perangkat lunak inti AWS IoT Greengrass.
-
-
(Disarankan) Gunakan kredensial keamanan sementara dari IAM role:
-
Berikan access key ID, secret access key, dan token sesi dari IAM role yang Anda teruskan. Untuk informasi selengkapnya tentang cara mengambil kredensi ini, lihat Meminta kredensi keamanan sementara pada Panduan Pengguna IAM.
-
Jalankan perintah berikut untuk menyediakan kredensial pada perangkat lunak inti AWS IoT Greengrass.
-
-
Unduh perangkat lunak inti AWS IoT Greengrass
Anda dapat mengunduh versi terbaru perangkat lunak inti AWS IoT Greengrass dari lokasi berikut:
Anda dapat mengunduh versi tertentu perangkat lunak inti AWS IoT Greengrass dari lokasi berikut. Ganti versi
dengan versi yang akan diunduh.
https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-
version
.zip
Untuk mengunduh perangkat lunakAWS IoT Greengrass Inti
-
Di perangkat inti Anda, unduh perangkat lunakAWS IoT Greengrass inti ke file bernama
greengrass-nucleus-latest.zip
.Dengan mengunduh perangkat lunak ini, Anda menyetujui Perjanjian Lisensi Perangkat Lunak Greengrass Core
. -
Unzip perangkat lunak inti AWS IoT Greengrass ke folder di perangkat Anda. Ganti
GreengrassInstaller
dengan folder yang ingin Anda gunakan. -
(Opsional) Jalankan perintah berikut untuk melihat versi perangkat lunak inti AWS IoT Greengrass.
java -jar ./
GreengrassInstaller
/lib/Greengrass.jar --version
Jika Anda menginstal versi inti Greengrass lebih awal dari v2.4.0, jangan hapus folder ini setelah Anda menginstal perangkat lunakAWS IoT Greengrass Core. Perangkat lunak inti AWS IoT Greengrass menggunakan file di folder ini yang akan dijalankan.
Jika Anda mengunduh versi terbaru dari perangkat lunak, Anda menginstal v2.4.0 atau yang lebih baru, dan Anda dapat menghapus folder ini setelah menginstal perangkat lunakAWS IoT Greengrass inti.
Instal perangkat lunak inti AWS IoT Greengrass
Jalankan installer dengan argumen yang menentukan untuk melakukan hal berikut:
-
Buat sumber daya AWS yang dibutuhkan perangkat inti untuk beroperasi.
-
Tentukan untuk menggunakan pengguna
ggc_user
sistem untuk menjalankan komponen perangkat lunak pada perangkat inti. Pada perangkat Linux, perintah ini juga menentukan untuk menggunakan grupggc_group
sistem, dan installer membuat pengguna sistem dan grup untuk Anda. -
Siapkan perangkat lunakAWS IoT Greengrass inti sebagai layanan sistem yang berjalan saat boot. Pada perangkat Linux, ini membutuhkan sistem init Systemd
. penting Di perangkat inti Windows, Anda harus mengatur perangkat lunakAWS IoT Greengrass inti sebagai layanan sistem.
Untuk menyiapkan perangkat pengembangan dengan alat pengembangan lokal, tentukan argumen --deploy-dev-tools true
. Alat pengembangan lokal dapat memakan waktu hingga satu menit untuk ter-deploy setelah instalasi tersebut selesai.
Untuk informasi lebih lanjut tentang argumen yang dapat Anda tentukan, lihat Argumen penginstal.
Jika Anda menjalankan AWS IoT Greengrass pada perangkat dengan memori terbatas, Anda dapat mengontrol 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.
Untuk menginstal AWS IoT Greengrass perangkat lunak Core
-
Jalankan penginstal inti AWS IoT Greengrass. Ganti nilai-nilai argumen dalam perintah Anda sebagai berikut:
-
/greengrass/v2
atauC:\greengrass\v2
: Path ke folder akar yang akan digunakan untuk menginstal perangkat lunakAWS IoT Greengrass inti. -
GreengrassInstaller
. Path ke folder tempat Anda membongkar penginstal perangkat lunak inti AWS IoT Greengrass. -
region
. Wilayah AWS tempat untuk menemukan atau membuat sumber daya. -
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 (
:
). -
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 (
:
). -
GreenGrassv2IOTThingPolicy
. NamaAWS IoT kebijakan yang memungkinkan perangkat inti Greengrass untuk berkomunikasi denganAWS IoT danAWS IoT Greengrass. JikaAWS IoT kebijakan tidak ada, installer akan membuatAWS 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. -
GreenGrassV2TokenExchangeRole
. 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
. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.GreengrassV2TokenExchangeRole
Access -
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.
penting Di perangkat inti Windows, Anda harus menentukan
--setup-system-service true
untuk mengatur perangkat lunakAWS IoT Greengrass inti sebagai layanan sistem.Installer mencetak pesan berikut jika berhasil:
-
Jika Anda menentukan
--provision
, penginstal akan mencetakSuccessfully configured Nucleus with provisioned resource details
jika berhasil mengonfigurasi sumber daya. -
Jika Anda menentukan
--deploy-dev-tools
, penginstal akan mencetakConfigured Nucleus to deploy aws.greengrass.Cli component
jika berhasil membuat deployment. -
Jika Anda menentukan
--setup-system-service true
, penginstal akan mencetakSuccessfully 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 mencetakLaunched Nucleus successfully
jika berhasil dan menjalankan perangkat lunak.
-
-
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 inti AWS IoT Greengrass Anda. Ganti
/greengrass/v2
dengan folder akar 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
Jika Anda menginstal perangkat lunak inti AWS IoT Greengrass sebagai layanan sistem, installer akan menjalankan perangkat lunak untuk Anda. Jika tidak, Anda harus menjalankan perangkat lunak itu secara manual. Untuk informasi selengkapnya, lihat Jalankan perangkat lunak inti AWS IoT Greengrass.
Secara default, IAM role yang dibuat oleh installer tidak mengizinkan akses ke artefak komponen dalam Bucket S3. Untuk men-deploy komponen kustom yang menentukan artefak di Amazon S3, Anda harus menambahkan izin untuk peran tersebut untuk memungkinkan perangkat inti Anda untuk mengambil artefak komponen. Untuk informasi selengkapnya, lihat Izinkan akses ke bucket S3 untuk artefak komponen.
Jika Anda belum memiliki bucket S3 untuk artefak komponen, Anda dapat menambahkan izin ini nanti setelah membuat bucket.
Untuk informasi lebih lanjut tentang cara mengonfigurasi dan menggunakan perangkat lunak dan AWS IoT Greengrass, lihat hal berikut: