Installieren Sie die neueste Version von EC2 Launch v2

Sie können eine der folgenden Methoden verwenden, um den EC2 Launch v2-Agent auf Ihrer EC2 Instance zu installieren:

• Laden Sie den Agenten von Amazon S3 herunter und installieren Sie ihn mit Windows PowerShell. Informationen zum Herunterladen URLs finden Sie unterEC2Starten Sie v2-Downloads auf Amazon S3.

• Installation mit SSM-Distributor.

• Die Installation erfolgt über eine EC2 Image Builder Builder-Komponente, wenn Sie ein benutzerdefiniertes Image erstellen.

• Starten Sie Ihre Instance von einem AMI aus, auf dem EC2 Launch v2 vorinstalliert ist.

Warnung

Amazon EC2 Launch.msi deinstalliert frühere Versionen der EC2 Startdienste wie EC2 Launch (v1) und EC2 Config.

Wählen Sie für die Installationsschritte die Registerkarte aus, die Ihrer bevorzugten Methode entspricht.

Windows PowerShell

Gehen Sie wie folgt vor, um die neueste Version von EC2 Launch v2 Agent mit Windows PowerShell zu installieren.

1. Erstellen Sie Ihr lokales Verzeichnis.

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

2. Legen Sie die URL für Ihren Download-Speicherort fest. Führen Sie den folgenden Befehl mit der von Ihnen verwendeten Amazon-S3-URL aus. Informationen zum Herunterladen URLs finden Sie unter EC2Starten Sie v2-Downloads auf Amazon S3

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

3. Verwenden Sie den folgenden zusammengesetzten Befehl, um den Agenten herunterzuladen und die Installation auszuführen

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

   Anmerkung

   Wenn beim Herunterladen der Datei eine Fehlermeldung angezeigt wird und Sie Windows Server 2016 oder eine frühere Version verwenden, muss TLS 1.2 möglicherweise für Ihr PowerShell Terminal aktiviert werden. Sie können TLS 1.2 für die aktuelle PowerShell Sitzung mit dem folgenden Befehl aktivieren und es dann erneut versuchen:

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

4. msiexecMit dem Befehl wird EC2 Launch v2 auf Windows Server-Instanzen am folgenden Speicherort installiert:%ProgramFiles%\Amazon\EC2Launch. Um zu überprüfen, ob die Installation ausgeführt wurde, können Sie das lokale Dateisystem auf Ihrer Instance überprüfen.

AWS Systems Manager Distributor

Informationen zum Konfigurieren automatischer Updates für EC2 Launch v2 mit AWS Systems Manager Quick Setup finden Sie unterAutomatische Installation und Aktualisierung mit Distributor Quick Setup.

Sie können auch eine einmalige Installation desAWSEC2Launch-Agent-Pakets vom AWS Systems Manager -Distributor durchführen. Anweisungen zum Installieren eines Pakets vom Systems Manager Distributor finden Sie unter Installieren oder Aktualisieren von Paketen im AWS Systems Manager -Benutzerhandbuch.

EC2 Image Builder component

Sie können die ec2launch-v2-windows Komponente installieren, wenn Sie mit Image Builder ein benutzerdefiniertes EC2 Image erstellen. Anweisungen zum Erstellen eines benutzerdefinierten Images mit EC2 Image Builder finden Sie unter Erstellen einer Image-Pipeline mithilfe des EC2 Image Builder Builder-Konsolenassistenten im EC2 Image Builder Builder-Benutzerhandbuch.

AMI

EC2Launch v2 ist standardmäßig auf AMIs den Betriebssystemen Windows Server 2022 und höher vorinstalliert:

• Windows_Server- -Englisch- Vollversion version

• Windows_Server- version -Core-Base auf Englisch

• Windows_Server- version -Englisch-Core-EKS_optimiert

• Windows Server version AMIs mit allen anderen Sprachen

• Windows Server version AMIs mit installiertem SQL

EC2Launch v2 ist auch auf dem folgenden Windows Server AMIs vorinstalliert. Sie finden diese in AMIs der EC2 Amazon-Konsole oder mit dem folgenden Suchpräfix: EC2LaunchV2- in der AWS CLI.

• EC2Launchv2-Windows_Server-2019-English-Core-Base

• EC2Launchv2-Windows_Server-2019-Englisch — Vollversion

• EC2Starten Sie v2-Windows_Server-2016-English-Core-Base

• EC2Launchv2-Windows_Server-2016-Englisch — Vollversion

Installieren und aktualisieren Sie Launch v2 automatisch mit Distributor Quick Setup EC2 AWS Systems Manager

Mit AWS Systems Manager Distributor Quick Setup können Sie automatische Updates für EC2 Launch v2 einrichten. Der folgende Prozess richtet eine Systems Manager Association auf Ihrer Instance ein, die den EC2 Launch v2-Agent automatisch mit einer von Ihnen angegebenen Frequenz aktualisiert. Die Zuordnung, die der Distributor Quick Setup erstellt, kann Instanzen innerhalb einer AWS-Konto UND-Region oder Instanzen innerhalb einer AWS Organisation umfassen. Weitere Informationen finden Sie unter Anleitung: Erstellen und Konfigurieren einer Organisation im Benutzerhandbuch für AWS Organizations .

