Utilizza l'agente EC2Launch v2 per eseguire attività durante l'avvio dell'istanza EC2 Windows - Amazon Elastic Compute Cloud
Concetti di EC2Launch v2Panoramica delle attività di EC2Launch v2Struttura della directory di EC2Launch v2Telemetria

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizza l'agente EC2Launch v2 per eseguire attività durante l'avvio dell'istanza EC2 Windows

Tutte le istanze supportate di Amazon EC2 che vengono avviate dalle AMI di Windows Server 2022 AWS e Windows Server 2025 includono l'agente di avvio EC2Launch v2 (EC2Launch.exe) di default. Forniamo inoltre le AMI di Windows Server 2016 e 2019 con EC2Launch v2 installato come agente di avvio di default. Queste AMI sono fornite in aggiunta alle AMI di Windows Server 2016 e 2019 che includono EC2Launch v1. È possibile cercare le AMI di Windows che includono EC2Launch v2 di default inserendo il seguente prefisso nella ricerca dalla pagina AMI nella console Amazon EC2: EC2LaunchV2-Windows_Server-*.

Per confrontare le funzionalità della versione dell'agente di avvio, consulta. Confronto degli agenti di avvio Amazon EC2

EC2Launch v2 esegue attività durante il startup dell'istanza e viene eseguito se un'istanza viene arrestata e successivamente avviata o se viene riavviata. EC2Launch v2 può anche eseguire attività on demand. Alcune di queste attività sono abilitate automaticamente, mentre altre devono essere abilitate manualmente. Il servizio EC2Launch v2 supporta tutte le caratteristiche di EC2Config ed EC2Launch.

Questo servizio utilizza un file di configurazione per controllarne il funzionamento. Puoi aggiornare il file di configurazione utilizzando uno strumento grafico o modificandolo direttamente come un singolo file .yml (agent-config.yml). Per ulteriori informazioni sulle posizioni dei file, consulta Struttura della directory di EC2Launch v2.

EC2Launch v2 pubblica i log di eventi di Windows per facilitare la risoluzione degli errori e l'impostazione dei trigger. Per ulteriori informazioni, consulta Log di eventi di Windows.

Versioni supportate del sistema operativo

L'agente EC2Launch v2 supporta le seguenti versioni del sistema operativo (OS) Windows Server:

  • Windows Server 2025

  • Windows Server 2022

  • Windows Server 2019 (canale di manutenzione a lungo termine e canale semestrale)

  • Windows Server 2016

Attività che vengono eseguite per impostazione predefinita

L’agente EC2Launch v2 esegue le seguenti attività una sola volta per impostazione predefinita durante l’avvio dell’istanza iniziale. Le attività vengono organizzate in base all’ordine in cui vengono eseguite nella fase di avvio.

Fase di Boot

  • extendRootPartition

Fase di PreReady

  • activateWindows

  • setDnsSuffix

  • setAdminAccount

  • setWallpaper

Fase di PostReady

  • startSsm

Concetti di EC2Launch v2

I seguenti concetti sono utili per capire quando utilizzare EC2Launch v2.

agent-config

agent-config è un file che si trova nella cartella di configurazione per EC2Launch v2. Include la configurazione per le fasi di avvio, rete, PreReady e PostReady. Questo file viene utilizzato per specificare la configurazione di un'istanza per le attività che devono essere eseguite quando l'AMI viene avviata per la prima volta o per le volte successive.

Di default, l'installazione di EC2Launch v2 installa un file agent-config che include le configurazioni consigliate utilizzate nelle AMI standard di Amazon Windows. Puoi aggiornare il file di configurazione per modificare l'esperienza di avvio predefinita per l'AMI specificata da EC2Launch v2. Per ulteriori informazioni sulle posizioni dei file, consulta Struttura della directory di EC2Launch v2.

Frequenza

La frequenza delle attività stabilisce quando le attività devono essere eseguite a seconda del contesto di avvio. La maggior parte delle attività ha una sola frequenza consentita. È possibile specificare una frequenza per le attività executeScript.

Vedrai le seguenti frequenze nella Configurazione dell'attività di EC2Launch v2.

  • Una volta: l'attività viene eseguita una volta, quando l'AMI viene avviata per la prima volta (Sysprep terminato).

  • Sempre: l'attività viene eseguita ogni volta che viene attivato l'agente di avvio. L'agente di avvio viene eseguito quando:

    • un'istanza viene avviata o riavviata

    • viene eseguito il servizio EC2Launch

    • EC2Launch.exe runviene richiamato

Stage

