VSS-Snapshots mit AWS Systems Manager -Befehlsdokumenten erstellen - Amazon Elastic Compute Cloud
Parameter für VSS-Snapshot-Dokumente von Systems ManagerVSS-Snapshot-Befehlsdokumente im Systems Manager ausführen

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.

VSS-Snapshots mit AWS Systems Manager -Befehlsdokumenten erstellen

Sie können AWS Systems Manager Befehlsdokumente verwenden, um VSS-fähige Snapshots zu erstellen. Im Folgenden werden die verfügbaren Befehlsdokumente und die Laufzeitparameter vorgestellt, die die Dokumente zur Erstellung Ihrer Snapshots verwenden.

Bevor Sie eines der Befehlsdokumente von Systems Manager verwenden, stellen Sie sicher, dass Sie alle Anforderungen von Voraussetzungen erfüllt haben.

Parameter für VSS-Snapshot-Dokumente von Systems Manager

Die Systems-Manager-Dokumente, die VSS-Snapshots erstellen, verwenden alle die folgenden Parameter, sofern nicht anders angegeben:

ExcludeBootVolume(Zeichenfolge, optional)

Mit dieser Einstellung werden Boot-Volumes aus dem Sicherungsvorgang ausgeschlossen, wenn Sie Snapshots erstellen. Um Startvolumes aus Ihren Snapshots auszuschließen, legen Sie ExcludeBootVolumeauf True und CreateAmiauf False fest.

Wenn Sie ein AMI für Ihr Backup erstellen, sollte dieser Parameter auf False gesetzt werden. Der Standardwert für diesen Parameter ist False.

NoWriters(Zeichenfolge, optional)

Um Anwendungs-VSS-Writer vom Snapshot-Vorgang auszuschließen, setzen Sie diesen Parameter auf True. Anwendungs-VSS-Writer auszuschließen kann Ihnen helfen, Konflikte mit VSS-Backup-Komponenten von Drittanbietern zu lösen. Der Standardwert für diesen Parameter ist False.

CopyOnly(Zeichenfolge, optional)

Wenn Sie zusätzlich zu AWS VSS die systemeigene SQL Server-Sicherung verwenden, verhindert die Ausführung einer reinen Kopiersicherung, dass AWS VSS die systemeigene differenzielle Sicherungskette unterbricht. Um einen Copy-only-Backup-Vorgang durchzuführen, setzen Sie diesen Parameter auf True.

Der Standardwert für diesen Parameter istFalse, was dazu führt, dass AWS VSS einen vollständigen Sicherungsvorgang durchführt.

CreateAmi(Zeichenfolge, optional)

Um ein VSS-fähiges Amazon Machine Image (AMI) zum Sichern Ihrer Instance zu erstellen, setzen Sie diesen Parameter auf True. Der Standardwert für diesen Parameter ist False, wodurch Ihre Instance stattdessen mit einem EBS-Snapshot gesichert wird.

Weitere Informationen zum Erstellen einer AMI von einer Instance finden Sie unter Erstellen Sie ein Amazon EBS-backed AMI.

AmiName(Zeichenfolge, optional)

Wenn die CreateAmiOption auf gesetzt istTrue, geben Sie den Namen des AMI an, das das Backup erstellt.

description (Zeichenfolge, optional)

Geben Sie eine Beschreibung für die Snapshots oder das Image an, das dieser Prozess erstellt.

tags (Zeichenfolge, optional)

Wir empfehlen Ihnen, Ihre Snapshots und Images mit Tags zu versehen, damit Sie Ihre Ressourcen leichter finden und verwalten können, z. B. um Volumes aus einer Liste von Snapshots wiederherzustellen. Das System fügt den Name Schlüssel mit einem leeren Wert hinzu, in dem Sie den Namen angeben können, den Sie auf Ihre ausgegebenen Schnappschüsse oder Bilder anwenden möchten.

Wenn Sie zusätzliche Tags angeben möchten, trennen Sie die Tags durch ein Semikolon dazwischen. z. B. Key=Environment,Value=Test;Key=User,Value=TestUser1.

Standardmäßig fügt das System die folgenden reservierten Tags für VSS-fähige Snapshots und Bilder hinzu.

  • Gerät — Bei VSS-fähigen Snapshots ist dies der Gerätename des EBS-Volumes, das der Snapshot erfasst.

  • AppConsistent— Dieses Tag weist auf die erfolgreiche Erstellung eines VSS-fähigen Snapshots oder AMIs hin.

  • AwsVssConfig— Dies identifiziert Snapshots und AMIs, die mit aktiviertem VSS erstellt wurden. Das Tag enthält Metainformationen wie die AwsVssComponents Version.

