Installare la versione più recente di EC2Launch v2

Puoi utilizzare uno dei seguenti metodi per installare l'agente EC2Launch v2 sulla tua istanza EC2:

Per l'installazione, seleziona la scheda corrispondente al tuo metodo preferito.

Windows PowerShell

Per installare la versione più recente dell'agente v2 con Windows PowerShell, segui questi passaggi.

1. Crea la tua directory locale.

   New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory

2. Imposta l'URL per la posizione di download. Esegui il comando seguente con l'URL Amazon S3 che utilizzerai. Per gli URL dei download, consulta Download di EC2Launch v2 su Amazon S3.

   $Url = "Amazon S3 URL/AmazonEC2Launch.msi"

3. Utilizza il seguente comando composito per scaricare l'agente e avviare l'installazione

   $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
   Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
   msiexec /i "$DownloadFile"

   Nota

   Quando viene visualizzato un messaggio di errore durante il download del file con Windows Server 2016 o versioni precedenti, potrebbe essere necessario abilitare TLS 1.2 per il terminale PowerShell. È possibile abilitare TLS 1.2 per la sessione corrente di PowerShell con il seguente comando e riprovare:

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

4. Il comando msiexec installa EC2Launch v2 nella seguente posizione nelle istanze Windows Server %ProgramFiles%\Amazon\EC2Launch. Per verificare che l'installazione sia stata eseguita, è possibile verificare il file system locale dell'istanza.

AWS Systems Manager Distributor

Per configurare gli aggiornamenti automatici per EC2Launch v2 con Configurazione rapida di AWS Systems Manager, consultare Installazione e aggiornamento automatici con Configurazione rapida di Distributor.

È anche possibile eseguire un'installazione una tantum del pacchetto AWSEC2Launch-Agent da AWS Systems Manager Distributor. Per istruzioni su come installare un pacchetto da System Manager Distributor, consulta Installazione o pacchetti di aggiornamento nella AWS Systems ManagerGuida per l'utente.

EC2 Image Builder component

Quando si costruisce un'immagine personalizzata con EC2 Image Builder, è possibile installare il componente ec2launch-v2-windows. Per istruzioni su come creare un'immagine personalizzata con EC2 Image Builder, vedi Creazione di una pipeline di immagini utilizzando la procedura guidata della console EC2 Image Builder nellaGuida per l'utente di EC2 Image Builder.

AMI

Per impostazione predefinita, EC2Launch v2 è preinstallato sulle AMI per i sistemi operativi Windows Server 2022 e successivi:

• Windows_Server-versione-English-Full-Base

• Windows_Server-versione-English-Core-Base

• Windows_Server-versione-English-Core-EKS_Optimized

• AMI di Windows Server versione con tutte le altre lingue

• AMI di Windows Server versione con SQL installato

EC2Launch è inoltre preinstallato sulle seguenti AMI Windows Server. Puoi trovare queste AMI dalla console Amazon EC2 oppure utilizzando il seguente prefisso di ricerca EC2LaunchV2- nel AWS CLI.

• EC2LaunchV2_Preview-Windows_Server-2019-English-Core-Base

• EC2LaunchV2_Preview-Windows_Server-2019-English-Full-Base

• EC2LaunchV2_Preview-Windows_Server-2016-English-Core-Base

• EC2LaunchV2_Preview-Windows_Server-2016-English-Full-Base

Installazione e aggiornamento automatici di EC2Launch v2 con Configurazione rapida di AWS Systems Manager Distributor

Con Configurazione rapida di AWS Systems Manager Distributor, è possibile configurare aggiornamenti automatici di EC2Launch v2. La seguente procedura configura Systems Manager Association sull'istanza affinché aggiorni automaticamente l'agente EC2Launch v2 alla frequenza specificata. L'associazione creata da Configurazione rapida di Distributor può includere istanze all'interno di un Account AWS e una regione, oppure all'interno di un'organizzazione AWS. Per ulteriori informazioni sulla configurazione di un'organizzazione, consultare Tutorial: creazione e configurazione di un'organizzazione nella Guida per l'utente di AWS Organizations.

Prima di iniziare, è necessario assicurarsi che le istanze soddisfino tutti i prerequisiti.

Prerequisiti

Per configurare aggiornamenti automatici con Configurazione rapida di Distributor, le istanze devono soddisfare i seguenti prerequisiti.

Impostare Configurazione rapida di Distributor per EC2Launch v2

Per creare una configurazione per EC2Launch v2 con Configurazione rapida di Distributor, utilizzare le seguenti impostazioni quando si completa la procedura per l'implementazione del pacchetto Distributor:

Per verificare lo stato della configurazione, accedere alla scheda Configurazioni di Configurazione rapida di Systems Manager nella AWS Management Console.

Per ulteriori informazioni e procedure di risoluzione dei problemi, consultare Risoluzione dei problemi dei risultati di Configurazione rapida nella Guida per l'utente di AWS Systems Manager.

Download di EC2Launch v2 su Amazon S3

Per installare la versione più recente di EC2Launch v2, scarica l'installer dai seguenti percorsi:

