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

# Greengrass CLI
<a name="greengrass-cli-component"></a>

Komponen Greengrass CLI (`aws.greengrass.Cli`) menyediakan antarmuka baris perintah lokal yang dapat Anda gunakan pada perangkat inti untuk mengembangkan dan debug komponen secara lokal. Greengrass CLI memungkinkan Anda untuk membuat deployment lokal dan me-restart komponen pada perangkat inti, misalnya.

Anda dapat menginstal komponen ini ketika Anda menginstal perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md).

**penting**  
 <a name="local-dev-tools-production-environment-warning"></a>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. 

Setelah Anda menginstal komponen ini, jalankan perintah berikut untuk melihat dokumentasi bantuan. Ketika komponen ini diinstal, komponen tersebut menambahkan tautan simbolik ke `greengrass-cli` dalam folder `/greengrass/v2/bin`. Anda dapat menjalankan Greengrass CLI dari jalur ini atau menambahkannya ke variabel lingkungan `PATH` Anda untuk menjalankan `greengrass-cli` tanpa jalur absolutnya.

------
#### [ Linux or Unix ]

```
/greengrass/v2/bin/greengrass-cli help
```

------
#### [ Windows ]

```
C:\greengrass\v2\bin\greengrass-cli help
```

------

Perintah berikut me-restart komponen bernama `com.example.HelloWorld`, misalnya.

------
#### [ Linux or Unix ]

```
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
```

------
#### [ Windows ]

```
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"
```

------

Untuk informasi selengkapnya, lihat [Antarmuka Baris Perintah Greengrass](gg-cli.md).