Warnung

Die Angabe eines dieser reservierten Tags in Ihrer Parameterliste führt zu einem Fehler.

executionTimeout (Zeichenfolge, optional)

Geben Sie die maximale Zeit in Sekunden an, um den Snapshot-Erstellungsprozess auf der Instance auszuführen oder ein AMI aus der Instance zu erstellen. Wenn Sie dieses Timeout erhöhen, kann der Befehl länger warten, bis VSS mit dem Einfrieren beginnt und die Markierung der von ihm erstellten Ressourcen abgeschlossen hat. Dieses Timeout gilt nur für die Schritte zur Snapshot- oder AMI-Erstellung. Der erste Schritt zur Installation oder Aktualisierung des Pakets AwsVssComponents ist nicht im Timeout enthalten.

CollectDiagnosticLogs(Zeichenfolge, optional)

Um während der Schritte zur Snapshot- und AMI-Erstellung weitere Informationen zu sammeln, setzen Sie diesen Parameter auf "True“. Der Standardwert für diesen Parameter ist "False“. Konsolidierte Diagnoseprotokolle werden als .zip Formatarchiv am folgenden Speicherort auf Ihrer Instance gespeichert:

C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip

VssVersion(Zeichenfolge, optional)

Sie können nur für das AWSEC2-VssInstallAndSnapshot-Dokument den Parameter VssVersion angeben, um eine bestimmte Version des AwsVssComponents-Pakets auf Ihrer Instance zu installieren. Lassen Sie diesen Parameter leer, um die empfohlene Standardversion zu installieren.

Wenn die angegebene Version des Pakets AwsVssComponents bereits installiert ist, überspringt das Skript den Installationsschritt und fährt mit dem Backup-Schritt fort. Eine Liste der AwsVssComponents-Paketversionen und der Betriebsunterstützung finden Sie unter AWS Versionsverlauf der VSS-Lösung.

VSS-Snapshot-Befehlsdokumente im Systems Manager ausführen

Sie können VSS-fähige EBS-Snapshots mit AWS Systems Manager Befehlsdokumenten wie folgt erstellen.

Wenn Sie AWS Systems Manager das AWSEC2-VssInstallAndSnapshot Dokument ausführen, führt das Skript die folgenden Schritte aus.

  1. Das Skript installiert oder aktualisiert zuerst das Paket AwsVssComponents auf Ihrer Instance, je nachdem, ob es bereits installiert ist.

  2. Das Skript erstellt die anwendungskonsistenten Snapshots, nachdem der erste Schritt abgeschlossen ist.

Folgen Sie den Schritten für Ihre bevorzugte Umgebung, um das Dokument AWSEC2-VssInstallAndSnapshot auszuführen.

Console
VSS-fähige EBS-Snapshots über die Konsole erstellen

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

  2. Wählen Sie im Navigationsbereich Befehl ausführen. Hier wird gegebenenfalls eine Liste der Befehle angezeigt, die derzeit in Ihrem Konto ausgeführt werden.

  3. Wählen Sie Run Command (Befehl ausführen) aus. Dadurch wird eine Liste von Befehlsdokumenten geöffnet, auf die Sie Zugriff haben.

  4. Wählen Sie AWSEC2-VssInstallAndSnapshot aus der Liste der Befehlsdokumente aus. Um die Ergebnisse zu optimieren, können Sie den Dokumentnamen ganz oder teilweise eingeben. Sie können auch nach dem Eigentümer, nach Plattformtypen oder nach Tags filtern.

    Wenn Sie ein Befehlsdokument auswählen, werden die Details unter der Liste angezeigt.

  5. Wählen Sie Default version at runtime aus der Liste der Dokumentversionen.

  6. Konfigurieren Sie die Befehlsparameter, um zu definieren, wie AWSEC2-VssInstallAndSnapshot das Paket AwsVssComponents installieren und mit VSS-Snapshots oder einem AMI sichern soll. Einzelheiten zu den Parametern finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

  7. Geben Sie für Zielauswahl Tags an oder wählen Sie Instances manuell, um die Instances zu identifizieren, in denen Sie diesen Vorgang ausführen möchten.

    Anmerkung

    Wenn Sie entscheiden, Instances manuell auszuwählen, und eine von Ihnen erwartete Instance nicht in der Liste enthalten ist, finden Sie Tipps zur Fehlersuche unter Wo sind meine Instances?.

  8. Für zusätzliche Parameter zur Definition des Verhaltens von Systems Manager Run Command, wie z. B. die Ratensteuerung, geben Sie Werte ein, wie unter Befehle von der Konsole ausführen beschrieben.

  9. Wählen Sie Run (Ausführen) aus.

    Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die Systems Manager-Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Volumes nach Informationen zur Problembehebung suchen.

