View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Runbook-Referenz für Automation

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.

AWSSupport-RecoverWorkSpaceWithApproval

Description

Das AWSSupport-RecoverWorkSpaceWithApproval Runbook führt Wiederherstellungsschritte auf der Amazon WorkSpaces (WorkSpaces) -Instance durch, die Sie angeben, wenn der Betriebsstatus lautetUnhealthy. Abhängig von den Werten, die Sie für die Eingabeparameter angeben, und den verfügbaren Snapshots wird das Runbook neu gestartet, wiederhergestellt und neu erstellt, bis der Status WorkSpaces Available Dieses Runbook verwendet die aws:approve Automatisierungsaktion, mit der die Automatisierung vorübergehend angehalten wird, bis die designierten Principals die ausgewählten Wiederherstellungsaktionen entweder genehmigen oder ablehnen.

Wichtig

Das Wiederherstellen oder Neuerstellen einer WorkSpace ist eine potenziell zerstörerische Aktion, die zum Verlust von Daten führen kann. Dies liegt daran, dass der aus dem letzten verfügbaren Snapshot wiederhergestellt WorkSpace wird und Daten, die aus Snapshots wiederhergestellt wurden, bis zu 12 Stunden alt sein können.

Mit der Wiederherstellungsoption werden sowohl das Stammvolume als auch das Benutzervolume auf der Grundlage der neuesten Snapshots neu erstellt. Mit der Neuerstellungsoption wird das Benutzer-Volume aus dem letzten Snapshot und das aus dem Image, das dem Bundle zugeordnet ist, WorkSpace aus dem es erstellt wurde, neu erstellt. WorkSpace Anwendungen, die installiert wurden, oder Systemeinstellungen, die nach der Erstellung geändert wurden, WorkSpace gehen verloren. Weitere Informationen zur Wiederherstellung und WorkSpaces Neuerstellung finden Sie unter Restore a WorkSpace und Rebuild a WorkSpace im Amazon WorkSpaces Administration Guide.

Bevor Sie dieses Runbook verwenden, empfehlen wir Ihnen, das Thema Fehlerbehebung Amazon WorkSpaces Amazon-Problemen im WorkSpaces Amazon-Administratorhandbuch zu lesen.

Funktionsweise

Das Runbook führt nacheinander die folgenden Wiederherstellungsaktionen durch und stoppt, sobald es einen Available bestimmten Status WorkSpaces erreicht:

  • Ruft den Anfangsstatus von ab WorkSpaces und bestätigt, dass er sich in einem wiederherstellbaren Zustand befindet (Unhealthy,, ErrorImpaired, Stopped oder). Available

  • Wenn ja WorkSpaces Stopped, startet es und wartet auf das Ergebnis.

  • Ruft verfügbare Neuaufbau- und Wiederherstellungsschnappschüsse für ab. WorkSpaces

  • Sendet eine Genehmigungsbenachrichtigung über Amazon Simple Notification Service (Amazon SNS) an die benannten Genehmiger und pausiert, bis sie genehmigt oder verweigert wird.

  • Wenn genehmigt und auf eingestelltYes, Reboot wird der neu gestartet WorkSpaces und auf das Ergebnis gewartet.

  • Falls das WorkSpaces immer noch nicht Restore ist Available und auf gesetzt istYes, wird das WorkSpaces aus dem letzten Snapshot wiederhergestellt und auf das Ergebnis gewartet.

  • Falls das WorkSpaces immer noch nicht der Available Fall Rebuild ist und auf gesetzt istYes, wird das WorkSpaces aus dem neuesten Bundle-Image neu erstellt und auf das Ergebnis gewartet.

  • Bestätigt den endgültigen Status von ist. WorkSpaces Available

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

