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 versi kemudianKomponen inti Greengrass.

(Opsional) NamaAWS IoTkebijakan untuk melampirkan ke perangkat inti iniAWS IoThal sertifikat. JikaAWS IoTkebijakan dengan nama ini tidak ada diAkun AWS, yangAWS IoT GreengrassPerangkat lunak inti menciptakannya.

YangAWS IoT GreengrassPerangkat lunak inti menciptakan permisifAWS IoTkebijakan secara default. Anda dapat cakupan bawah kebijakan ini, atau membuat kebijakan kustom di mana Anda 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 nukleus Greengrass sebagai layanan sistem.

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

penting

Pada perangkat inti Windows, Anda harus mengaturAWS IoT GreengrassPerangkat lunak inti sebagai layanan sistem.

Default: false

-u, --component-default-user

Nama atau ID pengguna yangAWS IoT GreengrassPerangkat lunak inti digunakan 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. Sebagai contoh, ggc_user:ggc_group.

Pertimbangan tambahan berikut berlaku untuk sistem operasi Linux:

  • Jika Anda berjalan sebagai root, pengguna komponen default adalah pengguna yang ditentukan dalam file konfigurasi. Jika file konfigurasi tersebut tidak menentukan pengguna, default-nya menjadiggc_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 Mengkonfigurasi 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 agar Anda menggunakan komponen ini hanya pada 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 untuk perangkat inti yang Anda butuhkan.

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 akan menggantikan file konfigurasi yang ada pada perangkat inti. Hal ini akan menghapus konfigurasi yang ada, yang mencakup komponen dan konfigurasi komponen pada perangkat inti.

-tp, --trusted-plugin

(Opsional) Path ke file JAR yang akan dimuat sebagai plugin tepercaya. Gunakan opsi ini untuk menyediakan file JAR plugin penyediaan, seperti untuk menginstal denganpenyediaan armadaataupenyediaan khusus, atau untuk menginstal dengan kunci pribadi dan sertifikat dalammodul 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