Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren Sie die EC2Launch v2-Einstellungen für Windows-Instanzen

Dieser Abschnitt enthält Informationen zur Konfiguration der Einstellungen für EC2Launch Version 2.

Ändern Sie die Einstellungen mithilfe des Dialogfelds mit den EC2Launch v2-Einstellungen

Im Folgenden finden Sie ein Beispiel für eine YAML Konfigurationsdatei, die anhand der im EC2Launch Dialogfeld eingegebenen Einstellungen erstellt wurde.

version: 1.0
config:
  - stage: boot
	tasks:
      - task: extendRootPartition
  - stage: preReady
    tasks:
      - task: activateWindows
        inputs:
          activation:
            type: amazon
      - task: setDnsSuffix
        inputs:
          suffixes:
            - $REGION.ec2-utilities.amazonaws.com
      - task: setAdminAccount
        inputs:
          password:
            type: random
      - task: setWallpaper
        inputs:
          path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
          attributes:
            - hostName
            - instanceId
            - privateIpAddress
            - publicIpAddress
            - instanceSize
            - availabilityZone
            - architecture
            - memory
            - network
  - stage: postReady
    tasks:
      - task: startSsm

Konfigurieren Sie EC2Launch v2 mit dem CLI

Sie können die Befehlszeilenschnittstelle (CLI) verwenden, um Ihre EC2Launch Einstellungen zu konfigurieren und den Dienst zu verwalten. Der folgende Abschnitt enthält Beschreibungen und Nutzungsinformationen für die CLI Befehle, mit denen Sie EC2Launch Version 2 verwalten können.

collect-logs

Sammelt Protokolldateien fürEC2Launch, komprimiert die Dateien und platziert sie in einem angegebenen Verzeichnis.

Beispiel

ec2launch collect-logs -o C:\Mylogs.zip

Usage

ec2launch collect-logs [flags]

Flags

-h, --help

Hilfe für collect-logs

-o, --output string

Pfad zu komprimierten Ausgabe-Protokolldateien

get-agent-config

Druckt agent-config.yml im angegebenen Format (JSONoderYAML). Wenn kein Format angegeben ist, wird agent-config.yml in dem zuvor angegebenen Format gedruckt.

Beispiel

ec2launch get-agent-config -f json

Beispiel 2

Die folgenden PowerShell Befehle zeigen, wie die agent-config Datei bearbeitet und im JSON Format gespeichert wird.

$config = & "$env:ProgramFiles/Amazon/EC2Launch/EC2Launch.exe" --format json | ConvertFrom-Json
$jumboFrame =@"
{
   "task": "enableJumboFrames"
}
"@
$config.config | %{if($_.stage -eq 'postReady'){$_.tasks += (ConvertFrom-Json -InputObject $jumboFrame)}}
$config | ConvertTo-Json -Depth 6 | Out-File -encoding UTF8
$env:ProgramData/Amazon/EC2Launch/config/agent-config.yml

Usage

ec2launch get-agent-config [flags]

Flags

-h, --help

Hilfe für get-agent-config

-f, --format string

Ausgabeformat der agent-config-Datei: json, yaml

list-Volumes

Listet alle Speichervolumes auf, die an die Instance angehängt sind, einschließlich kurzlebiger Volumes und EBS Volumes.

Beispiel

ec2launch list-volumes

Usage

ec2launch list-volumes

Flags

-h, --help

Hilfe für list-volumes

reset

Das Hauptziel dieser Aufgabe besteht darin, den Agenten für die nächste Ausführung zurückzusetzen. Zu diesem Zweck löscht der reset Befehl alle Agentenstatusdaten für EC2Launch v2 aus dem lokalen EC2Launch Verzeichnis (siehe). EC2Launchv2-Verzeichnisstruktur Beim Zurücksetzen werden optional die Service- und Sysprep-Protokolle gelöscht.

Das Verhalten des Skripts hängt davon ab, in welchem Modus der Agent die Skripte ausführt – inline oder getrennt.

Beispiel

ec2launch reset -c

Usage

ec2launch reset [flags]

Flags

-c, --clean

bereinigt Instance-Protokolle vor reset

-h, --help

Hilfe für reset

run

Läuft EC2Launch v2.

Beispiel

ec2launch run

Usage

ec2launch run [flags]

Flags

-h, --help

Hilfe für run

Status

Ruft den Status des EC2Launch v2-Agenten ab. Blockiert optional den Prozess, bis der Agent beendet ist. Der Prozess-Beendigungscode bestimmt den Agentenstatus:

Beispiel:

ec2launch status -b

Usage

ec2launch status [flags]

Flags

