Argumen penginstal - AWS IoT Greengrass

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

Argumen penginstal

Perangkat lunak inti AWS IoT Greengrass mencakup installer yang menyiapkan perangkat lunak dan menyediakan sumber daya AWS yang diperlukan untuk perangkat inti Greengrass yang akan dijalankan. Installer mencakup argumen berikut yang dapat Anda tentukan untuk mengonfigurasi instalasi:

-h, --help

(Opsional) Tampilkan informasi bantuan penginstal.

--version

(Opsional) Tampilkan versi perangkat lunak inti AWS IoT Greengrass.

-Droot

(Opsional) Path ke folder yang akan digunakan sebagai akar untuk perangkat lunak inti AWS IoT Greengrass.

catatan

Argumen ini menetapkan properti JVM, sehingga Anda harus menentukannya sebelum -jar ketika Anda menjalankan installer tersebut. Sebagai contoh, tentukan java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

Default:

  • Linux: ~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

Wilayah AWS yang digunakan oleh perangkat lunak inti AWS IoT Greengrass untuk mengambil atau membuat sumber daya AWS yang diperlukan.

-p, --provision

(Opsional) Anda dapat mendaftarkan perangkat ini sebagai objek AWS IoT dan menyediakan sumber daya AWS yang dibutuhkan oleh perangkat inti. Jika Anda menentukan true, perangkat lunak inti AWS IoT Greengrass akan menyediakan objek AWS IoT, grup objek AWS IoT (opsional), IAM role, dan alias peran AWS IoT.

Default: false

-tn, --thing-name

(Opsional) Nama objek AWS IoT yang Anda daftarkan sebagai perangkat inti ini. Jika objek dengan nama itu tidak ada di Akun AWS, perangkat lunak inti AWS IoT Greengrass akan membuatnya.

catatan

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

Anda harus menentukan --provision true untuk menerapkan argumen ini.

Default: GreengrassV2IotThing_ ditambah UUID acak.

-tgn, --thing-group-name

(Opsional) Nama grup objek AWS IoT tempat Anda menambahkan objek AWS IoT. Jika deployment menargetkan grup objek ini, perangkat inti ini akan menerima deployment itu ketika terhubung ke AWS IoT Greengrass. Jika grup objek dengan nama ini tidak ada di Akun AWS Anda, perangkat lunak inti AWS IoT Greengrass akan membuatnya.

catatan

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

Anda harus menentukan --provision true untuk menerapkan argumen ini.

-tpn, --thing-policy-name

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

(Opsional) Nama AWS IoT kebijakan untuk dilampirkan ke sertifikat AWS IoT benda perangkat inti ini. Jika AWS IoT kebijakan dengan nama ini tidak ada di AndaAkun AWS, perangkat lunak AWS IoT Greengrass Core membuatnya.

Perangkat lunak AWS IoT Greengrass Core membuat AWS IoT kebijakan permisif secara default. Anda dapat menjelaskan kebijakan ini, atau membuat kebijakan khusus yang membatasi izin untuk kasus penggunaan Anda. Untuk informasi selengkapnya, lihat Kebijakan AWS IoT minimal untuk perangkat inti AWS IoT Greengrass V2.

Anda harus menentukan --provision true untuk menerapkan argumen ini.

Default: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(Opsional) Nama IAM role yang akan digunakan untuk memperoleh kredensial AWS yang memungkinkan perangkat inti berinteraksi dengan layanan AWS. Jika objek dengan nama itu tidak ada di Akun AWS Anda, perangkat lunak inti AWS IoT Greengrass akan membuatnya dengan kebijakan GreengrassV2TokenExchangeRoleAccess. Peran ini tidak memiliki akses ke bucket S3 tempat Anda meng-hosting artefak komponen. Jadi, Anda harus menambahkan izin pada bucket S3 dan objek artefak Anda ketika Anda membuat komponen. Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

Anda harus menentukan --provision true untuk menerapkan argumen ini.