AWS CLI

Sie können die folgenden Befehle in der ausführen, AWS CLI um VSS-fähige EBS-Snapshots zu erstellen und den Status Ihrer Snapshot-Erstellung abzurufen.

Erstellen von VSS-fähigen EBS-Snapshots

Führen Sie den folgenden Befehl aus, um VSS-fähige EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem --instance-ids-Parameter identifizieren. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

Bei Erfolg füllt das Befehlsdokument die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

Abrufen des Befehlsstatus

Um den aktuellen Status der Snapshots abzurufen, führen Sie den folgenden Befehl mit der Befehls-ID aus, die von send-command zurückgegeben wurde.

aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
PowerShell

Führen Sie die folgenden Befehle mit aus AWS Tools for Windows PowerShell , um VSS-fähige EBS-Snapshots zu erstellen und den aktuellen Laufzeitstatus für die Erstellung Ihrer Ausgabe abzurufen. Geben Sie die in der vorherigen Liste beschriebenen Parameter an, um das Verhalten des Snapshot-Prozesses zu ändern.

Erstellen Sie VSS-fähige EBS-Snapshots mit Tools für Windows PowerShell

Führen Sie den folgenden Befehl aus, um VSS-fähige EBS-Snapshots oder AMIs zu erstellen.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Abrufen des Befehlsstatus

Um den aktuellen Status der Snapshots abzurufen, führen Sie den folgenden Befehl mit der Befehls-ID aus, die von Send-SSMCommand zurückgegeben wurde.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

Folgen Sie den Schritten für Ihre bevorzugte Umgebung, um das Dokument AWSEC2-CreateVssSnapshot auszuführen.

Console
VSS-fähige EBS-Snapshots über die Konsole erstellen

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

  2. Wählen Sie im Navigationsbereich Befehl ausführen. Hier wird gegebenenfalls eine Liste der Befehle angezeigt, die derzeit in Ihrem Konto ausgeführt werden.

  3. Wählen Sie Run Command (Befehl ausführen) aus. Dadurch wird eine Liste von Befehlsdokumenten geöffnet, auf die Sie Zugriff haben.

  4. Wählen Sie AWSEC2-CreateVssSnapshot aus der Liste der Befehlsdokumente aus. Um die Ergebnisse zu optimieren, können Sie den Dokumentnamen ganz oder teilweise eingeben. Sie können auch nach dem Eigentümer, nach Plattformtypen oder nach Tags filtern.

    Wenn Sie ein Befehlsdokument auswählen, werden die Details unter der Liste angezeigt.

  5. Wählen Sie Default version at runtime aus der Liste der Dokumentversionen.

  6. Konfigurieren Sie die Befehlsparameter, um zu definieren, wie AWSEC2-CreateVssSnapshot mit VSS-Snapshots oder einem AMI gesichert werden soll. Einzelheiten zu den Parametern finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

  7. Geben Sie für Zielauswahl Tags an oder wählen Sie Instances manuell, um die Instances zu identifizieren, in denen Sie diesen Vorgang ausführen möchten.

    Anmerkung

    Wenn Sie entscheiden, Instances manuell auszuwählen, und eine von Ihnen erwartete Instance nicht in der Liste enthalten ist, finden Sie Tipps zur Fehlersuche unter Wo sind meine Instances?.

  8. Für zusätzliche Parameter zur Definition des Verhaltens von Systems Manager Run Command, wie z. B. die Ratensteuerung, geben Sie Werte ein, wie unter Befehle von der Konsole ausführen beschrieben.

  9. Wählen Sie Run (Ausführen) aus.

    Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die Systems Manager-Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Volumes nach Informationen zur Problembehebung suchen.

AWS CLI

Sie können den folgenden Befehl in der ausführen, AWS CLI um VSS-fähige EBS-Snapshots zu erstellen.

Erstellen von VSS-fähigen EBS-Snapshots

Führen Sie den folgenden Befehl aus, um VSS-fähige EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem --instance-ids-Parameter identifizieren. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

Bei Erfolg füllt das Befehlsdokument die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

PowerShell

Führen Sie den folgenden Befehl mit aus, um VSS-fähige AWS Tools for Windows PowerShell EBS-Snapshots zu erstellen.

Erstellen Sie VSS-fähige EBS-Snapshots mit Tools für Windows PowerShell

