Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal Greengrass CLI
Anda dapat menginstal Greengrass CLI dengan salah satu cara berikut:
+ Gunakan `--deploy-dev-tools` argumen saat pertama kali menyiapkan perangkat lunak AWS IoT Greengrass Core di perangkat Anda. Anda juga harus menentukan `--provision true` untuk menerapkan argumen ini.
+ Deploy komponen Greengrass CLI (`aws.greengrass.Cli`) di perangkat Anda.
Bagian ini menjelaskan langkah-langkah untuk men-deploy komponen Greengrass CLI. Untuk informasi tentang menginstal Greengrass CLI selama pengaturan awal, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md).
## Prasyarat
Untuk menerapkan komponen CLI Greengrass, Anda harus memenuhi persyaratan berikut:
+ AWS IoT Greengrass Perangkat lunak inti diinstal dan dikonfigurasi pada perangkat inti Anda. Untuk informasi selengkapnya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md).
+ Untuk menggunakan AWS CLI untuk menyebarkan CLI Greengrass, Anda harus telah menginstal dan mengkonfigurasi. AWS CLI Untuk informasi lebih lanjut, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) di *Panduan Pengguna AWS Command Line Interface *.
+ Anda harus diberi wewenang untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Core. AWS IoT Greengrass Lakukan salah satu langkah berikut untuk menggunakan Greengrass CLI:
+ Gunakan pengguna sistem yang menjalankan perangkat lunak AWS IoT Greengrass Core.
+ Gunakan pengguna dengan izin root atau adminstratif. Pada perangkat inti Linux, Anda dapat menggunakan `sudo` untuk mendapatkan izin root.
+ Gunakan pengguna sistem yang berada dalam grup yang Anda tentukan dalam parameter `AuthorizedPosixGroups` atau `AuthorizedWindowsGroups` konfigurasi saat Anda menerapkan komponen. Untuk informasi selengkapnya, lihat konfigurasi [komponen CLI Greengrass](greengrass-cli-component.md#greengrass-cli-component-configuration).
## Deploy komponen Greengrass CLI
Selesaikan langkah-langkah berikut untuk men-deploy komponen Greengrass CLI ke perangkat inti Anda:
### Untuk men-deploy komponen Greengrass CLI (konsol)
1. Masuk ke [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).
1. Dalam menu navigasi, pilih **Komponen**.
1. Pada halaman **Komponen**, pada tab **Komponen publik**, pilih `aws.greengrass.Cli`.
1. Pada halaman **aws.greengrass.Cli** pilih **Deploy**.
1. Dari **Tambahkan ke deployment**, pilih **Buat deployment baru**.
1. Pada halaman **Tentukan target**, di bawah **Target deployment**, di daftar **Nama target**, pilih grup Greengrass yang ingin Anda deploy, dan pilih **Selanjutnya**.
1. Pada halaman **Pilih komponen**, verifikasi bahwa komponen **aws.greengrass.Cli** tersebut dipilih, dan pilih **Selanjutnya**.
1. Pada halaman **Konfigurasikan komponen**, simpan pengaturan konfigurasi default, dan pilih **Selanjutnya**.
1. Pada halaman **Konfigurasikan pengaturan lanjutan**, simpan pengaturan konfigurasi default tersebut, dan pilih **Selanjutnya**.
1. Di halaman **Tinjauan**, klik **Deploy**.
### Untuk men-deploy komponen Greengrass CLI (AWS CLI)
1. Di perangkat Anda, buatlah file `deployment.json` untuk menentukan konfigurasi deployment untuk komponen Greengrass CLI. File ini akan terlihat seperti berikut:
```
{
"targetArn":"targetArn",
"components": {
"aws.greengrass.Cli": {
"componentVersion": "2.16.1",
"configurationUpdate": {
"merge": "{\"AuthorizedPosixGroups\":\",,...,\",\"AuthorizedWindowsGroups\":\",,...,\"}"
}
}
}
}
```
+ Di kolom `target`, ganti `targetArn` dengan Amazon Resource Name (ARN) dari grup objek atau objek yang ditargetkan untuk deployment tersebut, dalam format berikut:
+ Objek: `arn:aws:iot:region:account-id:thing/thingName`
+ Grup objek: `arn:aws:iot:region:account-id:thinggroup/thingGroupName`
+ Di objek komponen `aws.greengrass.Cli`, tentukan nilai-nilai sebagai berikut:
`version`
Versi komponen Greengrass CLI.
`configurationUpdate.AuthorizedPosixGroups`
(Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau grup IDs. Misalnya, `group1,1002,group3` mengotorisasi tiga grup sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI.
Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan Greengrass CLI sebagai `sudo` pengguna root () atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass
`configurationUpdate.AuthorizedWindowsGroups`
(Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau grup IDs. Misalnya, `group1,1002,group3` mengotorisasi tiga grup sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI.
Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan CLI Greengrass sebagai administrator atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass
1. Jalankan perintah berikut untuk men-deploy komponen Greengrass CLI pada perangkat:
```
$ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json
```
Selama instalasi, komponen menambahkan link simbolik ke `greengrass-cli` dalam folder `/greengrass/v2/bin` pada perangkat Anda, dan Anda menjalankan Greengrass CLI dari jalur ini. Untuk menjalankan Greengrass CLI tanpa path absolut, tambahkan folder `/greengrass/v2/bin` Anda ke variabel PATH Anda. Untuk memverifikasi instalasi Greengrass CLI, jalankan perintah berikut:
------
#### [ Linux or Unix ]
```
/greengrass/v2/bin/greengrass-cli help
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli help
```
------
Anda akan melihat output berikut:
```
Usage: greengrass-cli [-hV] [--ggcRootPath=] [COMMAND]
Greengrass command line interface
--ggcRootPath=
The AWS IoT Greengrass V2 root directory.
-h, --help Show this help message and exit.
-V, --version Print version information and exit.
Commands:
help Show help information for a command.
component Retrieve component information and stop or restart
components.
deployment Create local deployments and retrieve deployment status.
logs Analyze Greengrass logs.
get-debug-password Generate a password for use with the HTTP debug view
component.
```
Jika `greengrass-cli` tidak ditemukan, deployment mungkin gagal untuk menginstal Greengrass CLI. Lihat informasi yang lebih lengkap di [Pemecahan masalah AWS IoT Greengrass V2](troubleshooting.md).