Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan agen EC2launch v2 untuk melakukan tugas selama peluncuran instans Windows EC2
Semua instans Amazon EC2 yang didukung yang diluncurkan AWS dari AMI Windows Server 2022 dan Windows Server 2025 menyertakan agen peluncuran EC2launch v2 () secara default. `EC2Launch.exe` Kami juga menyediakan AMI Windows Server 2016 dan 2019 dengan EC2launch v2 yang diinstal sebagai agen peluncuran default. AMI ini disediakan selain AMI Windows Server 2016 dan 2019 yang menyertakan EC2launch v1. Anda dapat mencari AMI Windows yang menyertakan EC2Launch v2 secara default dengan memasukkan prefiks berikut dalam pencarian Anda dari halaman **AMI** di konsol Amazon EC2: `EC2LaunchV2-Windows_Server-*`.
Untuk membandingkan fitur versi agen peluncuran, lihat[Bandingkan agen EC2 peluncuran Amazon](configure-launch-agents.md#ec2launch-agent-compare).
EC2Launch v2 melakukan tugas-tugas selama startup instans dan berjalan jika sebuah instans dihentikan dan kemudian dimulai, atau dimulai ulang. EC2Launch v2 juga dapat melakukan tugas sesuai permintaan. Beberapa dari tugas ini diaktifkan secara otomatis, sementara yang lainnya harus diaktifkan secara manual. Layanan EC2Launch v2 mendukung semua fitur EC2Config dan EC2Launch.
Layanan ini menggunakan file konfigurasi untuk mengontrol operasinya. Anda dapat memperbarui file konfigurasi dengan menggunakan alat grafis atau dengan mengeditnya secara langsung sebagai file .yml tunggal (`agent-config.yml`). Untuk informasi selengkapnya tentang lokasi file, lihat[Struktur direktori EC2Launch v2](#ec2launch-v2-directory).
EC2Launch v2 menerbitkan log peristiwa Windows untuk membantu Anda memecahkan masalah kesalahan dan mengatur pemicu. Untuk informasi selengkapnya, lihat [Log peristiwa Windows](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Versi OS yang didukung**
Agen EC2launch v2 mendukung versi sistem operasi (OS) Windows Server berikut:
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (Saluran dan Semi-Annual Saluran Long-Term Layanan)
+ Windows Server 2016
**Tugas yang dijalankan secara default**
Agen EC2launch v2 menjalankan tugas-tugas berikut hanya satu kali secara default selama peluncuran instance awal. Tugas diatur sesuai dengan urutan di mana mereka berjalan dalam tahap peluncuran mereka.
`Boot`panggung
+ memperpanjang RootPartition
`PreReady`panggung
+ activateWindows
+ set DnsSuffix
+ set AdminAccount
+ setWallpaper
`PostReady`panggung
+ startSsm
## Konsep EC2Launch v2
Konsep berikut berguna untuk dipahami saat mempertimbangkan EC2Launch v2.
**agen-konfigurasi**
`agent-config` adalah file yang terletak di folder konfigurasi untuk EC2Launch v2. Ini termasuk konfigurasi untuk boot, jaringanPreReady, dan PostReady tahapan. File ini digunakan untuk menentukan konfigurasi instans untuk tugas-tugas yang harus dijalankan saat AMI di-boot untuk pertama kali atau untuk waktu-waktu berikutnya.
Secara default, instalasi EC2Launch v2 menginstal file `agent-config` yang mencakup konfigurasi yang direkomendasikan yang digunakan dalam AMI Amazon Windows standar. Anda dapat memperbarui file konfigurasi untuk mengubah pengalaman boot default untuk AMI Anda yang ditentukan EC2Launch v2. Untuk informasi selengkapnya tentang lokasi file, lihat[Struktur direktori EC2Launch v2](#ec2launch-v2-directory).
**Frekuensi**
Frekuensi tugas menentukan kapan tugas harus dijalankan, tergantung pada konteks boot. Sebagian besar tugas hanya memiliki satu frekuensi yang diizinkan. Anda dapat menentukan frekuensi untuk tugas `executeScript`.
Anda akan melihat frekuensi berikut di [Konfigurasi EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Once - Tugas dijalankan sekali, saat AMI telah boot untuk pertama kali (selesai Sysprep).
+ Selalu — Tugas berjalan setiap kali agen peluncuran berjalan. Agen peluncuran berjalan saat:
+ sebuah instans dimulai atau dimulai ulang
+ layanan EC2Launch berjalan
+ `EC2Launch.exe run` diinvokasi
**Panggung**
Tahap adalah pengelompokan logis dari tugas yang dijalankan agen EC2Launch v2. Beberapa tugas hanya dapat dijalankan dalam tahap tertentu. Yang lain dapat berjalan dalam beberapa tahap. Saat menggunakan `agent-config.yml`, Anda harus menentukan daftar tahapan, dan daftar tugas untuk dijalankan dalam setiap tahap.
Layanan berjalan tahapan dalam urutan sebagai berikut:
Tahap 1: Boot
Tahap 2: Jaringan
Tahap 3: PreReady
Windows sudah siap
Setelah PreReady tahap selesai, layanan mengirimkan `Windows is ready` pesan ke konsol Amazon EC2.
Tahap 4: PostReady
Data pengguna berjalan selama *PostReady*tahap. Beberapa versi skrip berjalan sebelum *PostReady*tahap `agent-config.yml` file, dan beberapa berjalan setelahnya, sebagai berikut:
Sebelum `agent-config.yml`
+ Data pengguna YAML versi 1.1
+ Data pengguna XML
Setelah `agent-config.yml`
+ Data pengguna YAMB versi 1.0 (versi warisan untuk kompatibilitas mundur)
Untuk contoh tahapan dan tugas, lihat [Contoh: `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Saat Anda menggunakan data pengguna, Anda harus menentukan daftar tugas agar agen peluncuran dijalankan. Panggung tersirat. Untuk contoh tugas, lihat [Contoh: data pengguna](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2launch v2 menjalankan daftar tugas dalam urutan yang Anda tentukan dalam `agent-config.yml` dan dalam data pengguna. Tahapan berjalan secara berurutan. Tahap selanjutnya dimulai setelah tahap sebelumnya selesai. Tugas juga berjalan secara berurutan.
**Tugas**
Anda dapat menginvokasi tugas untuk melakukan tindakan pada sebuah instans. Anda dapat mengonfigurasi tugas dalam file `agent-config.yml` atau melalui data pengguna. [Untuk daftar tugas yang tersedia untuk EC2Launch v2, lihat Tugas EC2Launch v2.](#ec2launch-v2-tasks) Untuk skema konfigurasi tugas dan detailnya, lihat [Konfigurasi EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Data pengguna**
Data pengguna adalah data yang dapat dikonfigurasi saat Anda meluncurkan sebuah instans. Anda dapat memperbarui data pengguna agar secara dinamis mengubah bagaimana AMI kustom atau AMI mulai cepat dikonfigurasi. EC2Launch v2 mendukung panjang input data pengguna 60 kB. Data pengguna hanya mencakup UserData tahap, dan karena itu berjalan setelah `agent-config` file. Anda dapat memasukkan data pengguna ketika Anda meluncurkan sebuah instans menggunakan wizard peluncuran instans, atau Anda dapat memodifikasi data pengguna dari konsol EC2. Untuk informasi lebih lanjut tentang bekerja dengan data pengguna, lihat [Bagaimana Amazon EC2 menangani data pengguna untuk instans Windows](user-data.md#ec2-windows-user-data).
## Ikhtisar tugas EC2launch v2
EC2Launch v2 dapat melakukan tugas berikut di setiap boot:
+ Siapkan wallpaper baru dan yang disesuaikan secara opsional yang menyajikan informasi tentang instans.
+ Setel atribut untuk akun administrator yang dibuat di mesin lokal.
+ Tambahkan sufiks DNS ke daftar sufiks pencarian. Hanya sufiks yang belum ada yang ditambahkan ke daftar.
+ Atur huruf drive untuk volume tambahan dan perluas untuk menggunakan ruang yang tersedia.
+ Tulis file dari konfigurasi ke disk.
+ Jalankan skrip yang ditentukan dalam file konfigurasi EC2launch v2 atau dari. `user-data` Skrip dari `user-data` dapat berupa teks biasa atau zip dan disediakan sebagai format base64.
+ Jalankan program dengan argumen yang diberikan.
+ Tetapkan nama komputer.
+ Kirim informasi instans ke konsol Amazon EC2.
+ Kirim sidik jari sertifikat RDP ke konsol Amazon EC2.
+ Secara dinamis, perluas partisi sistem operasi untuk menyertakan ruang yang tidak dipartisi.
+ Jalankan data pengguna. Untuk informasi selengkapnya tentang menentukan data pengguna, lihat [Konfigurasi EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Setel rute statis non-persisten untuk menjangkau layanan metadata dan server. AWS KMS
+ Setel partisi non-boot ke `mbr` atau. `gpt`
+ Mulai layanan Systems Manager setelah Sysprep.
+ Optimalkan pengaturan ENA.
+ Aktifkan OpenSSH untuk versi Windows yang lebih baru.
+ Aktifkan Jumbo Frame.
+ Atur Sysprep untuk menjalankan EC2Launch v2.
+ Publikasikan log peristiwa Windows.
## Struktur direktori EC2Launch v2
EC2Launch v2 harus diinstal di direktori berikut:
+ Biner layana: `%ProgramFiles%\Amazon\EC2Launch`
+ Data layanan (pengaturan, file log, dan file statu): `%ProgramData%\Amazon\EC2Launch`
**catatan**
Secara default, Windows menyembunyikan file dan folder dalam `C:\ProgramData`. Untuk melihat direktori dan file EC2Launch v2, Anda harus memasukkan jalur di Windows Explorer atau ubah properti folder untuk menampilkan file dan folder tersembunyi.
Direktori `%ProgramFiles%\Amazon\EC2Launch` berisi binari dan pustaka pendukung. Ini mencakup subdirektori berikut:
+ `settings`
+ `EC2LaunchSettingsUI.exe`— antarmuka pengguna untuk memodifikasi file `agent-config.yml`
+ `YamlDotNet.dll`— DLL untuk mendukung beberapa operasi di antarmuka pengguna
+ `tools`
+ `ebsnvme-id.exe`— alat untuk memeriksa metadata volume EBS pada instance
+ `AWSAcpiSpcrReader.exe`— alat untuk menentukan port COM yang benar untuk digunakan
+ `EC2LaunchEventMessage.dll`- DLL untuk mendukung pencatatan peristiwa Windows untuk EC2launch
+ `service`
+ `EC2LaunchService.exe`— Layanan Windows yang dapat dieksekusi yang diluncurkan ketika agen peluncuran berjalan sebagai layanan
+ `EC2AgentTelemetry.dll`- DLL untuk mendukung telemetri agen EC2
+ `EC2Launch.exe`— EC2Launch utama yang dapat dieksekusi
+ `EC2LaunchAgentAttribution.txt`— atribusi untuk kode yang digunakan dalam Peluncuran EC2
Direktori `%ProgramData%\Amazon\EC2Launch` berisi subdirektori berikut. Semua data yang dihasilkan oleh layanan, termasuk log, konfigurasi, dan status, disimpan di direktori ini.
+ `config`— Konfigurasi
File konfigurasi layanan disimpan dalam direktori ini sebagai `agent-config.yml`. File ini dapat diperbarui untuk mengubah, menambah, atau menghapus tugas default yang dijalankan oleh layanan. Izin untuk membuat file di direktori ini dibatasi untuk akun administrator untuk mencegah eskalasi hak istimewa.
+ `log`— Log contoh
Log untuk service (`agent.log`) dan telemetry (`telemetry.log`) disimpan dalam direktori ini. Ketika `agent.log` mencapai ukuran 1 MB, itu secara otomatis diputar dan file cadangan dibuat dengan format stempel waktu (misalnya,). `agent-2026-03-02T18-56-39.188.log` Hanya satu file log cadangan yang dipertahankan pada satu waktu.
+ `state`— Data status layanan
Status yang digunakan layanan untuk menentukan tugas mana yang harus dijalankan disimpan di sini. Ada sebuah file `.run-once` yang menunjukkan apakah layanan telah dijalankan setelah Sysprep (jadi tugas dengan frekuensi sekali akan dilewati pada proses berikutnya). Subdirektori ini mencakup `state.json` dan `previous-state.json` untuk melacak status setiap tugas.
+ `sysprep`— Sysprep
Direktori ini berisi file yang digunakan untuk menentukan operasi mana yang akan dilakukan oleh Sysprep saat membuat AMI Windows kustom yang dapat digunakan kembali.
+ `wallpaper`— Wallpaper
Gambar wallpaper ini disimpan di direktori ini.
## Telemetri
Telemetri adalah informasi tambahan yang membantu AWS untuk lebih memahami kebutuhan Anda, mendiagnosis masalah, dan memberikan fitur untuk meningkatkan pengalaman Anda. Layanan AWS
EC2Launch v2 versi `2.1.592` dan setelahnya mengumpulkan telemetri, seperti metrik penggunaan dan kesalahan. Data ini dikumpulkan dari instans Amazon EC2 tempat EC2Launch v2 dijalankan. Ini termasuk semua AMI Windows yang dimiliki oleh AWS.
Tipe telemetri berikut dikumpulkan oleh EC2Launch v2:
+ **Informasi penggunaan** — perintah agen, metode penginstalan, dan frekuensi eksekusi terjadwal.
+ **Kesalahan dan informasi diagnostik** - kode kesalahan instalasi agen, jalankan kode kesalahan, dan tumpukan panggilan kesalahan.
Contoh data yang dikumpulkan dari versi 2.0.592 hingga 2.1.1:
```
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentErrorLocation=addroutes.go:49
```
Dimulai dengan versi 2.2.63, data telemetri Agen EC2 diformat sebagai objek JSON:
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
Telemetri tidak diaktifkan secara default. Anda dapat menonaktifkan kumpulan telemetri kapan saja.
**Menonaktifkan telemetri pada sebuah instans**
Untuk menonaktifkan telemetri untuk satu instans, Anda dapat mengatur variabel lingkungan sistem, atau menggunakan MSI untuk memodifikasi instalasi.
Untuk menonaktifkan telemetri dengan menyetel variabel lingkungan sistem, jalankan perintah berikut sebagai administrator.
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Untuk menonaktifkan telemetri menggunakan MSI, jalankan perintah berikut setelah Anda [mengunduh](ec2launch-v2-install.md) MSI.
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [Konsep EC2Launch v2](#ec2launch-v2-concepts)
+ [Ikhtisar tugas EC2launch v2](#ec2launch-v2-tasks)
+ [Struktur direktori EC2Launch v2](#ec2launch-v2-directory)
+ [Telemetri](#ec2launch-v2-telemetry)
+ [Instal versi terbaru EC2 Launch v2](ec2launch-v2-install.md)
+ [Konfigurasikan pengaturan EC2launch v2 untuk instance Windows](ec2launch-v2-settings.md)
+ [Definisi tugas untuk tugas startup EC2 Launch v2](ec2launch-v2-task-definitions.md)
+ [Memecahkan masalah dengan agen EC2launch v2](ec2launchv2-troubleshooting.md)
+ [Riwayat versi EC2Launch v2](ec2launchv2-versions.md)