-b,--block

blockiert den Prozess, bis die Ausführung des Agenten beendet ist

-h,--help

Hilfe für status

sysprep

Das Hauptziel dieser Aufgabe besteht darin, den Agenten für die nächste Ausführung zurückzusetzen. Dazu setzt der sysprep Befehl den Agentstatus zurück, aktualisiert die unattend.xml Datei, deaktiviert Sysprep und führt RDP es aus.

Das Verhalten des Skripts hängt davon ab, in welchem Modus der Agent die Skripte ausführt – inline oder getrennt.

Beispiel:

ec2launch sysprep

Usage

ec2launch sysprep [flags]

Flags

-c,--clean

bereinigt Instance-Protokolle vor sysprep

-h,--help

Hilfe für Sysprep

-s,--shutdown

fährt die Instance nach sysprep herunter

validieren

Validiert die agent-config-Datei C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml.

Beispiel

ec2launch validate

Usage

ec2launch validate [flags]

Flags

-h , --help

Hilfe für validate

version

Ruft die ausführbare Version ab.

Beispiel

ec2launch version

Usage

ec2launch version [flags]

Flags

-h, --help

Hilfe für version

Hintergrundbild

Legt das bereitgestellte Hintergrundbild für den Hintergrundbildpfad fest (JPG-Datei) und zeigt die ausgewählten Instance-Details an.

Syntax

ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,instanceSize,availabilityZone,architecture,memory,network

Eingaben

EC2LaunchKonfiguration der v2-Aufgabe

Dieser Abschnitt enthält das Konfigurationsschema, Aufgaben, Details und Beispiele für agent-config.yml und Benutzerdaten.

Schema: agent-config.yml

Die Struktur der agent-config.yml-Datei wird unten gezeigt. Beachten Sie, dass eine Aufgabe nicht in derselben Phase wiederholt werden kann. Informationen zu den Aufgabeneigenschaften finden Sie in den folgenden Aufgabenbeschreibungen.

Dokumentstruktur: agent-config.yml

JSON

{
	"version": "1.0",
	"config": [
		{
			"stage": "string",
			"tasks": [
				{
					"task": "string",
					"inputs": {
						...
					}
				},
				...
			]
		},
		...
	]
}

YAML

version: 1.0
config:
- stage: string
  tasks:
  - task: string
	inputs:
	  ...
  ...
...

Beispiel: agent-config.yml

Das folgende Beispiel zeigt die Einstellungen für die agent-config.yml-Konfigurationsdatei.

version: 1.0
config:
- stage: boot
  tasks:
  - task: extendRootPartition
- stage: preReady
  tasks:
  - task: activateWindows
    inputs:
      activation:
        type: amazon
  - task: setDnsSuffix
    inputs:
      suffixes:
      - $REGION.ec2-utilities.amazonaws.com
  - task: setAdminAccount
    inputs:
      password:
        type: random
  - task: setWallpaper
    inputs:
      path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
      attributes:
      - hostName
      - instanceId
      - privateIpAddress
      - publicIpAddress
      - instanceSize
      - availabilityZone
      - architecture
      - memory
      - network
- stage: postReady
  tasks:
  - task: startSsm

Konfigurieren Sie EC2Launch v2-Benutzerdatenskripts, die beim Start oder Neustart ausgeführt werden

Im Folgenden JSON und in YAML Beispielen wird die Dokumentstruktur für Benutzerdaten veranschaulicht. Amazon EC2 analysiert jede Aufgabe, die in dem tasks Array benannt ist, das Sie im Dokument angeben. Jede Aufgabe hat ihre eigenen Eigenschaften und Anforderungen. Einzelheiten finden Sie im Aufgabendefinitionen für EC2Launch v2-Startaufgaben.

Dokumentenstruktur: Benutzerdaten

JSON

{
	"version": "1.1",
	"tasks": [
		{
			"task": "string",
			"inputs": {
				...
			},
		},
		...
	]
}

YAML

version: 1.1
tasks:
- task: string
  inputs:
    ...
...

Beispiel: Benutzerdaten

Weitere Informationen zu Benutzerrollen finden Sie unter Wie Amazon EC2 mit Benutzerdaten für Windows-Instances umgeht.

Das folgende YAML Dokumentbeispiel zeigt ein PowerShell Skript, das EC2Launch v2 als Benutzerdaten ausführt, um eine Datei zu erstellen.

version: 1.1
tasks:
- task: executeScript
  inputs:
  - frequency: always
    type: powershell
    runAs: localSystem
    content: |-
      New-Item -Path 'C:\PowerShellTest.txt' -ItemType File

