Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Penginstalan aplikasi komponen terkelola paket distributor untuk image Image Builder Windows
AWS Systems Manager Distributor membantu Anda mengemas dan mempublikasikan perangkat lunak ke node yang AWS Systems Manager dikelola. Anda dapat mengemas dan mempublikasikan perangkat lunak Anda sendiri atau menggunakan Distributor untuk menemukan dan menerbitkan paket perangkat lunak agen yang AWS disediakan. Untuk informasi selengkapnya tentang Distributor Systems Manager, lihat [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) di *Panduan AWS Systems Manager Pengguna*.
**Komponen terkelola untuk Distributor**
Komponen terkelola Image Builder berikut menggunakan AWS Systems Manager Distributor untuk menginstal paket aplikasi pada instance Windows.
+ Komponen `distributor-package-windows` terkelola menggunakan AWS Systems Manager Distributor untuk menginstal paket aplikasi yang Anda tentukan pada instance build image Windows Anda. Untuk mengonfigurasi parameter saat Anda menyertakan komponen ini dalam resep Anda, lihat[Konfigurasikan `distributor-package-windows` sebagai komponen mandiri](#mgdcomponent-distributor-config-standalone).
+ `aws-vss-components-windows`Komponen menggunakan AWS Systems Manager Distributor untuk menginstal `AwsVssComponents` paket pada instance build image Windows Anda. Untuk mengonfigurasi parameter saat Anda menyertakan komponen ini dalam resep Anda, lihat[Konfigurasikan `aws-vss-components-windows` sebagai komponen mandiri](#mgdcomponent-vss-config-standalone).
Untuk informasi selengkapnya tentang cara menggunakan komponen terkelola dalam resep Image Builder, lihat [Buat versi baru dari resep gambar](create-image-recipes.md) resep gambar atau [Buat versi baru dari resep wadah](create-container-recipes.md) resep kontainer. *Untuk informasi selengkapnya tentang `AwsVssComponents` paket, lihat [Membuat snapshot yang konsisten dengan aplikasi VSS di Panduan Pengguna](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/application-consistent-snapshots.html) Amazon EC2.*
## Prasyarat
Sebelum Anda menggunakan komponen Image Builder yang mengandalkan Systems Manager Distributor untuk menginstal paket aplikasi, Anda harus memastikan bahwa prasyarat berikut terpenuhi.
+ Komponen Image Builder yang menggunakan Systems Manager Distributor untuk menginstal paket aplikasi pada instans Anda memerlukan izin untuk memanggil Systems Manager API. Sebelum menggunakan komponen dalam resep Image Builder, Anda harus membuat kebijakan dan peran IAM yang memberikan izin. Untuk mengonfigurasi izin, lihat[Konfigurasikan izin Distributor Systems Manager](#mgdcomponent-distributor-permissions).
**catatan**
Image Builder saat ini tidak mendukung paket Distributor Systems Manager yang me-reboot instance. Misalnya, paket, `AWSNVMe``AWSPVDrivers`, dan `AwsEnaNetworkDriver` Distributor me-reboot instance, dan karenanya tidak diperbolehkan.
## Konfigurasikan izin Distributor Systems Manager
`distributor-package-windows`Komponen dan komponen lain yang menggunakannya, seperti`aws-vss-components-windows`, memerlukan izin tambahan pada instance build untuk dijalankan. Instans build harus dapat memanggil Systems Manager API untuk memulai instalasi Distributor dan polling untuk hasilnya.
Ikuti prosedur berikut Konsol Manajemen AWS untuk membuat kebijakan dan peran IAM kustom yang memberikan izin bagi komponen Image Builder untuk menginstal paket Distributor Systems Manager dari instance build.
**Langkah 1: Buat kebijakan**
Buat kebijakan IAM untuk izin Distributor.
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi, pilih **Kebijakan** dan kemudian pilih **Buat kebijakan**.
1. Pada halaman **Buat kebijakan**, pilih tab **JSON**, lalu ganti konten default dengan kebijakan JSON berikut, ganti partisi, Wilayah, dan ID akun seperlunya, atau menggunakan wildcard.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowDistributorSendCommand",
"Effect": "Allow",
"Action": "ssm:SendCommand",
"Resource": [
"arn:aws:ssm:*::document/AWS-ConfigureAWSPackage",
"arn:aws:ec2:*:111122223333:instance/*"
]
},
{
"Sid": "AllowGetCommandInvocation",
"Effect": "Allow",
"Action": "ssm:GetCommandInvocation",
"Resource": "*"
}
]
}
```
------
1. Pilih **Tinjau kebijakan**.
1. Untuk **Nama**, masukkan nama untuk mengidentifikasi kebijakan, seperti `InvokeDistributor` atau nama lain yang Anda inginkan.
1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi tujuan peran.
1. Pilih **Buat kebijakan**.
**Langkah 2: Buat peran**
Buat peran IAM untuk izin Distributor.
1. Dari panel navigasi konsol IAM, pilih **Peran, lalu pilih **Buat** peran**.
1. Di bawah **Pilih jenis entitas tepercaya**, pilih **Layanan AWS**.
1. Segera di bawah **Pilih layanan yang akan menggunakan peran ini**, pilih **EC2**, lalu pilih **Berikutnya: Izin**.
1. Di bawah **Pilih kasus penggunaan Anda**, pilih **EC2**, lalu pilih **Berikutnya: Izin**.
1. Dalam daftar kebijakan, pilih kotak centang di sebelah **Amazon SSMManaged InstanceCore**. (Jenis `SSM` di kotak pencarian jika Anda perlu mempersempit daftar.)
1. Dalam daftar kebijakan ini, pilih kotak di sebelah **EC2InstanceProfileForImageBuilder**. (Jenis `ImageBuilder` di kotak pencarian jika Anda perlu mempersempit daftar.)
1. Pilih **Berikutnya: Tag**.
1. (Opsional) Tambahkan satu atau beberapa pasangan nilai kunci tag untuk mengatur, melacak, atau mengontrol akses untuk peran ini, lalu pilih **Berikutnya: Tinjau**.
1. Untuk **Nama peran**, masukkan nama untuk peran, seperti `InvokeDistributor` atau nama lain yang Anda inginkan.
1. (Opsional) Untuk **Deskripsi peran**, ganti teks default dengan deskripsi tujuan peran ini.
1. Pilih **Buat peran**. Sistem mengembalikan Anda ke halaman **Peran**.
**Langkah 3: Lampirkan kebijakan ke peran**
Langkah terakhir untuk mengatur izin Distributor Anda adalah melampirkan kebijakan IAM ke peran IAM.
1. Dari halaman **Peran** di konsol IAM, pilih peran yang baru saja Anda buat. Peran **Halaman ringkasan** terbuka.
1. Pilih **Lampirkan kebijakan**.
1. Cari kebijakan yang Anda buat di prosedur sebelumnya dan pilih kotak centang di sebelah nama.
1. Pilih **Lampirkan kebijakan**.
Gunakan peran ini di sumber daya Konfigurasi Infrastruktur Image Builder untuk gambar apa pun yang menyertakan komponen yang menggunakan Distributor Systems Manager. Untuk informasi selengkapnya, lihat [Membuat konfigurasi infrastruktur](create-infra-config.md).
## Konfigurasikan `distributor-package-windows` sebagai komponen mandiri
Untuk menggunakan `distributor-package-windows` komponen dalam resep, atur parameter berikut yang mengkonfigurasi paket yang akan diinstal.
**catatan**
Sebelum Anda menggunakan `distributor-package-windows` komponen dalam resep, Anda harus memastikan bahwa semua [Prasyarat](#mgdcomponent-distributor-prereq) terpenuhi.
+ **Tindakan** (Wajib) - Tentukan apakah akan menginstal atau menghapus paket. Nilai yang valid mencakup `Install` dan `Uninstall`. Nilai defaultnya. `Install`
+ **PackageName**(Wajib) - Nama paket Distributor untuk menginstal atau menghapus instalasi. Untuk daftar nama paket yang valid, lihat[Temukan paket Distributor](#mgdcomponent-distributor-find-pkg).
+ **PackageVersion**(Opsional) — Versi paket Distributor yang akan diinstal. PackageVersion default ke versi yang direkomendasikan.
+ **AdditionalArguments**(Opsional) - String JSON yang berisi parameter tambahan untuk diberikan ke skrip Anda untuk menginstal, menghapus, atau memperbarui paket. Untuk informasi selengkapnya, lihat **additionalArguments** di **bagian** [AWS:ConfigurePackage Inputs](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-command-ssm-plugin-reference.html#aws-configurepackage) dari halaman referensi plugin dokumen Systems **Manager** Command.
## Konfigurasikan `aws-vss-components-windows` sebagai komponen mandiri
Saat Anda menggunakan `aws-vss-components-windows` komponen dalam resep, Anda dapat mengatur `PackageVersion` parameter secara opsional untuk menggunakan versi `AwsVssComponents` paket tertentu. Ketika Anda meninggalkan parameter ini, komponen default untuk menggunakan versi paket yang direkomendasikan. `AwsVssComponents`
**catatan**
Sebelum Anda menggunakan `aws-vss-components-windows` komponen dalam resep, Anda harus memastikan bahwa semua [Prasyarat](#mgdcomponent-distributor-prereq) terpenuhi.
## Temukan paket Distributor
Amazon dan pihak ketiga menyediakan paket publik yang dapat Anda instal dengan Systems Manager Distributor.
Untuk melihat paket yang tersedia di Konsol Manajemen AWS, masuk ke [AWS Systems Manager konsol](https://console.aws.amazon.com/systems-manager/;) dan pilih **Distributor** dari panel navigasi. Halaman **Distributor** menunjukkan semua paket yang tersedia untuk Anda. Untuk informasi selengkapnya tentang daftar paket yang tersedia dengan AWS CLI, lihat [Lihat paket (baris perintah)](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-view-packages.html) di *Panduan AWS Systems Manager Pengguna*.
Anda juga dapat membuat paket Distributor Systems Manager pribadi Anda sendiri. Untuk informasi selengkapnya, lihat [Membuat paket](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-create.html) di *Panduan AWS Systems Manager Pengguna*.