Stellen Sie vor Beginn sicher, dass Ihre Instances alle Voraussetzungen erfüllen.

Voraussetzungen

Um automatische Updates mit Distributor Quick Setup einzurichten, müssen Ihre Instances die folgenden Voraussetzungen erfüllen.

• Sie haben mindestens eine laufende Instance, die EC2 Launch v2 unterstützt. Sehen Sie unterstützte Betriebssysteme für EC2Starten Sie v2.

• Sie haben die Systems-Manager-Einrichtungsaufgaben auf Ihren Instances ausgeführt. Weitere Informationen finden Sie unter System Manager einrichten im AWS Systems Manager -Benutzerhandbuch.

• EC2Launch v2 muss der einzige Launch-Agent sein, der auf Ihrer Instance installiert ist. Wenn Sie mehr als einen Start-Agenten installiert haben, schlägt die Konfiguration der Distributor Quick Setup fehl. Bevor Sie EC2 Launch v2 mit einem Distributor Quick Setup konfigurieren, deinstallieren Sie EC2 Config- oder EC2 Launch v1-Launch-Agents, sofern sie vorhanden sind.

Konfigurieren Sie Distributor Quick Setup für EC2 Launch v2

Um eine Konfiguration für EC2 Launch v2 mit Distributor Quick Setup zu erstellen, verwenden Sie die folgenden Einstellungen, wenn Sie die Schritte für die Bereitstellung des Distributor-Pakets abschließen:

• Softwarepakete: Amazon EC2 Launch v2-Agent.

• Aktualisierungshäufigkeit: Wählen Sie eine Frequenz aus der Liste aus.

• Ziele: Wählen Sie aus den verfügbaren Bereitstellungsoptionen.

Um den Status Ihrer Konfiguration zu überprüfen, navigieren Sie zur Registerkarte Konfigurationen des Systems Manager Quick Setup in der AWS Management Console.

1. Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/.

2. Wählen Sie im Navigationsbereich Quick Setup aus.

3. Wählen Sie auf der Registerkarte Konfigurationen die Zeile aus, die mit der von Ihnen erstellten Konfiguration verknüpft ist. Die Registerkarte Konfigurationen listet Ihre Konfigurationen auf und enthält eine Zusammenfassung der wichtigsten Details wie Region, Bereitstellungsstatus und Zuordnungsstatus.

   Anmerkung

   Der Zuordnungsname für jede EC2 Launch v2 Distributor-Konfiguration beginnt mit dem folgenden Präfix:AWS-QuickSetup-Distributor-EC2Launch-Agent-.

4. Um Details anzuzeigen, wählen Sie die Konfiguration aus und klicken Sie auf Details anzeigen.

Weitere Informationen und Schritte zur Fehlerbehebung finden Sie unter Problembehandlung bei Ergebnissen von Quick Setup im AWS Systems Manager -Benutzerhandbuch.

EC2Starten Sie v2-Downloads auf Amazon S3

Um die neueste Version von EC2 Launch v2 zu installieren, laden Sie das Installationsprogramm von der folgenden Adresse herunter:

• https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi

Installationsoptionen konfigurieren

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie die Installationsoptionen mit dem EC2 Launch v2-Installationsdialogfeld oder mit dem msiexec Befehl in einer Befehlszeilenshell konfigurieren.

Wenn das EC2 Launch v2-Installationsprogramm zum ersten Mal auf einer Instance ausgeführt wird, initialisiert es die Launch-Agent-Einstellungen auf Ihrer Instance wie folgt:

• Es erstellt den lokalen Pfad und schreibt die Datei des Startagenten dorthin. Dies wird manchmal als Neuinstallation bezeichnet.

• Es erstellt die Umgebungsvariable EC2LAUNCH_TELEMETRY, sofern diese noch nicht vorhanden ist, und legt sie basierend auf Ihrer Konfiguration fest.

Wählen Sie für Konfigurationsdetails die Registerkarte aus, die der von Ihnen verwendeten Konfigurationsmethode entspricht.

Amazon EC2Launch Setup dialog

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie im EC2 Launch v2-Installationsdialogfeld die folgenden Installationsoptionen konfigurieren.

Optionen der Grundlegende Installation

Telemetrie senden

Wenn Sie dieses Feature in den Einrichtungsdialog aufnehmen, legt das Installationsprogramm die Umgebungsvariable EC2LAUNCH_TELEMETRY auf einen Wert von 1 fest. Wenn Sie Telemetrie senden deaktivieren, legt das Installationsprogramm die Umgebungsvariable auf den Wert 0 fest.

