Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal versi terbaru EC2 Launch v2
Anda dapat menggunakan salah satu metode berikut untuk menginstal agen EC2Launch v2 pada instans EC2 Anda:
+ Unduh agen dari Amazon S3 dan instal dengan Windows. PowerShell Untuk mengunduh URLs, lihat[EC2Luncurkan unduhan v2 di Amazon S3](#lv2-download-s3).
+ Instal dengan Distributor SSM.
+ Instal dari komponen EC2 Image Builder saat Anda membuat gambar kustom.
+ Luncurkan instans Anda dari AMI yang telah diinstal sebelumnya EC2 Launch v2.
**Awas**
AmazonEC2Launch.msi menghapus versi sebelumnya dari layanan peluncuran EC2, seperti EC2 Launch (v1) dan Config. EC2
Untuk langkah penginstalan, pilih tab yang cocok dengan metode pilihan Anda.
------
#### [ PowerShell ]
Untuk menginstal versi terbaru dari agen EC2 Launch v2 dengan Windows PowerShell, ikuti langkah-langkah ini.
1. Buat direktori lokal Anda.
```
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
```
1. Tetapkan URL untuk lokasi unduhan Anda. Jalankan perintah berikut dengan URL Amazon S3 yang akan Anda gunakan. Untuk mengunduh URLs, lihat [EC2Luncurkan unduhan v2 di Amazon S3](#lv2-download-s3)
```
$Url = "Amazon S3 URL/AmazonEC2Launch.msi"
```
1. Gunakan perintah majemuk berikut untuk mengunduh agen dan menjalankan penginstalan
```
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
```
**catatan**
Jika Anda menerima kesalahan saat mengunduh file, dan Anda menggunakan Windows Server 2016 atau sebelumnya, TLS 1.2 mungkin perlu diaktifkan untuk PowerShell terminal Anda. Anda dapat mengaktifkan TLS 1.2 untuk PowerShell sesi saat ini dengan perintah berikut dan kemudian coba lagi:
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```
1. **msiexec**Perintah menginstal EC2 Launch v2 di lokasi berikut pada instance Windows Server:. `%ProgramFiles%\Amazon\EC2Launch` Untuk memverifikasi bahwa instalasi berjalan, Anda dapat memeriksa sistem file lokal pada instance Anda.
------
#### [ AWS Systems Manager Distributor ]
Untuk mengonfigurasi pembaruan otomatis untuk EC2 Launch v2 dengan AWS Systems Manager Quick Setup, lihat[Instal dan perbarui secara otomatis dengan Pengaturan Cepat Distributor](#lv2-distributor-quick-setup).
Anda juga dapat melakukan instalasi satu kali `AWSEC2Launch-Agent` paket dari AWS Systems Manager Distributor. Untuk instruksi tentang cara menginstal paket dari Systems Manager Distributor, lihat [Menginstal atau memperbarui paket](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) di *Panduan Pengguna AWS Systems Manager *.
------
#### [ EC2 Image Builder component ]
Anda dapat menginstal komponen `ec2launch-v2-windows` saat membuat gambar kustom dengan EC2 Image Builder. Untuk petunjuk tentang cara membuat gambar kustom dengan EC2 Image Builder, lihat [Buat pipeline gambar menggunakan wizard konsol EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) di *Panduan Pengguna EC2 Image Builder*.
------
#### [ AMI ]
EC2Launch v2 sudah diinstal sebelumnya secara default AMIs untuk sistem operasi Windows Server 2022 dan di atasnya:
+ Windows\$1Server- -Bahasa Inggris-Basis Penuh *version*
+ Windows\$1Server- -Bahasa Inggris-Core-Base *version*
+ Windows\$1Server- -Bahasa Inggris-Core-EKS\$1Optimized *version*
+ Windows Server *version* AMIs dengan semua bahasa lainnya
+ Windows Server *version* AMIs dengan SQL diinstal
EC2Launch v2 sudah diinstal sebelumnya di AMI Windows Server berikut. Anda dapat menemukan AMI ini dari konsol Amazon EC2, atau dengan menggunakan prefiks pencarian berikut: `EC2LaunchV2-` di AWS CLI.
+ EC2LaunchV2-Windows\$1Server-2019-Inggris-core-base
+ EC2LaunchV2-Windows\$1Server-2019-Inggris-basis penuh
+ EC2LaunchV2-Windows\$1Server-2016-Inggris-core-base
+ EC2LaunchV2-Windows\$1Server-2016-Bahasa Inggris-basis penuh
------
## Secara otomatis menginstal dan memperbarui EC2 Launch v2 dengan AWS Systems Manager Distributor Quick Setup
Dengan Pengaturan Cepat AWS Systems Manager Distributor, Anda dapat mengatur pembaruan otomatis untuk EC2 Launch v2. Proses berikut menyiapkan Systems Manager Association pada instans Anda yang secara otomatis memperbarui agen EC2 Launch v2 pada frekuensi yang Anda tentukan. Asosiasi yang dibuat oleh Penyiapan Cepat Distributor dapat menyertakan instance dalam Wilayah Akun AWS dan, atau instans dalam Organisasi. AWS Untuk informasi selengkapnya tentang menyiapkan organisasi, lihat [Tutorial: Membuat dan mengonfigurasi organisasi](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) di *Panduan AWS Organizations Pengguna*.
Sebelum Anda mulai, pastikan bahwa contoh Anda memenuhi semua prasyarat.
### Prasyarat
Untuk mengatur pembaruan otomatis dengan Penyiapan Cepat Distributor, instans Anda harus memenuhi prasyarat berikut.
+ Anda memiliki setidaknya satu instance berjalan yang mendukung EC2 Launch v2. Lihat sistem operasi yang didukung untuk[EC2Luncurkan v2](ec2launch-v2.md).
+ Anda telah melakukan tugas penyiapan Systems Manager pada instans Anda. Untuk informasi selengkapnya, lihat [Menyiapkan Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) di *Panduan AWS Systems Manager Pengguna*.
+ EC2Launch v2 harus menjadi satu-satunya agen peluncuran yang diinstal pada instans Anda. Jika Anda memiliki lebih dari satu agen peluncuran yang diinstal, konfigurasi Pengaturan Cepat Distributor Anda akan gagal. Sebelum Anda mengonfigurasi EC2 Launch v2 dengan Distributor Quick Setup, hapus instalan EC2 Config EC2 atau Launch v1 launch agent, jika ada.
### Konfigurasikan Pengaturan Cepat Distributor untuk EC2 Peluncuran v2
Untuk membuat konfigurasi EC2 Launch v2 dengan Penyiapan Cepat Distributor, gunakan pengaturan berikut saat Anda menyelesaikan langkah-langkah [penerapan paket Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html):
+ **Paket perangkat lunak:** Amazon EC2 Launch v2 agent.
+ **Frekuensi pembaruan:** Pilih frekuensi dari daftar.
+ **Target:** Pilih dari opsi penerapan yang tersedia.
Untuk memeriksa status konfigurasi Anda, navigasikan ke tab Systems Manager Quick Setup **Configurations** di Konsol Manajemen AWS.
1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Di panel navigasi, pilih **Pengaturan Cepat**.
1. Di tab **Konfigurasi**, pilih baris yang terkait dengan konfigurasi yang Anda buat. **Tab **Konfigurasi** mencantumkan konfigurasi Anda, dan menyertakan ringkasan detail utama, seperti **Region**, status **Deployment, dan status Asosiasi**.**
**catatan**
Nama asosiasi untuk setiap konfigurasi EC2 Launch v2 Distributor dimulai dengan awalan berikut:`AWS-QuickSetup-Distributor-EC2Launch-Agent-`.
1. Untuk melihat detail, pilih konfigurasi dan pilih **Lihat detail**.
*Untuk informasi selengkapnya dan langkah pemecahan masalah, lihat [Memecahkan Masalah hasil Pengaturan Cepat di Panduan Pengguna](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html).AWS Systems Manager *
## EC2Luncurkan unduhan v2 di Amazon S3
Untuk menginstal versi terbaru EC2 Launch v2, unduh penginstal dari lokasi berikut:
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)
## Konfigurasikan opsi instalasi
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi dengan dialog EC2 Launch v2 install atau dengan **msiexec** perintah di shell baris perintah.
Pertama kali installer EC2 Launch v2 berjalan pada sebuah instance, ini menginisialisasi pengaturan agen peluncuran pada instance Anda sebagai berikut:
+ Ini menciptakan jalur lokal dan menulis file agen peluncuran ke sana. Hal ini terkadang disebut sebagai *instalasi bersih*.
+ Ini menciptakan variabel `EC2LAUNCH_TELEMETRY` lingkungan jika belum ada, dan menetapkannya berdasarkan konfigurasi Anda.
Untuk detail konfigurasi, pilih tab yang cocok dengan metode konfigurasi yang akan Anda gunakan.
------
#### [ Amazon EC2Launch Setup dialog ]
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi berikut melalui dialog EC2 Launch v2 install.Opsi **Instal Dasar**
**Kirim Telemetri**
Saat Anda menyertakan fitur ini dalam dialog penyiapan, penginstal mengatur variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`. Jika Anda menonaktifkan **Kirim Telemetri**, penginstal menetapkan variabel lingkungan ke nilai. `0`
Saat agen EC2 Launch v2 berjalan, ia membaca variabel `EC2LAUNCH_TELEMETRY` lingkungan untuk menentukan apakah akan mengunggah data telemetri. Jika nilainya sama dengan `1`, agen menggunggah data. Jika tidak, itu tidak mengunggah.
**Konfigurasi default**
Konfigurasi default untuk EC2 Launch v2 adalah menimpa agen peluncuran lokal jika sudah ada. Pertama kali Anda menjalankan instalasi pada sebuah instans, konfigurasi default melakukan instalasi bersih. Jika Anda menonaktifkan konfigurasi default pada instalasi awal, instalasi gagal.
Jika Anda menjalankan instalasi lagi pada instans, Anda dapat menonaktifkan konfigurasi default untuk melakukan pemutakhiran yang tidak menggantikan file `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`.
**Contoh: Tingkatkan EC2 Peluncuran v2 dengan telemetri**
Contoh berikut menunjukkan dialog setup EC2 Launch v2 yang dikonfigurasi untuk meng-upgrade instalasi saat ini dan mengaktifkan telemetri. Konfigurasi ini melakukan instalasi tanpa mengganti file konfigurasi agen, dan menetapkan variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`.
![\[EC2Luncurkan konfigurasi upgrade v2.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)
------
#### [ Command line ]
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi berikut dengan **msiexec** perintah di shell baris perintah.Nilai parameter `ADDLOCAL`
**Dasar** (wajib)
Instal agen peluncuran. Jika nilai ini tidak ada dalam `ADDLOCAL` parameter, instalasi berakhir.
**Bersih**
Saat Anda menyertakan nilai `Clean` dalam parameter `ADDLOCAL`, penginstal menuliskan file konfigurasi agen ke lokasi berikut: `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Jika file konfigurasi agen sudah ada, file tersebut akan menimpa file.
Saat Anda membiarkan nilai `Clean` keluar dari parameter `ADDLOCAL`, penginstal melakukan pemutakhiran yang tidak menggantikan file konfigurasi agen.
**Telemetri**
Ketika Anda memasukkan nilai `Telemetry` dalam parameter `ADDLOCAL`, pengisntal mengatur variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`.
Ketika Anda membiarkan nilai `Telemetry` keluar dari parameter `ADDLOCAL`, pengintal menetapkan variabel lingkungan ke nilai `0`.
Saat agen EC2 Launch v2 berjalan, ia membaca variabel `EC2LAUNCH_TELEMETRY` lingkungan untuk menentukan apakah akan mengunggah data telemetri. Jika nilainya sama dengan `1`, agen menggunggah data. Jika tidak, itu tidak mengunggah.
**Contoh: instal EC2 Launch v2 dengan telemetri**
```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```
------
## Verifikasi versi EC2 Launch v2
Gunakan salah satu prosedur berikut untuk memverifikasi versi EC2 Launch v2 yang diinstal pada instans Anda.
------
#### [ PowerShell ]
Verifikasi versi EC2 Launch v2 yang diinstal dengan Windows PowerShell, sebagai berikut.
1. Luncurkan sebuah instans dari AMI dan hubungkan diri Anda dengan instans tersebut.
1. Jalankan perintah berikut PowerShell untuk memverifikasi versi EC2 Launch v2 yang diinstal:
```
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
```
------
#### [ Windows Control Panel ]
Verifikasi versi EC2 Launch v2 yang diinstal di Panel Kontrol Windows, sebagai berikut.
1. Luncurkan sebuah instans dari AMI dan hubungkan diri Anda dengan instans tersebut.
1. Buka Panel Kontrol Windows dan pilih **Program dan Fitur**.
1. Cari `Amazon EC2Launch` dalam daftar program yang diinstal. Nomor versinya muncul di kolom **Versi**.
------
Untuk melihat pembaruan terbaru untuk AWS Windows AMIs, lihat [riwayat versi Windows AMI](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) di *Referensi AMI AWS Windows*.
Untuk versi terbaru dari EC2 Launch v2, lihat[EC2Luncurkan riwayat versi v2](ec2launchv2-versions.md#ec2launchv2-version-history).
Anda dapat menerima pemberitahuan ketika versi baru dari layanan EC2 Launch v2 dirilis. Lihat informasi yang lebih lengkap di [Berlangganan pemberitahuan agen peluncuran EC2 Windows](launch-agents-subscribe-notifications.md).