**Topics**
+ [Versi](#greengrass-cli-component-versions)
+ [Tipe](#greengrass-cli-component-type)
+ [Sistem operasi](#greengrass-cli-component-os-support)
+ [Persyaratan](#greengrass-cli-component-requirements)
+ [Dependensi](#greengrass-cli-component-dependencies)
+ [Konfigurasi](#greengrass-cli-component-configuration)
+ [File log lokal](#greengrass-cli-component-log-file)
+ [Changelog](#greengrass-cli-component-changelog)

## Versi
<a name="greengrass-cli-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 2.16.x
+ 2.15.x
+ 2.14.x
+ 2.13.x
+ 2.12.x
+ 2.11.x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipe
<a name="greengrass-cli-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

<a name="public-component-type-plugin-para2"></a>Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md).

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="greengrass-cli-component-os-support"></a>

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:
+ Linux
+ Windows

## Persyaratan
<a name="greengrass-cli-component-requirements"></a>

Komponen ini memiliki persyaratan sebagai berikut:
+ <a name="greengrass-cli-authorization-requirement"></a>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-configuration).
+ Komponen CLI Greengrass didukung untuk berjalan di VPC.

## Dependensi
<a name="greengrass-cli-component-dependencies"></a>

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk [versi yang dirilis](#greengrass-cli-component-changelog) dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**.

------
#### [ 2.16.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.16.0 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Lunak | 

------
#### [ 2.15.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.15.1 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Lunak | 

------
#### [ 2.15.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.15.0 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Lunak | 

------
#### [ 2.14.0 – 2.14.3 ]

Tabel berikut mencantumkan dependensi untuk versi 2.14.0 dan 2.14.3 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Lunak | 

------
#### [ 2.13.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.13.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Lunak | 

------
#### [ 2.12.0 – 2.12.6 ]

Tabel berikut mencantumkan dependensi untuk versi 2.12.0 hingga 2.12.6 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Lunak | 

------
#### [ 2.11.0 – 2.11.3 ]

Tabel berikut mencantumkan dependensi untuk versi 2.11.0 hingga 2.11.3 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Lunak | 

------
#### [ 2.10.0 – 2.10.3 ]

Tabel berikut mencantumkan dependensi untuk versi 2.10.0 hingga 2.10.3 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Lunak | 

------
#### [ 2.9.0 – 2.9.6 ]

Tabel berikut mencantumkan dependensi untuk versi 2.9.0 hingga 2.9.6 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Lunak | 

------
#### [ 2.8.0 – 2.8.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.8.0 dan 2.8.1 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Lunak | 

------
#### [ 2.7.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.7.0 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Lunak | 

------
#### [ 2.6.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.6.0 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Lunak | 

------
#### [ 2.5.0 – 2.5.6 ]

Tabel berikut mencantumkan dependensi untuk versi 2.5.0 hingga 2.5.6 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Lunak | 

------
#### [ 2.4.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.4.0 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Lunak | 

------
#### [ 2.3.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Lunak | 

------
#### [ 2.2.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Lunak | 

------
#### [ 2.1.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Lunak | 

------
#### [ 2.0.x ]

Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Lunak | 

**catatan**  
Versi kompatibel minimum dari nukleus Greengrass sesuai dengan versi patch komponen Greengrass CLI. 

------

Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfigurasi
<a name="greengrass-cli-component-configuration"></a>

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

------
#### [ 2.5.x - 2.14.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(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 

`AuthorizedWindowsGroups`  <a name="greengrass-cli-component-configuration-authorizedwindowsgroups"></a>
(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 

**Example Contoh: Pembaruan gabungan konfigurasi**  
Contoh konfigurasi berikut menentukan untuk mengotorisasi tiga grup sistem POSIX (`group1`,`1002`, dan`group3`) dan dua kelompok pengguna Windows (`Device Operators`dan`QA Engineers`) untuk menggunakan CLI Greengrass.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
```

------
#### [ 2.4.x - 2.0.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(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 

**Example Contoh: Pembaruan gabungan konfigurasi**  
Contoh konfigurasi berikut akan menentukan untuk mengotorisasi tiga kelompok sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3"
}
```

------

## File log lokal
<a name="greengrass-cli-component-log-file"></a>

Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Untuk melihat log komponen ini**
+ Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="greengrass-cli-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  **Versi**  |  **Perubahan**  | 
| --- | --- | 
|  2.16.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.16.1 rilis.  | 
|  2.16.0  |  Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis.  | 
|  2.15.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.15.1 rilis.  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.14.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.14.3 rilis.  | 
|  2.14.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.14.2 rilis.  | 
|  2.14.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.14.1 rilis.  | 
|  2.14.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.13.0  |  Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis.  | 
|  2.12.6  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.6 rilis.  | 
|  2.12.5  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.5 rilis.  | 
|  2.12.4  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.4 rilis.  | 
|  2.12.3  |   Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini.  Versi diperbarui untuk Greengrass nucleus versi 2.12.3 rilis.  | 
|  2.12.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.2 rilis.  | 
|  2.12.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.1 rilis.  | 
|  2.12.0  |  Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.  | 
|  2.11.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.11.3 rilis.  | 
|  2.11.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.11.2 rilis.  | 
|  2.11.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.11.1 rilis.  | 
|  2.11.0  |  <a name="changelog-cli-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.10.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.10.3 rilis.  | 
|  2.10.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.10.2 rilis.  | 
|  2.10.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.10.1 rilis.  | 
|  2.10.0  |  Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.  | 
|  2.9.6  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.6 rilis.  | 
|  2.9.5  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.5 rilis.  | 
|  2.9.4  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.4 rilis.  | 
|  2.9.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.3 rilis.  | 
|  2.9.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.2 rilis.  | 
|  2.9.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.9.1 rilis.  | 
|  2.9.0  | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | 
|  2.8.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.8.1 rilis.  | 
|  2.8.0  | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | 
|  2.7.0  |  Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.  | 
|  2.6.0  |  <a name="changelog-greengrass-cli-2.6.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.5.6  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.6 rilis.  | 
|  2.5.5  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.5 rilis.  | 
|  2.5.4  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.4 rilis.  | 
|  2.5.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.3 rilis.  | 
|  2.5.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.2 rilis.  | 
|  2.5.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.1 rilis.  | 
|  2.5.0  |  <a name="changelog-greengrass-cli-2.5.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.4.0  |  <a name="changelog-greengrass-cli-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.3.0  |  Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.  | 
|  2.2.0  |  Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.  | 
|  2.1.0  |  Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.  | 
|  2.0.5  | Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.5. | 
|  2.0.4  | Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.4. | 
|  2.0.3  |  Versi awal.  |