/

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Beispiel für eine IAM-Richtlinie:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "workspaces:DescribeWorkspaces",
                "workspaces:DescribeWorkspaceSnapshots",
                "workspaces:RebootWorkspaces",
                "workspaces:RebuildWorkspaces",
                "workspaces:RestoreWorkspace",
                "workspaces:StartWorkspaces"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "sns:Publish",
            "Resource": "arn:aws:sns:*:*:Automation*"
        }
    ]
}
Anleitungen

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

  1. Öffnen Sie AWSSupport-RecoverWorkSpaceWithApprovalim Systems Manager unter Dokumente.

  2. Wählen Sie Automatisierung ausführen.

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ):

      Die AWS IAM-Rolle ARN, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet. Typ:AWS::IAM::Role::Arn.

    • WorkspaceId (Erforderlich):

      Die ID des WorkSpaces wiederherzustellenden. Muss dem Muster entsprechen^ws-[0-9a-z]{8,63}$. Typ:String.

    • Neustart (optional):

      Auf einstellenYes, damit der neu WorkSpaces gestartet werden kann. Standard: Yes. Zulässige Werte: |Yes. No Typ:String.

    • Wiederherstellen (optional):

      Auf einstellenYes, damit WorkSpaces das wiederhergestellt werden kann. Das System wird mit dem neuesten Snapshot des Stamm-Volumes wiederhergestellt. Alle nach der Erstellung des letzten Snapshots installierten Anwendungen oder geänderten Systemeinstellungen gehen verloren. Das Benutzervolume wird anhand des letzten Snapshots neu erstellt und sein aktueller Inhalt wird überschrieben. Standard: No. Zulässige Werte: |Yes. No Typ:String.

    • Neu erstellen (optional):

      Wird auf gesetztYes, damit WorkSpaces das neu erstellt werden kann. Das System wird mit dem neuesten Bild des Bundles aktualisiert, aus dem das erstellt WorkSpaces wurde. Alle nach der Erstellung installierten Anwendungen oder geänderten Systemeinstellungen gehen verloren. WorkSpaces Das Benutzervolume wird anhand des letzten Snapshots neu erstellt und sein aktueller Inhalt wird überschrieben. Standard: No. Zulässige Werte: |Yes. No Typ:String.

    • Bestätigen (erforderlich):

      Geben Sie ein, Yes um zu bestätigen, dass sowohl bei der Wiederherstellung als auch beim Neuaufbau der neueste Snapshot wiederhergestellt wird und dass Daten, die aus Snapshots wiederhergestellt wurden, bis zu 12 Stunden alt sein können. WorkSpaces Zulässiges Muster:^[Yy][Ee][Ss]$. Typ:String.

    • Genehmigende Personen (erforderlich):

      Eine Liste der IAM-Benutzernamen oder ARNs der Genehmiger für die Automatisierungsaktion. Sie können Principals als IAM-Benutzernamen, IAM-Benutzer-ARN, IAM-Rollen-ARN oder IAM-Annahme-Rollen-Benutzer-ARN angeben. Minimum: 1, Maximum: 10. Typ:StringList.

    • MinRequiredApprovals (Fakultativ):

      Die Mindestanzahl von Genehmigungen, die erforderlich sind, um die Ausführung der Automatisierung wieder aufzunehmen. Der Wert darf die durch den Parameter definierte Anzahl der Genehmiger nicht überschreiten. Approvers Standard: 1. Zulässige Werte: 1 —10. Typ:Integer.

    • SNSTopicArn (Erforderlich):

      Der Amazon SNS-Thema-ARN, der zum Senden der Benachrichtigung über die ausstehende Genehmigung verwendet wurde. Dem Namen des Amazon SNS SNS-Themas muss ein Präfix vorangestellt werden. Automation Typ:String.

  4. Wählen Sie Ausführen.

  5. Die Automatisierung wird eingeleitet.

  6. Das Dokument führt die folgenden Schritte aus:

    • getWorkSpaceInitialState: Ruft den aktuellen Status von ab. WorkSpaces

    • assertWorkSpaceInitialState: Bestätigt, dass WorkSpaces sich der in einem wiederherstellbaren Zustand befindet (Available,, Error StoppedUnhealthy, oder). Impaired Die Automatisierung endet, wenn sich der in einem anderen Zustand WorkSpaces befindet.

    • branchOnWorkSpaceInitialState: Verzweigt auf der Grundlage des WorkSpaces Ausgangsstatus. WennStopped, fährt mit dem Start von fort WorkSpaces. WennUnhealthy, oder ErrorImpaired, fährt mit dem Abrufen von Snapshots fort.

    • startWorkSpace: Startet das WorkSpaces , wenn es sich in einem Stopped Zustand befand.

    • waitForStartWorkSpace: Wartet bis zu 10 Minuten, WorkSpaces bis der Starting Status erreicht ist.

    • waitForStartWorkSpaceResult: Wartet nach dem Start bis zu 30 Minuten, WorkSpaces bis der Available Status UnhealthyError,Impaired, oder erreicht ist.

    • getWorkSpaceStateAfterStart: Ruft den WorkSpaces Status nach dem Startversuch ab.

    • branchOnWorkSpaceStateAfterStart: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Bestätigung fortgefahren. Andernfalls wird mit dem Abrufen von Snapshots fortgefahren.

    • getWorkSpaceSnapshots: Ruft verfügbare Neuaufbau- und Wiederherstellungs-Snapshots für ab. WorkSpaces

    • approval: Sendet eine Genehmigungsbenachrichtigung an das angegebene Amazon SNS SNS-Thema und unterbricht die Automatisierung für bis zu 24 Stunden, bis die benannten Genehmiger die Wiederherstellungsaktionen genehmigen oder ablehnen.

    • branchOnRebootAllowed: Wenn auf gesetzt Reboot istYes, wird mit dem Neustart von fortgefahren. WorkSpaces Andernfalls wird mit dem Wiederherstellungszweig fortgefahren.

    • rebootWorkSpace: Startet den WorkSpaces neu.

    • waitForRebootWorkSpace: Wartet bis zu 10 Minuten, WorkSpaces bis der Status erreicht Rebooting ist.

    • waitForRebootWorkSpaceResult: Wartet bis zu 30 Minuten, bis der WorkSpaces Available Status UnhealthyError, oder nach dem Neustart erreicht ist.

    • getWorkSpaceStateAfterReboot: Ruft den WorkSpaces Status nach dem Neustartversuch ab.

    • branchOnWorkSpaceStateAfterReboot: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Bestätigung fortgefahren. Andernfalls wird mit dem Wiederherstellungszweig fortgefahren.

    • branchOnRestoreAllowed: Wenn auf gesetzt Restore istYes, wird mit der Wiederherstellung von fortgefahren WorkSpaces. Andernfalls wird mit dem Rebuild-Zweig fortgefahren.

    • restoreWorkSpace: Stellt den WorkSpaces aus dem letzten Snapshot wieder her. Wenn die Wiederherstellung fehlschlägt, fährt die Automatisierung mit dem Rebuild-Zweig fort.

    • waitForRestoreWorkSpace: Wartet bis zu 10 Minuten, WorkSpaces bis der Restoring Status erreicht ist.

    • waitForRestoreWorkSpaceResult: Wartet bis zu 30 Minuten, bis der WorkSpaces Available Status UnhealthyError, oder nach der Wiederherstellung erreicht ist.

    • getWorkSpaceStateAfterRestore: Ruft den WorkSpaces Status nach dem Wiederherstellungsversuch ab.

    • branchOnWorkSpaceStateAfterRestore: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Bestätigung fortgefahren. Andernfalls wird mit dem Rebuild-Zweig fortgefahren.

    • branchOnRebuildAllowed: Wenn auf gesetzt Rebuild istYes, wird mit dem Neuaufbau von fortgefahren WorkSpaces. Andernfalls wird mit der endgültigen Bestätigung fortgefahren.

    • rebuildWorkSpace: Erstellt das WorkSpaces aus dem neuesten Bundle-Image neu.

    • waitForRebuildWorkSpace: Wartet bis zu 10 Minuten, WorkSpaces bis der Status erreicht Rebuilding ist.

    • waitForRebuildWorkSpaceResult: Wartet bis zu 30 Minuten, bis der WorkSpaces Available Status UnhealthyError, oder nach der Wiederherstellung erreicht ist.

    • getWorkSpaceStateAfterRebuild: Ruft den WorkSpaces Status nach dem Neuaufbauversuch ab.

    • assertWorkSpaceFinalState: Bestätigt, dass der WorkSpaces Status lautetAvailable. Die Automatisierung schlägt fehl, wenn WorkSpaces sich der nicht im Available Status befindet.

  7. Nach Abschluss der Ausführung finden Sie im Abschnitt „Ausgaben“ die detaillierten Ergebnisse der Ausführung.

Referenzen

Systems Manager Automation