View a markdown version of this page

Gunakan agen EC2launch v2 untuk melakukan tugas selama peluncuran instans Windows EC2 - Amazon Elastic Compute Cloud
Konsep EC2Launch v2Ikhtisar tugas EC2launch v2Struktur direktori EC2Launch v2Telemetri

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, lihatBandingkan agen EC2 peluncuran Amazon.

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, lihatStruktur direktori EC2Launch v2.

EC2Launch v2 menerbitkan log peristiwa Windows untuk membantu Anda memecahkan masalah kesalahan dan mengatur pemicu. Untuk informasi selengkapnya, lihat Log peristiwa Windows.

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.

Bootpanggung

  • memperpanjang RootPartition

PreReadypanggung

  • activateWindows

  • set DnsSuffix

  • set AdminAccount

  • setWallpaper

PostReadypanggung

  • 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, lihatStruktur direktori EC2Launch v2.

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.

  • 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 PostReadytahap. Beberapa versi skrip berjalan sebelum PostReadytahap 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.

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 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. Untuk skema konfigurasi tugas dan detailnya, lihat Konfigurasi EC2Launch v2.

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.

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.

  • 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 MSI. 

msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
Topik lainnya untuk EC2launch v2