Default: GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(Opsional) Nama alias peran AWS IoT yang menunjuk ke IAM role yang menyediakan kredensial AWS untuk perangkat inti ini. Jika alias peran dengan nama ini tidak ada di Akun AWS, perangkat lunak inti AWS IoT Greengrass akan membuatnya dan mengarahkannya ke IAM role yang Anda tentukan.

Anda harus menentukan --provision true untuk menerapkan argumen ini.

Default: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(Opsional) Anda dapat mengatur perangkat lunak inti AWS IoT Greengrass sebagai layanan sistem yang berjalan saat perangkat ini booting. Nama layanan sistem adalah greengrass. Untuk informasi selengkapnya, lihat Konfigurasikan inti Greengrass sebagai layanan sistem.

Pada sistem operasi Linux, argumen ini mengharuskan sistem init systemd tersedia di perangkat.

penting

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

Default: false

-u, --component-default-user

Nama atau ID pengguna yang digunakan perangkat lunak AWS IoT Greengrass Core untuk menjalankan komponen. Misalnya, Anda dapat menentukan ggc_user. Nilai ini diperlukan ketika Anda menjalankan installer pada sistem operasi Windows.

Pada sistem operasi Linux, Anda juga dapat menentukan grup secara opsional. Tentukan pengguna dan grup yang dipisahkan dengan titik dua. Misalnya, ggc_user:ggc_group.

Pertimbangan tambahan berikut berlaku untuk sistem operasi Linux:

  • Jika Anda menjalankan sebagai root, pengguna komponen default adalah pengguna yang didefinisikan dalam file konfigurasi. Jika file konfigurasi tidak mendefinisikan pengguna, ini default ke. ggc_user:ggc_group Jika ggc_user atau ggc_group tidak ada, perangkat lunak akan membuatnya.

  • Jika Anda berjalan sebagai pengguna non-root, perangkat lunak inti AWS IoT Greengrass akan menggunakan pengguna tersebut untuk menjalankan komponen.

  • Jika Anda tidak menentukan grup, perangkat lunak inti AWS IoT Greengrass akan menggunakan grup utama dari pengguna sistem.

Untuk informasi selengkapnya, lihat Konfigurasikan pengguna yang menjalankan komponen.

-d, --deploy-dev-tools

(Opsional) Anda dapat mengunduh dan men-deploy komponen Greengrass CLI pada perangkat inti ini. Anda dapat menggunakan alat ini untuk mengembangkan dan men-debug komponen pada perangkat inti ini.

penting

Kami menyarankan Anda menggunakan komponen ini hanya di lingkungan pengembangan, bukan lingkungan produksi. Komponen ini menyediakan akses ke informasi dan operasi yang biasanya tidak Anda perlukan di lingkungan produksi. Ikuti prinsip hak istimewa paling sedikit dengan menerapkan komponen ini hanya ke perangkat inti di mana Anda membutuhkannya.

Anda harus menentukan --provision true untuk menerapkan argumen ini.

Default: false

-init, --init-config

(Opsional) Path ke file konfigurasi yang akan digunakan untuk menginstal perangkat lunak inti AWS IoT Greengrass. Anda dapat menggunakan opsi ini untuk mengatur perangkat inti baru dengan konfigurasi inti tertentu, misalnya.

penting

File konfigurasi yang Anda tentukan bergabung dengan file konfigurasi yang ada di perangkat inti. Ini termasuk komponen dan konfigurasi komponen pada perangkat inti. Kami merekomendasikan file konfigurasi hanya mencantumkan konfigurasi yang Anda coba ubah.

-tp, --trusted-plugin

(Opsional) Jalur ke file JAR untuk dimuat sebagai plugin tepercaya. Gunakan opsi ini untuk menyediakan file JAR plugin penyediaan, seperti menginstal dengan penyediaan armada atau penyediaankhusus, atau untuk menginstal dengan kunci pribadi dan sertifikat dalam modul keamanan perangkat keras.

-s, --start

(Opsional) Anda dapat memulai perangkat lunak inti AWS IoT Greengrass setelah menginstal dan, secara opsional, menyediakan sumber daya.

Default: true