Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal AWS Systems Manager Agen
AWS Systems Manager Agen (Systems Manager Agent) adalah perangkat lunak Amazon yang Anda instal untuk mengaktifkan Systems Manager memperbarui, mengelola, dan mengonfigurasi perangkat inti Greengrass, instans Amazon EC2, dan sumber daya lainnya. Agen memproses dan menjalankan permintaan dari layanan Systems Manager di AWS Cloud. Kemudian, agen mengirimkan informasi status dan runtime kembali ke layanan Systems Manager. Untuk informasi selengkapnya, lihat [Tentang Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) di *Panduan AWS Systems Manager Pengguna*.
AWS menyediakan Agen Systems Manager sebagai komponen Greengrass yang dapat Anda terapkan ke perangkat inti Greengrass Anda untuk mengelolanya dengan Systems Manager. [Komponen Systems Manager Agent](systems-manager-agent-component.md) menginstal perangkat lunak Systems Manager Agent dan mendaftarkan perangkat inti sebagai node terkelola di Systems Manager. Ikuti langkah-langkah di halaman ini untuk menyelesaikan prasyarat dan menerapkan komponen Systems Manager Agent ke perangkat inti atau grup perangkat inti.
**Topics**
+ [Langkah 1: Menyelesaikan langkah-langkah pengaturan umum Systems Manager](#setup-systems-manager)
+ [Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role)
+ [Langkah 3: Tambahkan izin ke peran pertukaran token](#update-token-exchange-role-ssm-agent)
+ [Langkah 4: Menyebarkan komponen Systems Manager Agent](#deploy-ssm-agent-component)
+ [Langkah 5: Verifikasi pendaftaran perangkat inti dengan Systems Manager](#verify-ssm-registration)
## Langkah 1: Menyelesaikan langkah-langkah pengaturan umum Systems Manager
Jika Anda belum melakukannya, selesaikan langkah-langkah pengaturan umum untuk AWS Systems Manager. Untuk informasi selengkapnya, lihat [Lengkapi langkah-langkah penyiapan Systems Manager umum](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-edge-devices-setup-general.html) di *Panduan AWS Systems Manager Pengguna*.
## Langkah 2: Buat peran layanan IAM untuk Systems Manager
Agen Systems Manager menggunakan peran layanan AWS Identity and Access Management (IAM) untuk berkomunikasi dengan AWS Systems Manager. Systems Manager mengasumsikan peran ini untuk mengaktifkan kemampuan Systems Manager pada setiap perangkat inti. Komponen Systems Manager Agent juga menggunakan peran ini untuk mendaftarkan perangkat inti sebagai node terkelola Systems Manager saat Anda menerapkan komponen. Jika Anda belum melakukannya, buat peran layanan Systems Manager untuk komponen Systems Manager Agent yang akan digunakan. 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) di *Panduan AWS Systems Manager Pengguna*.
## Langkah 3: Tambahkan izin ke peran pertukaran token
Perangkat inti Greengrass menggunakan peran layanan IAM, yang disebut peran pertukaran token, untuk berinteraksi dengan layanan. AWS Setiap perangkat inti memiliki peran pertukaran token yang Anda buat saat Anda [menginstal perangkat lunak AWS IoT Greengrass Core](install-greengrass-core-v2.md). Banyak komponen Greengrass, seperti Agen Systems Manager, memerlukan izin tambahan pada peran ini. Komponen agen Systems Manager memerlukan izin berikut, yang mencakup izin untuk menggunakan peran yang Anda buat. [Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role)
```
{
"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": "*"
}
]
}
```
Jika Anda belum melakukannya, tambahkan izin ini ke peran pertukaran token perangkat inti untuk memungkinkan Agen Systems Manager beroperasi. Anda dapat menambahkan kebijakan baru ke peran pertukaran token untuk memberikan izin ini.
### Untuk menambahkan izin ke peran pertukaran token (konsol)
1. Di menu navigasi [konsol IAM](https://console.aws.amazon.com/iam), pilih **Peran**.
1. Pilih peran IAM yang Anda atur sebagai peran pertukaran token saat Anda menginstal perangkat lunak AWS IoT Greengrass Inti. Jika Anda tidak menentukan nama untuk peran pertukaran token saat Anda menginstal perangkat lunak AWS IoT Greengrass Core, itu membuat peran bernama`GreengrassV2TokenExchangeRole`.
1. Di bawah **Izin**, pilih **Tambahkan izin**, lalu pilih **Lampirkan** kebijakan.
1. Pilih **Buat kebijakan**. Halaman **Buat kebijakan** terbuka di tab browser baru.
1. Pada halaman **Buat kebijakan**, lakukan hal berikut:
1. Pilih **JSON** untuk membuka editor JSON.
1. Tempelkan kebijakan berikut ke editor JSON. Ganti *SSMServiceRole* dengan nama peran layanan yang Anda buat[Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role).
```
{
"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": "*"
}
]
}
```
1. Pilih **Berikutnya: Tanda**.
1. Pilih **Berikutnya: Tinjau**.
1. Masukkan **Nama** untuk kebijakan, seperti**GreengrassSSMAgentComponentPolicy**.
1. Pilih **Buat kebijakan**.
1. Beralih ke tab browser sebelumnya di mana Anda memiliki peran pertukaran token terbuka.
1. Pada halaman **Tambah izin**, pilih tombol refresh, lalu pilih kebijakan agen Greengrass Systems Manager yang Anda buat di langkah sebelumnya.
1. Pilih **Lampirkan kebijakan**.
Perangkat inti yang menggunakan peran pertukaran token ini sekarang memiliki izin untuk berinteraksi dengan layanan Systems Manager.
### Untuk menambahkan izin ke peran pertukaran token ()AWS CLI
**Untuk menambahkan kebijakan yang memberikan izin untuk menggunakan Systems Manager**
1. Buat file bernama `ssm-agent-component-policy.json` dan salin JSON berikut ke dalam file. Ganti *SSMServiceRole* dengan nama peran layanan yang Anda buat[Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role).
```
{
"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": "*"
}
]
}
```
1. Jalankan perintah berikut untuk membuat kebijakan dari dokumen kebijakan di `ssm-agent-component-policy.json`.
------
#### [ Linux or Unix ]
```
aws iam create-policy \
--policy-name GreengrassSSMAgentComponentPolicy \
--policy-document file://ssm-agent-component-policy.json
```
------
#### [ Windows Command Prompt (CMD) ]
```
aws iam create-policy ^
--policy-name GreengrassSSMAgentComponentPolicy ^
--policy-document file://ssm-agent-component-policy.json
```
------
#### [ PowerShell ]
```
aws iam create-policy `
--policy-name GreengrassSSMAgentComponentPolicy `
--policy-document file://ssm-agent-component-policy.json
```
------
Salin Amazon Resource Name (ARN) kebijakan dari metadata kebijakan dalam output. Anda menggunakan ARN ini untuk melampirkan kebijakan ini ke peran perangkat inti di langkah berikutnya.
1. Jalankan perintah berikut untuk melampirkan kebijakan ke peran pertukaran token.
+ Ganti *GreengrassV2TokenExchangeRole* dengan nama peran pertukaran token yang Anda tentukan saat Anda menginstal perangkat lunak AWS IoT Greengrass Core. Jika Anda tidak menentukan nama untuk peran pertukaran token saat Anda menginstal perangkat lunak AWS IoT Greengrass Core, itu membuat peran bernama`GreengrassV2TokenExchangeRole`.
+ Ganti ARN kebijakan dengan ARN dari langkah sebelumnya.
------
#### [ Linux or Unix ]
```
aws iam attach-role-policy \
--role-name GreengrassV2TokenExchangeRole \
--policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy
```
------
#### [ Windows Command Prompt (CMD) ]
```
aws iam attach-role-policy ^
--role-name GreengrassV2TokenExchangeRole ^
--policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy
```
------
#### [ PowerShell ]
```
aws iam attach-role-policy `
--role-name GreengrassV2TokenExchangeRole `
--policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy
```
------
Jika perintah tidak memiliki output, itu berhasil. Perangkat inti yang menggunakan peran pertukaran token ini sekarang memiliki izin untuk berinteraksi dengan layanan Systems Manager.
## Langkah 4: Menyebarkan komponen Systems Manager Agent
Selesaikan langkah-langkah berikut untuk menerapkan dan mengkonfigurasi komponen Systems Manager Agent. Anda dapat menyebarkan komponen ke perangkat inti tunggal atau ke sekelompok perangkat inti.
### Untuk menyebarkan komponen Agen Systems Manager (konsol)
1. Pada menu navigasi [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) tersebut, pilih **Komponen**.
1. Pada halaman **Components**, pilih tab **Public components**, lalu pilih **aws.greengrass.SystemsManagerAgent**.
1. Pada halaman **aws.greengrass.SystemsManagerAgent** pilih **Deploy**.
1. **Dari **Tambahkan ke penerapan**, pilih penerapan yang ada untuk direvisi, atau pilih untuk membuat penerapan baru, lalu pilih Berikutnya.**
1. Jika Anda memilih untuk membuat penerapan baru, pilih perangkat inti target atau grup hal untuk penerapan. Pada halaman **Tentukan target**, di bawah **target Deployment**, pilih perangkat inti atau grup benda, lalu pilih **Berikutnya**.
1. Pada halaman **Pilih komponen**, verifikasi bahwa **aws.greengrass.SystemsManagerAgent**komponen dipilih, pilih **Berikutnya**.
1. Pada halaman **Configure components**, pilih **aws.greengrass.SystemsManagerAgent**, lalu lakukan hal berikut:
1. Pilih **Konfigurasi komponen**.
1. Dalam aws.greengrass.SystemsManagerAgent modal **Konfigurasi**, di bawah **pembaruan Konfigurasi**, di **Konfigurasi untuk digabungkan**, masukkan pemutakhiran konfigurasi berikut. Ganti *SSMServiceRole* dengan nama peran layanan yang Anda buat[Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role).
```
{
"SSMRegistrationRole": "SSMServiceRole",
"SSMOverrideExistingRegistration": false
}
```
**catatan**
Jika perangkat inti sudah menjalankan Agen Systems Manager yang terdaftar dengan aktivasi hibrida, ubah `SSMOverrideExistingRegistration` ke`true`. Parameter ini menentukan apakah komponen Systems Manager Agent mendaftarkan perangkat inti saat Agen Systems Manager sudah berjalan di perangkat dengan aktivasi hybrid.
Anda juga dapat menentukan tag (`SSMResourceTags`) untuk ditambahkan ke node terkelola Systems Manager yang dibuat oleh komponen Systems Manager Agent untuk perangkat inti. Untuk informasi selengkapnya, lihat [konfigurasi komponen Agen Manajer Sistem](systems-manager-agent-component.md#systems-manager-agent-component-configuration).
1. Pilih **Konfirmasi** untuk menutup modal, lalu pilih **Berikutnya**.
1. Pada halaman **Konfigurasikan pengaturan lanjutan**, simpan pengaturan konfigurasi default tersebut, dan pilih **Selanjutnya**.
1. Di halaman **Tinjau**, pilih **Deploy**.
Penyebaran dapat memakan waktu hingga satu menit untuk diselesaikan.
### Untuk menyebarkan komponen Agen Systems Manager ()AWS CLI
Untuk menerapkan komponen Systems Manager Agent, buat dokumen penerapan yang disertakan `aws.greengrass.SystemsManagerAgent` dalam `components` objek, dan tentukan pemutakhiran konfigurasi untuk komponen tersebut. Ikuti petunjuk [Buat deployment](create-deployments.md) untuk membuat penerapan baru atau merevisi penerapan yang ada.
Contoh berikut dokumen penyebaran sebagian menentukan untuk menggunakan peran layanan bernama. `SSMServiceRole` Ganti *SSMServiceRole* dengan nama peran layanan yang Anda buat[Langkah 2: Buat peran layanan IAM untuk Systems Manager](#create-ssm-service-role).
```
{
...,
"components": {
...,
"aws.greengrass.SystemsManagerAgent": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"merge": "{\"SSMRegistrationRole\":\"SSMServiceRole\",\"SSMOverrideExistingRegistration\":false}"
}
}
}
}
```
**catatan**
Jika perangkat inti sudah menjalankan Agen Systems Manager yang terdaftar dengan aktivasi hibrida, ubah `SSMOverrideExistingRegistration` ke`true`. Parameter ini menentukan apakah komponen Systems Manager Agent mendaftarkan perangkat inti saat Agen Systems Manager sudah berjalan di perangkat dengan aktivasi hybrid.
Anda juga dapat menentukan tag (`SSMResourceTags`) untuk ditambahkan ke node terkelola Systems Manager yang dibuat oleh komponen Systems Manager Agent untuk perangkat inti. Untuk informasi selengkapnya, lihat [konfigurasi komponen Agen Manajer Sistem](systems-manager-agent-component.md#systems-manager-agent-component-configuration).
Deployment ini dapat memakan waktu beberapa menit hingga selesai. Anda dapat menggunakan AWS IoT Greengrass layanan untuk memeriksa status penyebaran, dan Anda dapat memeriksa log perangkat lunak AWS IoT Greengrass inti dan log komponen Agen Systems Manager untuk memverifikasi bahwa Agen Manajer Sistem berjalan dengan sukses. Untuk informasi selengkapnya, lihat berikut ini:
+ [Periksa status deployment](check-deployment-status.md)
+ [Memantau AWS IoT Greengrass log](monitor-logs.md)
+ [Melihat log Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) di *Panduan AWS Systems Manager Pengguna*
Jika penerapan gagal atau Agen Systems Manager tidak berjalan, Anda dapat memecahkan masalah penerapan pada setiap perangkat inti. Untuk informasi selengkapnya, lihat berikut ini:
+ [Pemecahan masalah AWS IoT Greengrass V2](troubleshooting.md)
+ [Pemecahan Masalah Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-ssm-agent.html) *di Panduan Pengguna AWS Systems Manager *
## Langkah 5: Verifikasi pendaftaran perangkat inti dengan Systems Manager
Ketika komponen Systems Manager Agent berjalan, ia mendaftarkan perangkat inti sebagai node terkelola di Systems Manager. Anda dapat menggunakan AWS IoT Greengrass konsol, konsol Systems Manager, dan Systems Manager API untuk memverifikasi bahwa perangkat inti terdaftar sebagai node terkelola. Node terkelola juga disebut instance di bagian AWS konsol dan API.
### Untuk memverifikasi pendaftaran perangkat inti (AWS IoT Greengrass konsol)
1. Di menu navigasi [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) tersebut, pilih **Perangkat inti**.
1. Pilih perangkat inti untuk memverifikasi.
1. Pada halaman detail perangkat inti, temukan properti **AWS Systems Manager instance**. Jika properti ini ada dan menampilkan tautan ke konsol Systems Manager, perangkat inti terdaftar sebagai node terkelola.
Anda juga dapat menemukan properti **status AWS Systems Manager ping** untuk memeriksa status Agen Systems Manager pada perangkat inti. Ketika statusnya **Online**, Anda dapat mengelola perangkat inti dengan Systems Manager.
### Untuk memverifikasi pendaftaran perangkat inti (konsol Systems Manager)
1. Di menu navigasi [konsol Systems Manager](https://console.aws.amazon.com/systems-manager), pilih **Fleet Manager**.
1. Di bawah **Node terkelola**, lakukan hal berikut:
1. Tambahkan filter di mana **tipe Sumber** berada **AWS::IoT::Thing**.
1. Tambahkan filter di mana **Source ID** adalah nama perangkat inti untuk memverifikasi.
1. Temukan perangkat inti dalam tabel **Managed nodes**. Jika perangkat inti ada di tabel, itu terdaftar sebagai node terkelola.
Anda juga dapat menemukan properti **status ping Agen Manajer Systems** untuk memeriksa status Agen Systems Manager pada perangkat inti. Ketika statusnya **Online**, Anda dapat mengelola perangkat inti dengan Systems Manager.
### Untuk memverifikasi registrasi perangkat inti (AWS CLI)
+ Gunakan [DescribeInstanceInformation](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeInstanceInformation.html)operasi untuk mendapatkan daftar node terkelola yang cocok dengan filter yang Anda tentukan. Jalankan perintah berikut untuk memverifikasi apakah perangkat inti terdaftar sebagai node terkelola. Ganti *MyGreengrassCore* dengan nama perangkat inti untuk memverifikasi.
```
aws ssm describe-instance-information --filter Key=SourceIds,Values=MyGreengrassCore Key=SourceTypes,Values=AWS::IoT::Thing
```
Respons berisi daftar node terkelola yang cocok dengan filter. Jika daftar berisi node terkelola, perangkat inti terdaftar sebagai node terkelola. Anda juga dapat menemukan informasi lain tentang node terkelola perangkat inti dalam respons. Jika `PingStatus` propertinya`Online`, Anda dapat mengelola perangkat inti dengan Systems Manager.
Setelah memverifikasi bahwa perangkat inti terdaftar sebagai node terkelola di Systems Manager, Anda dapat menggunakan konsol Systems Manager dan API untuk mengelola perangkat inti tersebut. *Untuk informasi selengkapnya tentang kemampuan Systems Manager yang dapat Anda gunakan untuk mengelola perangkat inti Greengrass, lihat kemampuan [Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) di Panduan Pengguna.AWS Systems Manager *