Configurazione delle opzioni di installazione

Durante l'installazione o l'aggiornamento di EC2Launch v2, puoi configurare le opzioni di installazione con la finestra di installazione di EC2Launch v2 o con il msiexeccomando in una shell a riga di comando.

Alla prima esecuzione su un'istanza di EC2Launch v2, inizializza le impostazioni dell'agente di avvio sull'istanza come segue:

Per i dettagli della configurazione, seleziona la scheda che corrisponde al metodo di configurazione che utilizzerai.

Amazon EC2Launch Setup dialog

Quando installi o aggiorni EC2Launch v2, puoi configurare le seguenti opzioni di installazione tramite la finestra di dialogo di installazione di EC2Launch v2.

Opzioni Installazione di base

Invia telemetria

Se includi questa funzionalità nella finestra di configurazione, l'installatore imposta la EC2LAUNCH_TELEMETRY variabile di ambiente con un valore di1. Se disabiliti Invia telemetria, l'installatore imposta la variabile di ambiente su un valore di 0.

Quando l'agente EC2Launch v2 è in esecuzione, legge laEC2LAUNCH_TELEMETRY variabile di ambiente per determinare se caricare dati di telemetria. Se il valore è 1, carica i dati. Altrimenti, non li carica.

Configurazione di default

La configurazione predefinita per EC2Launch v2 consiste nel sovrascrivere l'agente di avvio locale se già esistente. La prima volta che esegui un'installazione su un'istanza, la configurazione predefinita esegue un'installazione pulita. Se disattivi la configurazione predefinita nell'installazione iniziale, l'installazione non riesce.

Se esegui nuovamente l'installazione sull'istanza, puoi disabilitare la configurazione predefinita per eseguire un aggiornamento che non sostituisca il file %ProgramData%/Amazon/EC2Launch/config/agent-config.yml.

Esempio: installazione di EC2Launch v2 con telemetria

L'esempio seguente mostra la finestra di configurazione di EC2Launch v2 configurata per aggiornare l'installazione corrente e abilitare la telemetria. Questa configurazione esegue un'installazione senza sostituire il file di configurazione dell'agente e imposta la EC2LAUNCH_TELEMETRY variabile di ambiente al valore 1.

Command line

Quando installi o aggiorni EC2Launch v2, puoi configurare le seguenti opzioni di installazione con il comando msiexec in una shell a riga di comando.

ADDLOCALValori parametri

Base (richiesto)

Installa l'agente di avvio. Se questo valore non è presente nel parametro ADDLOCAL l'installazione termina.

Elimina

Quando includi il valore Clean nel parametro ADDLOCAL, l'installatore scrive il file di configurazione dell'agente nella seguente posizione:%ProgramData%/Amazon/EC2Launch/config/agent-config.yml. Se il file di configurazione dell'agente esiste già, lo sovrascrive.

Se lasci il valore Clean al di fuori del parametro ADDLOCAL, l'installatore esegue un aggiornamento che non sostituisce il file di configurazione dell'agente.

Telemetria

Se includi il valore Telemetry nel parametro ADDLOCAL, l'installatore imposta la variabile di ambiente EC2LAUNCH_TELEMETRY a un valore di 1.

Se lasci il valore Telemetry al di fuori del parametro ADDLOCAL, l'installatore imposta la variabile di ambiente a valore di 0.

Quando l'agente EC2Launch v2 è in esecuzione, legge laEC2LAUNCH_TELEMETRY variabile di ambiente per determinare se caricare dati di telemetria. Se il valore è 1, carica i dati. Altrimenti, non li carica.

Esempio: installazione di EC2Launch v2 con telemetria

& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q

Verifica la versione EC2Launch v2

Utilizzare la procedura seguente per verificare la versione di EC2Launch v2 installata sulle istanze.

Windows PowerShell

Verifica la versione installata di EC2Launch v2 con PowerShell di Windows.

1. Lancia un'istanza dall'AMI e connettila.

2. Utilizzare il seguente comando in PowerShell per verificare la versione installata di EC2Launch v2

   & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version

Windows Control Panel

Verifica la versione installata di EC2Launch v2 nel Pannello di Controllo di Windows come segue:

1. Lancia un'istanza dall'AMI e connettila.

2. Apri il Pannello di Controllo e scegli Programmi e funzionalità.

3. Nella lista dei programmi installati, cerca Amazon EC2Launch. Il numero della versione viene mostrato nella colonna Version (Versione).

Per visualizzare gli aggiornamenti più recenti delle AMI Windows AWS, consultare la cronologia delle versioni di Windows AMI nel Riferimento Windows AMI AWS.

Per la versione più recente di EC2Launch v2, consulta Cronologia delle versioni di EC2Launch v2.

Per la versione più recente dello strumento di migrazione di EC2Launch v2, consulta Cronologia delle versioni dello strumento di migrazione di EC2Launch v2.

Puoi ricevere notifiche quando vengono rilasciate nuove versioni del servizio EC2Launch v2. Per ulteriori informazioni, consulta Sottoscrizione alle notifiche dell'agente di avvio EC2 Windows.