Wenn der EC2 Launch v2-Agent ausgeführt wird, liest er die EC2LAUNCH_TELEMETRY Umgebungsvariable, um zu bestimmen, ob Telemetriedaten hochgeladen werden sollen. Wenn der Wert gleich 1 ist, werden die Daten hochgeladen. Andernfalls wird der Upload nicht durchgeführt.

Standardkonfiguration

Die Standardkonfiguration für EC2 Launch v2 besteht darin, den lokalen Launch-Agent zu überschreiben, falls er bereits vorhanden ist. Wenn Sie zum ersten Mal eine Installation auf einer Instance ausführen, wird in der Standardkonfiguration eine Neuinstallation durchgeführt. Wenn Sie die Standardkonfiguration bei der Erstinstallation deaktivieren, schlägt die Installation fehl.

Wenn Sie die Installation auf der Instance erneut ausführen, können Sie die Standardkonfiguration deaktivieren, um ein Upgrade durchzuführen, bei dem die %ProgramData%/Amazon/EC2Launch/config/agent-config.yml-Datei nicht ersetzt wird.

Beispiel: Führen Sie ein Upgrade von EC2 Launch v2 mit Telemetrie durch

Das folgende Beispiel zeigt den EC2 Launch v2-Setup-Dialog, der so konfiguriert ist, dass die aktuelle Installation aktualisiert und Telemetrie aktiviert wird. Diese Konfiguration führt eine Installation durch, ohne die Agent-Konfigurationsdatei zu ersetzen, und legt die Umgebungsvariable EC2LAUNCH_TELEMETRY auf den Wert 1 fest.

Command line

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie die folgenden Installationsoptionen mit dem msiexec Befehl in einer Befehlszeilenshell konfigurieren.

ADDLOCAL-Parameterwerte

Grundlegend (erforderlich)

Installieren Sie den Start-Agenten. Wenn dieser Wert im ADDLOCAL-Parameter nicht vorhanden ist, wird die Installation beendet.

Bereinigen

Wenn Sie den Clean-Wert in den ADDLOCAL-Parameter einbeziehen, schreibt das Installationsprogramm die Agent-Konfigurationsdatei an den folgenden Speicherort: %ProgramData%/Amazon/EC2Launch/config/agent-config.yml. Wenn die Agent-Konfigurationsdatei bereits vorhanden ist, wird die Datei überschrieben.

Wenn Sie den Clean-Wert im ADDLOCAL-Parameter weglassen, führt das Installationsprogramm ein Upgrade durch, das die Agent-Konfigurationsdatei nicht ersetzt.

Telemetrie

Wenn Sie den Telemetry-Wert in den ADDLOCAL-Parameter einbeziehen, legt das Installationsprogramm die Umgebungsvariable EC2LAUNCH_TELEMETRY auf den Wert 1 fest.

Wenn Sie den Telemetry-Wert in den ADDLOCAL-Parameter einbeziehen, legt das Installationsprogramm die Umgebungsvariable auf den Wert 0 fest.

Wenn der EC2 Launch v2-Agent ausgeführt wird, liest er die EC2LAUNCH_TELEMETRY Umgebungsvariable, um zu bestimmen, ob Telemetriedaten hochgeladen werden sollen. Wenn der Wert gleich 1 ist, werden die Daten hochgeladen. Andernfalls wird der Upload nicht durchgeführt.

Beispiel: Installieren Sie EC2 Launch v2 mit Telemetrie

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

Überprüfen Sie die EC2 Launch v2-Version

Verwenden Sie eines der folgenden Verfahren, um die Version von EC2 Launch v2 zu überprüfen, die auf Ihren Instances installiert ist.

Windows PowerShell

Überprüfen Sie die installierte Version von EC2 Launch v2 mit Windows PowerShell wie folgt.

1. Starten Sie eine Instance von Ihrem AMI und stellen Sie eine Verbindung damit her.

2. Führen Sie den folgenden Befehl aus PowerShell , um die installierte Version von EC2 Launch v2 zu überprüfen:

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

Windows Control Panel

Überprüfen Sie die installierte Version von EC2 Launch v2 in der Windows-Systemsteuerung wie folgt.

1. Starten Sie eine Instance von Ihrem AMI und stellen Sie eine Verbindung damit her.

2. Öffnen Sie die Windows-Systemsteuerung und wählen Sie Programme und Features.

3. Suchen Sie in der Liste mit den installierten Programmen nach Amazon EC2Launch. Die Versionsnummer wird in der Spalte Version angegeben.

Die neuesten Updates für Windows finden Sie im AWS Windows AMIs AMI-Versionsverlauf in der AWS Windows AMI-Referenz.

Die neueste Version von EC2 Launch v2 finden Sie unterEC2Versionsverlauf für Version 2 starten.

Die neueste Version des EC2 Launch v2-Migrationstools finden Sie unterEC2Versionsverlauf des v2-Migrationstools starten.

Sie können Benachrichtigungen erhalten, wenn neue Versionen des EC2 Launch v2-Dienstes veröffentlicht werden. Weitere Informationen finden Sie unter Abonnieren Sie Benachrichtigungen für den EC2 Windows Launch Agent.