Una fase è un raggruppamento logico di attività eseguito dall'agente EC2Launch v2. Alcune attività possono essere eseguite solo in una fase specifica. Altre possono essere eseguite in più fasi. Quando utilizzi agent-config.yml, è necessario specificare un elenco di fasi e un elenco di attività da eseguire all'interno di ciascuna fase.

Il servizio esegue le fasi nel seguente ordine:

Fase 1: Avvio

Fase 2: Rete

Fase 3: PreReady

Windows è pronto

Una volta completata la fase di PreReady, il servizio invia il messaggio Windows is ready alla console Amazon EC2.

Fase 4: PostReady

I dati degli utenti vengono eseguiti durante la fase di PostReady. Alcune versioni degli script vengono eseguite prima della fase PostReady del file agent-config.yml, mentre altre vengono eseguite dopo, come di seguito:

Prima di agent-config.yml

  • Versione 1.1 dei dati utente in YAML

  • Dati utente XML

Dopo di agent-config.yml

  • Dati utente YAML versione 1.0 (versione legacy per compatibilità con le versioni precedenti)

Per le fasi e attività di esempio, consulta Esempio: agent-config.yml.

Quando utilizzi i dati utente, devi specificare un elenco di attività per l'esecuzione dell'agente di avvio. La fase è implicita. Per le attività di esempio, consulta Esempio: dati utente.

EC2Launch v2 esegue l'elenco delle attività nell'ordine specificato in agent-config.yml e nei dati utente. Le fasi vengono eseguite in sequenza. La fase successiva inizia dopo il completamento della fase precedente. Anche le attività vengono eseguite in sequenza.

Attività

Puoi richiamare un'attività per eseguire un'operazione su un'istanza. Puoi configurare le attività nel file agent-config.yml o tramite i dati utente. Per un elenco delle attività disponibili per EC2Launch v2, consulta Attività EC2Launch v2. Per lo schema di configurazione delle attività e informazioni dettagliate, consulta Configurazione dell'attività di EC2Launch v2.

Dati utente

I dati utente sono dati configurabili quando si avvia un'istanza. Puoi aggiornare i dati utente per modificare dinamicamente la modalità di configurazione delle AMI personalizzate o delle AMI di avvio rapido. EC2Launch v2 supporta una lunghezza di input dei dati utente di 60 kB. I dati utente includono solo lo stadio UserData e quindi vengono eseguiti dopo il file agent-config. È possibile immettere i dati utente quando si avvia un'istanza utilizzando la procedura guidata di avvio dell'istanza, oppure è possibile modificare i dati utente dalla console EC2. Per informazioni sull'utilizzo dei dati utente, consulta In che modo Amazon EC2 gestisce i dati degli utenti per le istanze Windows.

Panoramica delle attività di EC2Launch v2

EC2Launch v2 può eseguire ad ogni avvio le seguenti attività:

  • Impostare un nuovo sfondo personalizzato e facoltativo che esegue il rendering delle informazioni riguardanti l'istanza.

  • Impostare gli attributi per l'account amministratore creato nel computer locale.

  • Aggiungere i suffissi DNS all'elenco dei suffissi di ricerca. All'elenco vengono aggiunti solo i suffissi che non esistono già.

  • Impostare le lettere di unità per eventuali volumi aggiuntivi ed estenderli per utilizzare lo spazio disponibile.

  • Scrivi i file dalla configurazione sul disco.

  • Esegui gli script specificati nel file di configurazione EC2Launch v2 o da user-data. Gli script da user-data possono essere in testo semplice o compressi e forniti in formato base64.

  • Eseguire un programma con argomenti specificati.

  • Impostare il nome del computer.

  • Inviare le informazioni sull'istanza alla console Amazon EC2.

  • Inviare l'impronta del certificato RDP alla console Amazon EC2.

  • Estendere in modo dinamico la partizione del sistema operativo per includere qualsiasi spazio non partizionato.

  • Eseguire i dati utente. Per ulteriori informazioni sulla specifica dei dati utente, consulta Configurazione dell'attività di EC2Launch v2.

  • Imposta istradamenti statici non persistenti per raggiungere il servizio metadati e i server AWS KMS.

  • Impostare le partizioni non di avvio su mbr o gpt.

  • Avviare il servizio Systems Manager dopo Sysprep.

  • Ottimizzare le impostazioni ENA.

  • Abilitare OpenSSH per le versioni successive di Windows.

  • Abilitare i frame jumbo.

  • Impostare Sysprep per l'esecuzione con EC2Launch v2.

  • Pubblicare i log di eventi di Windows.

Struttura della directory di EC2Launch v2

EC2Launch v2 deve essere installato nelle seguenti directory:

  • Binari del servizio: %ProgramFiles%\Amazon\EC2Launch

  • Dati del servizio (impostazioni, file di log e file di stato): %ProgramData%\Amazon\EC2Launch