Sie können ein XML Format für die Benutzerdaten verwenden, das mit früheren Versionen des Launch-Agents kompatibel ist. EC2Launchv2 führt das Skript als executeScript Aufgabe in der UserData Phase aus. Um EC2Launch Version 1 und dem EC2Config Verhalten zu entsprechen, wird das Benutzerdatenskript standardmäßig als angehängter Inline-Prozess ausgeführt.

Sie können optionale Tags hinzufügen, um die Ausführung Ihres Skripts anzupassen. Um beispielsweise das Benutzerdatenskript beim Neustart der Instance zusätzlich zum einmaligen Starten der Instance auszuführen, können Sie das folgende Tag verwenden:

<persist>true</persist>

Beispiel:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<persist>true</persist>

Sie können ein oder mehrere PowerShell Argumente mit dem Tag angeben. <powershellArguments> Wenn keine Argumente übergeben werden, fügt EC2Launch v2 standardmäßig das folgende Argument hinzu:-ExecutionPolicy Unrestricted.

Beispiel:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<powershellArguments>-ExecutionPolicy Unrestricted -NoProfile -NonInteractive</powershellArguments>

Um ein XML Benutzerdatenskript als eigenständigen Prozess auszuführen, fügen Sie Ihren Benutzerdaten das folgende Tag hinzu.

<detach>true</detach>

Beispiel:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<detach>true</detach>

Änderungsprotokoll: Benutzerdaten

In der folgenden Tabelle sind die Änderungen an den Benutzerdaten aufgeführt und sie werden mit der jeweils geltenden Version des EC2Launch v2-Agenten verglichen.

* Bei Verwendung mit der agent-config.yml-Standarddatei.

EC2Launchv2-Exitcodes und Neustarts

Sie können EC2Launch v2 verwenden, um zu definieren, wie Exit-Codes von Ihren Skripten behandelt werden. Standardmäßig wird der Beendigungscode des letzten in einem Skript ausgeführten Befehls als Beendigungscode für das gesamte Skript gemeldet. Wenn ein Skript beispielsweise drei Befehle enthält und der erste Befehl fehlschlägt, aber die folgenden erfolgreich sind, wird der Ausführungsstatus als success gemeldet, da der endgültige Befehl erfolgreich war.

Wenn Sie möchten, dass ein Skript eine Instanz neu startet, müssen Sie dies exit 3010 in Ihrem Skript angeben, auch wenn der Neustart der letzte Schritt in Ihrem Skript ist. exit 3010weist EC2Launch v2 an, die Instanz neu zu starten und das Skript erneut aufzurufen, bis es einen Exit-Code zurückgibt, der dies nicht ist3010, oder bis die maximale Anzahl von Neustarts erreicht ist. EC2Launchv2 erlaubt maximal 5 Neustarts pro Aufgabe. Wenn Sie versuchen, eine Instance aus einem Skript mit einem anderen Mechanismus wie Restart-Computer neu zu starten, ist der Skriptausführungsstatus inkonsistent. Er kann beispielsweise in einer Neustartschleife stecken bleiben oder den Neustart nicht durchführen.

Wenn Sie ein XML Benutzerdatenformat verwenden, das mit älteren Agenten kompatibel ist, werden die Benutzerdaten möglicherweise öfter ausgeführt, als Sie beabsichtigen. Weitere Informationen finden Sie im Abschnitt zur Fehlerbehebung unter Der Service führt Benutzerdaten mehr als einmal aus.

EC2Launchv2 und Sysprep

Der EC2Launch v2-Dienst führt Sysprep aus, ein Microsoft-Tool, mit dem Sie ein benutzerdefiniertes Windows erstellen könnenAMI, das wiederverwendet werden kann. Wenn EC2Launch v2 Sysprep aufruft, verwendet es die Dateien in, %ProgramData%\Amazon\EC2Launch um zu bestimmen, welche Operationen ausgeführt werden sollen. Sie können diese Dateien indirekt über das EC2LaunchEinstellungsdialogfeld oder direkt mit einem YAML Editor oder einem Texteditor bearbeiten. Es gibt jedoch einige erweiterte Einstellungen, die im EC2LaunchEinstellungsdialogfeld nicht verfügbar sind, sodass Sie diese Einträge direkt bearbeiten müssen.

Wenn Sie nach der Aktualisierung der Einstellungen ein From AMI aus einer Instance erstellen, werden die neuen Einstellungen auf alle Instances angewendet, die von der neuen Instance aus gestartet werdenAMI. Informationen zum Erstellen einer finden AMI Sie unterErstellen Sie ein von Amazon EBS unterstütztes AMI.