Führen Sie den folgenden Befehl aus, um VSS-fähige EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem InstanceId-Parameter identifizieren. Sie können mehr als eine Instance angeben, für die Snapshots erstellt werden. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}

Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Snapshots nach Informationen zur Problembehebung suchen.

Sie können jedes der im vorherigen Abschnitt beschriebenen Befehlszeilenverfahren verwenden, um einen VSS-fähigen Snapshot zu erstellen. Das Befehlsdokument (AWSEC2-VssInstallAndSnapshot oder AWSEC2-CreateVssSnapshot) muss auf dem Primärknoten in Ihrem Cluster ausgeführt werden. Das Dokument schlägt auf den sekundären Knoten fehl, da sie keinen Zugriff auf die gemeinsam genutzten Festplatten haben. Wenn sich Ihr primärer und sekundärer Knoten dynamisch ändern, können Sie das Dokument „Befehl AWS Systems Manager ausführen“ auf mehreren Knoten ausführen und erwarten, dass der Befehl auf dem primären Knoten erfolgreich ist und auf sekundären Knoten fehlschlägt.

Sie können das folgende Skript und das vordefinierte SSM-Dokument AWSEC2-ManageVssIO verwenden, um I/O-Vorgänge vorübergehend zu unterbrechen, VSS-fähige EBS-Snapshots zu erstellen und die I/O-Vorgänge erneut zu starten. Dieser Vorgang wird im Kontext des Benutzers ausgeführt, der den Befehl ausführt. Wenn der Benutzer über ausreichende Rechte zum Erstellen und Markieren von Snapshots verfügt, AWS Systems Manager kann er VSS-fähige EBS-Snapshots erstellen und taggen, ohne dass die zusätzliche IAM-Snapshot-Rolle auf der Instance erforderlich ist.

Im Gegensatz dazu erfordert das Befehlsdokument (AWSEC2-VssInstallAndSnapshot or AWSEC2-CreateVssSnapshot), dass Sie die IAM-Snapshot-Rolle jeder Instance zuweisen, für die EBS-Snapshots erstellt werden sollen. Wenn Sie aufgrund der Richtlinie oder aus Compliance-Gründen keine weiteren IAM-Berechtigungen für Ihre Instances bereitstellen möchten, können Sie das folgende Skript verwenden.

Bevor Sie beginnen

Beachten Sie die folgenden wichtigen Details zu diesem Vorgang:

  • Dieser Prozess verwendet ein PowerShell Skript (CreateVssSnapshotAdvancedScript.ps1), um Snapshots aller Volumes auf den von Ihnen angegebenen Instances zu erstellen, mit Ausnahme der Root-Volumes. Wenn Sie Snapshots von Stamm-Volumes erstellen möchten, müssen Sie das SSM-Dokument AWSEC2-CreateVssSnapshot verwenden.

  • Das Skript ruft das Dokument AWSEC2-ManageVssIO zweimal auf. Beim ersten Mal ist der Parameter Action dabei auf Freeze gesetzt. Dadurch werden alle I/O-Vorgänge auf den Instances angehalten. Beim zweiten Mal ist der Parameter Action auf Thaw gesetzt. Dadurch wird der I/O-Vorgang fortgesetzt.

  • Versuchen Sie nicht, das AWSEC2-ManageVssIO Dokument ohne das CreateVssSnapshotAdvancedScript .ps1-Skript zu verwenden. Das VSS-Framework von Microsoft verlangt, dass der Aufruf der Aktionen Freeze und Thaw im Abstand von höchstens zehn Sekunden erfolgt. Ein manueller Aufruf dieser Aktionen ohne das Skript könnte zu Fehlern führen.

VSS-fähige EBS-Snapshots mithilfe des SSM-Dokuments AWSEC2-ManageVssIO erstellen

  1. Laden Sie die CreateVssSnapshotAdvancedScriptZIP-Datei herunter und extrahieren Sie den Inhalt der Datei.

  2. Öffnen Sie CreateVssSnapshotAdvancedScript.ps1 in einem Texteditor, bearbeiten Sie den Beispielaufruf am Ende des Skripts mit einer gültigen EC2-Instanz-ID, einer Snapshot-Beschreibung und den gewünschten Tag-Werten und führen Sie das Skript dann von aus. PowerShell

Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach AppConsistent suchen. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Volumes nach Informationen zur Problembehebung suchen.

Anmerkung

Um Backups zu automatisieren, können Sie eine Aufgabe im AWS Systems Manager Wartungsfenster erstellen, die das AWSEC2-VssInstallAndSnapshot Dokument verwendet. Weitere Informationen finden Sie unter Arbeiten mit Wartungsfenstern (Konsole) im Benutzerhandbuch für AWS Systems Manager .