Nota

Per impostazione predefinita, Windows nasconde i file e le cartelle in C:\ProgramData. Per visualizzare le directory e i file di EC2Launch v2 devi digitare il percorso in Esplora risorse di Windows o modificare le proprietà della cartella per visualizzare i file e le cartelle nascosti.

La directory %ProgramFiles%\Amazon\EC2Launch contiene binari e librerie di supporto. Include le seguenti sottodirectory:

  • settings

    • EC2LaunchSettingsUI.exe: interfaccia utente per la modifica del file agent-config.yml

    • YamlDotNet.dll: DLL per supportare alcune operazioni nell’interfaccia utente

  • tools

    • ebsnvme-id.exe: strumento per esaminare i metadati dei volumi EBS nell’istanza

    • AWSAcpiSpcrReader.exe: strumento per determinare la porta COM corretta da utilizzare

    • EC2LaunchEventMessage.dll: DLL per supportare il log di eventi di Windows per EC2Launch

  • service

    • EC2LaunchService.exe: eseguibile del servizio Windows che viene avviato quando l’agente di avvio viene attivato come servizio

  • EC2AgentTelemetry.dll: DLL per il supporto della telemetria degli agenti EC2

  • EC2Launch.exe: eseguibile principale EC2launch

  • EC2LaunchAgentAttribution.txt: attribuzione per il codice utilizzato in EC2 Launch

La directory %ProgramData%\Amazon\EC2Launch contiene le sottodirectory seguenti. Tutti i dati prodotti dal servizio, inclusi i log, la configurazione e lo stato, vengono memorizzati in questa directory.

  • config – Configurazione

    Il file di configurazione del servizio è memorizzato in questa directory come agent-config.yml. Questo file può essere aggiornato per modificare, aggiungere o rimuovere le attività predefinite eseguite dal servizio. L'autorizzazione per creare file in questa directory è limitata all'account di amministratore per evitare l'escalation dei privilegi.

  • log – Log delle istanze

    I log per il servizio (agent.log), la console (console.log), le prestazioni (bench.log), gli errori (err.log) e la telemetria (telemetry.log) sono memorizzati in questa directory. I file di log vengono aggiunti alle successive esecuzioni del servizio.

  • state – Dati sullo stato del servizio

    Qui viene memorizzato lo stato utilizzato dal servizio per determinare quali attività devono essere eseguite. Esiste un file .run-once che indica se il servizio è già stato eseguito dopo Sysprep (quindi le attività con la frequenza di una volta vengono ignorate all'esecuzione successiva). Questa sottodirectory include state.json e previous-state.json per tenere traccia dello stato di ogni attività.

  • sysprep – Sysprep

    Questa directory contiene i file utilizzati per determinare le operazioni eseguite da Sysprep quando crea un'AMI di Windows personalizzata che può essere riutilizzata.

  • wallpaper – Sfondo

    Queste immagini di sfondo sono memorizzate in questa directory.

Telemetria

La telemetria offre informazioni aggiuntive che consentono ad AWS di comprendere meglio i tuoi requisiti, diagnosticare i problemi e fornire funzionalità per migliorare la tua esperienza con i Servizi AWS.

EC2Launch v2 versione 2.1.592 e successive raccolgono dati di telemetria, ad esempio parametri ed errori di utilizzo. Questi dati vengono raccolti dall'istanza Amazon EC2 in cui viene eseguito EC2Launch v2. Sono incluse tutte le AMI di Windows di proprietà di AWS.

I seguenti tipi di telemetria vengono raccolti da EC2Launch v2:

  • Informazioni di utilizzo: comandi dell'agente, metodo di installazione e frequenza di esecuzione pianificata.

  • Errori e informazioni diagnostiche – Codici di errore di installazione dell'agente, esecuzione dei codici di errore e stack di chiamate di errore.

Esempi di dati raccolti dalla versione 2.0.592 alla versione 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

A partire dalla versione 2.2.63, i dati telemetrici dell’agente EC2 sono formattati come oggetto JSON:

{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }

La telemetria è abilitata per impostazione predefinita. Puoi disabilitare la raccolta dati di telemetria in qualsiasi momento.

Disabilitare la telemetria su un'istanza

Per disattivare la telemetria per una singola istanza, puoi impostare una variabile di ambiente di sistema oppure utilizzare MSI per modificare l'installazione.

Per disattivare la telemetria impostando una variabile di ambiente di sistema, esegui il comando seguente come amministratore.

setx /M EC2LAUNCH_TELEMETRY 0

Per disabilitare la telemetria utilizzando MSI, esegui il comando seguente dopo il download dell'MSI. 

msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
Altri argomenti per EC2Launch v2