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

# Agen Systems Manager
<a name="systems-manager-agent-component"></a>

Komponen AWS Systems Manager Agen (`aws.greengrass.SystemsManagerAgent`) menginstal Agen Systems Manager, sehingga Anda dapat mengelola perangkat inti dengan Systems Manager. Systems Manager adalah AWS layanan yang dapat Anda gunakan untuk melihat dan mengontrol infrastruktur AWS, termasuk EC2 instans Amazon, server lokal, dan mesin virtual (VMs), dan perangkat edge. Systems Manager memungkinkan Anda untuk melihat data operasional, mengotomatiskan tugas operasi, dan menjaga keamanan dan kepatuhan. Untuk informasi lebih lanjut, lihat [Apa itu AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) dan [Tentang Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) di *Panduan AWS Systems Manager Pengguna*.

<a name="about-systems-manager-capabilities"></a>Alat dan fitur Systems Manager disebut *kemampuan*. Perangkat inti Greengrass mendukung semua kemampuan Systems Manager. Untuk informasi selengkapnya tentang kemampuan ini dan cara menggunakan Systems Manager untuk mengelola perangkat inti, lihat [kemampuan Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) di *Panduan AWS Systems Manager Pengguna*.

**Topics**
+ [Versi](#systems-manager-agent-component-versions)
+ [Tipe](#systems-manager-agent-component-type)
+ [Sistem operasi](#systems-manager-agent-component-os-support)
+ [Persyaratan](#systems-manager-agent-component-requirements)
+ [Dependensi](#systems-manager-agent-component-dependencies)
+ [Konfigurasi](#systems-manager-agent-component-configuration)
+ [Berkas log lokal](#systems-manager-agent-component-log-file)
+ [Lihat juga](#systems-manager-agent-component-see-also)
+ [Changelog](#systems-manager-agent-component-changelog)

## Versi
<a name="systems-manager-agent-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Tipe
<a name="systems-manager-agent-component-type"></a>

<a name="public-component-type-generic"></a><a name="public-component-type-generic-phrase"></a>Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen.

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

## Sistem operasi
<a name="systems-manager-agent-component-os-support"></a>

Komponen ini hanya dapat diinstal pada perangkat inti Linux.

## Persyaratan
<a name="systems-manager-agent-component-requirements"></a>

Komponen ini memiliki persyaratan sebagai berikut:
+ Perangkat inti Greengrass yang berjalan pada platform Linux 64-bit: Armv8 () atau x86\$164. AArch64
+ Anda harus memiliki peran layanan AWS Identity and Access Management (IAM) yang dapat diasumsikan oleh Systems Manager. Peran ini harus menyertakan kebijakan SSMManaged InstanceCore terkelola [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) atau kebijakan khusus yang menentukan izin yang setara. Untuk informasi selengkapnya, lihat [Membuat peran layanan IAM untuk perangkat edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) di *Panduan AWS Systems Manager Pengguna*.

  Saat menerapkan komponen ini, Anda harus menentukan nama peran ini untuk parameter `SSMRegistrationRole` konfigurasi.
+ [Peran perangkat Greengrass harus memungkinkan](device-service-role.md) dan tindakan. `ssm:AddTagsToResource` `ssm:RegisterManagedInstance` Peran perangkat juga harus memungkinkan `iam:PassRole` tindakan untuk peran layanan IAM yang memenuhi persyaratan sebelumnya. Contoh berikut kebijakan IAM memberikan izin ini.

  ```
  {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "iam:PassRole"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:iam::account-id:role/SSMServiceRole"
        ]
      },
      {
        "Action": [
          "ssm:AddTagsToResource",
          "ssm:RegisterManagedInstance"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

### Titik akhir dan port
<a name="systems-manager-agent-component-endpoints"></a>

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat [Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md).


| Titik akhir | Port | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `ec2messages.region.amazonaws.com`  | 443 | Ya |  Berkomunikasi dengan layanan Systems Manager di AWS Cloud.  | 
|  `ssm.region.amazonaws.com`  | 443 | Ya |  Daftarkan perangkat inti sebagai node terkelola Systems Manager.  | 
|  `ssmmessages.region.amazonaws.com`  | 443 | Ya |  Berkomunikasi dengan Session Manager, kemampuan Systems Manager, di AWS Cloud.  | 

*Untuk informasi selengkapnya, lihat [Referensi: ec2messages, ssmmessages, dan panggilan API lainnya di Panduan Pengguna](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html).AWS Systems Manager *

## Dependensi
<a name="systems-manager-agent-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](#systems-manager-agent-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**.

Tabel berikut mencantumkan dependensi untuk versi 1.0.0 hingga 1.3.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Layanan pertukaran Token](token-exchange-service-component.md) |  >=2.0.0 <3.0.0 | Keras | 

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

## Konfigurasi
<a name="systems-manager-agent-component-configuration"></a>

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

`SSMRegistrationRole`  
Peran layanan IAM yang dapat diasumsikan oleh Systems Manager dan yang mencakup kebijakan SSMManaged InstanceCore terkelola [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) atau kebijakan kustom yang menentukan izin yang setara. Untuk informasi selengkapnya, lihat [Membuat peran layanan IAM untuk perangkat edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) di *Panduan AWS Systems Manager Pengguna*.

`SSMOverrideExistingRegistration`  
(Opsional) Jika perangkat inti sudah menjalankan Agen Systems Manager yang terdaftar dengan aktivasi hibrida, Anda dapat mengganti pendaftaran Agen Systems Manager perangkat yang ada. Setel opsi ini `true` untuk mendaftarkan perangkat inti sebagai node terkelola menggunakan Agen Systems Manager yang disediakan komponen ini.  
Opsi ini hanya berlaku untuk perangkat yang terdaftar dengan aktivasi hibrida. Jika perangkat inti berjalan pada EC2 instans Amazon dengan Agen Systems Manager diinstal dan peran profil instans dikonfigurasi, ID node terkelola EC2 instans Amazon yang sudah ada akan dimulai dengan`i-`. Saat Anda menginstal komponen Systems Manager Agent, agen Systems Manager mendaftarkan node terkelola baru yang ID-nya dimulai dengan `mi-` alih-alih. `i-` Kemudian, Anda dapat menggunakan node terkelola yang IDnya dimulai `mi-` untuk mengelola perangkat inti dengan Systems Manager.
Default: `false`

`SSMResourceTags`  
(Opsional) Tag untuk ditambahkan ke node terkelola Systems Manager yang dibuat komponen ini untuk perangkat inti. Anda dapat menggunakan tag ini untuk mengelola grup perangkat inti dengan Systems Manager. Misalnya, Anda dapat menjalankan perintah di semua perangkat yang memiliki tag yang Anda tentukan.  
Tentukan daftar di mana setiap tag adalah objek dengan a `Key` dan a`Value`. Misalnya, nilai berikut untuk `SSMResourceTags` menginstruksikan komponen ini untuk menyetel **Owner** tag **richard-roe** pada node terkelola perangkat inti.  

```
[
  {
    "Key": "Owner",
    "Value": "richard-roe"
  }
]
```
Komponen ini mengabaikan tag ini jika node terkelola sudah ada dan `SSMOverrideExistingRegistration` sudah ada. `false`

**Example Contoh: Pembaruan gabungan konfigurasi**  
Contoh konfigurasi berikut menentukan untuk menggunakan peran layanan bernama `SSMServiceRole` untuk memungkinkan perangkat inti untuk mendaftar dan berkomunikasi dengan Systems Manager.  

```
{
  "SSMRegistrationRole": "SSMServiceRole",
  "SSMOverrideExistingRegistration": false,
  "SSMResourceTags": [
    {
      "Key": "Owner",
      "Value": "richard-roe"
    },
    {
      "Key": "Team",
      "Value": "solar"
    }
  ]
}
```

## Berkas log lokal
<a name="systems-manager-agent-component-log-file"></a>

Perangkat lunak Systems Manager Agent menulis log ke folder di luar folder root Greengrass. Untuk informasi selengkapnya, lihat [Melihat log Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) di *Panduan AWS Systems Manager Pengguna*.

Komponen Systems Manager Agent menggunakan skrip shell untuk menginstal, memulai, dan menghentikan Agen Systems Manager. Anda dapat menemukan output dari skrip ini di file log berikut.

```
/greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
```

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

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

## Lihat juga
<a name="systems-manager-agent-component-see-also"></a>
+ [Kelola perangkat inti Greengrass dengan AWS Systems Manager](manage-with-systems-manager.md)
+ [Apa itu AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) dalam *AWS Systems Manager Panduan Penggguna*
+ [Tentang Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) di *Panduan AWS Systems Manager Pengguna*

## Changelog
<a name="systems-manager-agent-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  **Versi**  |  **Perubahan**  | 
| --- | --- | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.1.0  |  Versi ini berisi perbaikan bug dan perbaikan.  | 
|  1.0.0  |  Versi awal.  |