View a markdown version of this page

Gunakan agen EC2launch v1 untuk melakukan tugas selama peluncuran instance EC2 Windows - Amazon Elastic Compute Cloud
Tugas EC2LaunchStruktur direktori EC2LaunchTelemetri

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Gunakan agen EC2launch v1 untuk melakukan tugas selama peluncuran instance EC2 Windows

AMI yang dikelola Amazon untuk Windows Server 2016 dan 2019 menyertakan satu set skrip Windows Powershell yang disebut EC2launch. EC2Launch melakukan tugas selama boot instans awal. Untuk informasi tentang versi EC2Launch yang disertakan dalam AMI AWS Windows, lihat Referensi AMI AWS Windows.

catatan

Agen peluncuran terbaru untuk Windows Server 2016 dan versi sistem operasi yang lebih baru adalah EC2launch v2, yang menggantikan EC2config dan EC2launch, dan hadir pra-instal di AMI AWS Windows Server 2016 dan 2019 dengan nama yang dimulai dengan. EC2LaunchV2-Windows_Server-* Anda juga dapat menginstal dan mengkonfigurasi agen secara manual di Windows Server 2016 dan 2019. Untuk informasi selengkapnya, lihat Instal EC2launch v2.

Untuk menggunakan EC2launch dengan IMDSv2, versinya harus 1.3.2002730 atau setelahnya.

Anda dapat menggunakan PowerShell perintah Windows berikut untuk memverifikasi versi EC2launch yang diinstal.

Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

Tugas EC2Launch

EC2Launch melakukan tugas berikut secara default selama boot instans awal:

  • Siapkan wallpaper baru yang menampilkan informasi tentang instans.

  • Menetapkan nama komputer ke alamat IPv4 pribadi dari instance.

  • Mengirimkan informasi instans ke konsol Amazon EC2.

  • Mengirim sidik jari sertifikat RDP ke konsol EC2.

  • Mengatur kata sandi acak untuk akun administrator.

  • Menambahkan sufiks DNS.

  • Secara dinamis memperluas partisi sistem operasi untuk menyertakan ruang yang tidak dipartisi.

  • Menjalankan data pengguna (jika ditentukan). Untuk informasi selengkapnya tentang menentukan data pengguna, lihat Jalankan perintah saat Anda meluncurkan instance EC2 dengan input data pengguna.

  • Mengatur rute statis persisten untuk menjangkau layanan metadata dan server AWS KMS .

    penting

    Jika AMI kustom dibuat dari instans ini, rute ini diambil sebagai bagian dari konfigurasi OS dan setiap instans baru yang diluncurkan dari AMI akan mempertahankan rute yang sama, terlepas dari penempatan subnet. Untuk memperbarui rute, lihatPerbarui metadata/KMS rute untuk Server 2016 dan yang lebih baru saat meluncurkan AMI khusus.

Tugas berikut membantu menjaga kompatibilitas ke belakang dengan file layanan EC2Config. Anda juga dapat mengonfigurasi EC2Launch untuk melakukan tugas-tugas ini selama startup:

  • Inisialisasi volume EBS sekunder.

  • Kirim log Peristiwa Windows ke log konsol EC2.

  • Kirim pesan siap digunakan Windows ke konsol EC2.

Struktur direktori EC2Launch

EC2Launch diinstal secara default di Windows Server 2016 dan AMI setelahnya di direktori root C:\ProgramData\Amazon\EC2-Windows\Launch.

catatan

Secara default, Windows menyembunyikan file dan folder dalam C:\ProgramData. Untuk melihat direktori dan file EC2Launch, Anda harus mengetikkan jalur di Windows Explorer atau ubah properti folder untuk menampilkan file dan folder tersembunyi.

Direktori Launch berisi subdirektori berikut.

  • Scripts- Berisi PowerShell skrip yang membentuk EC2launch.

  • Module — Berisi modul untuk membangun skrip yang terkait dengan Amazon EC2.

  • Config — Berisi file konfigurasi skrip yang dapat Anda sesuaikan.

  • Sysprep — Berisi sumber daya Sysprep.

  • Settings — Berisi aplikasi untuk antarmuka pengguna grafis Sysprep.

  • Library — Berisi pustaka bersama untuk agen peluncuran EC2.

  • Log- Berisi subdirektori untuk skrip dan file log yang dihasilkan oleh skrip.

Telemetri

Telemetri adalah informasi tambahan yang membantu AWS memahami kebutuhan Anda dengan lebih baik, mendiagnosis masalah, dan memberikan fitur untuk meningkatkan pengalaman Anda dengan AWS layanan.

EC2launch versi 1.3.2003498 dan setelahnya mengumpulkan telemetri, seperti metrik penggunaan dan kesalahan. Data ini dikumpulkan dari instans Amazon EC2 tempat EC2Launch berjalan. Ini termasuk semua AMI Windows yang dimiliki oleh AWS.

Tipe telemetri berikut dikumpulkan oleh EC2launch:

  • Informasi penggunaan — perintah agen, metode penginstalan, dan frekuensi eksekusi terjadwal.

  • Kesalahan dan informasi diagnostik - instalasi agen dan menjalankan kode kesalahan.

Contoh data yang dikumpulkan:

2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0

Telemetri tidak diaktifkan secara default. Anda dapat menonaktifkan kumpulan telemetri kapan saja. Jika telemetri diaktifkan, EC2launch v2 mengirimkan data telemetri tanpa notifikasi pelanggan tambahan.

Pilihan Anda untuk mengaktifkan atau menonaktifkan telemetri dikumpulkan.

Anda dapat memilih masuk atau keluar dari kumpulan telemetri. Pilihan Anda untuk mengikuti atau tidak mengikuti telemetri dikumpulkan untuk memastikan bahwa kami mematuhi opsi telemetri Anda.

Visibilitas telemetri

Saat telemetri diaktifkan, telemetri muncul di output konsol Amazon EC2 sebagai berikut:

2021/07/15 21:44:12Z: Telemetry: <Data>
Menonaktifkan telemetri pada sebuah instans

Untuk menonaktifkan telemetri dengan menyetel variabel lingkungan sistem, jalankan perintah berikut sebagai administrator:

setx /M EC2LAUNCH_TELEMETRY 0

Untuk menonaktifkan telemetri selama instalasi, jalankan install.ps1 sebagai berikut:

. .\install.ps1 -EnableTelemetry:$false
Topik lainnya untuk EC2launch