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, sofern sie betriebsbereit ist. Unhealthy 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 sein Status erreicht ist. WorkSpaces Available Dieses Runbook verwendet die aws:approve Automatisierungsaktion, die die Automatisierung vorübergehend unterbricht, bis die angegebenen Principals die ausgewählten Wiederherstellungsaktionen entweder genehmigen oder ablehnen.

Wichtig

Das Wiederherstellen oder Neuerstellen von a 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 Root-Volume als auch das Benutzer-Volume auf der Grundlage der neuesten Snapshots neu erstellt. Mit der Neuerstellungsoption wird das Benutzer-Volume aus dem neuesten Snapshot neu erstellt und das aus dem Image neu erstellt, das dem Paket zugeordnet ist, WorkSpace aus dem es erstellt wurde. WorkSpace Anwendungen, die installiert wurden, oder Systemeinstellungen, die nach der Erstellung geändert wurden, WorkSpace gehen verloren. Weitere Informationen zum Wiederherstellen und Neuerstellen finden Sie unter Restore a WorkSpace und WorkSpaces Rebuild a WorkSpace im WorkSpaces Amazon-Administratorhandbuch.

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

Funktionsweise

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

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

  • Ist dies der WorkSpaces FallStopped, wird es gestartet und auf das Ergebnis gewartet.

  • Ruft verfügbare Neuerstellungs- und Wiederherstellungs-Snapshots für den ab. WorkSpaces

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

  • Falls genehmigt und auf gesetztYes, Reboot wird das neu gestartet WorkSpaces und auf das Ergebnis gewartet.

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

  • Wenn 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

Folgen Sie diesen Schritten, um die Automatisierung zu konfigurieren:

  1. Öffnen Sie AWSSupport-RecoverWorkSpaceWithApproval im Systems Manager unter Dokumente.

  2. Wählen Sie Automatisierung ausführen.

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

    • AutomationAssumeRole (Fakultativ):

      Der AWS IAM-Rollen-ARN, der es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszufü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):

      Stellen Sie den Yes Wert auf ein WorkSpaces , um einen Neustart von zu ermöglichen. Standard: Yes. Zulässige Werte: |Yes. No Typ:String.

    • Wiederherstellen (optional):

      Stellen Sie den Yes Wert auf ein WorkSpaces , um die Wiederherstellung von zu ermöglichen. Das System wird mit dem neuesten Snapshot des Stamm-Volumes wiederhergestellt. Alle installierten Anwendungen oder Systemeinstellungen, die nach der Erstellung des letzten Snapshots geändert wurden, gehen verloren. Das Benutzer-Volume wird anhand des neuesten Snapshots neu erstellt und sein aktueller Inhalt wird überschrieben. Standard: No. Zulässige Werte: |Yes. No Typ:String.

    • Neuaufbau (optional):

      Stellen Sie den Yes Wert auf ein WorkSpaces , damit der neu erstellt werden kann. Das System wird mit dem neuesten Image des Pakets aktualisiert, aus dem das erstellt WorkSpaces wurde. Alle Anwendungen, die nach der Erstellung installiert wurden, oder die Systemeinstellungen, die nach der Erstellung geändert WorkSpaces wurden, gehen verloren. Das Benutzer-Volume wird anhand des neuesten 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 die Daten WorkSpaces aus dem letzten Snapshot wiederhergestellt werden und dass aus Snapshots wiederhergestellte Daten bis zu 12 Stunden alt sein können. 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 Prinzipale als IAM-Benutzernamen, IAM-Benutzer-ARN, IAM-Rollen-ARN oder Benutzer-ARN mit IAM-Übernahmerolle angeben. Minimal: 1, Maximum: 10. Typ:StringList.

    • MinRequiredApprovals (Fakultativ):

      Die Mindestanzahl von Genehmigungen, die erforderlich sind, um die Automatisierungsausführung 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 ARN des Amazon SNS-Themas, der zum Senden der Benachrichtigung über die ausstehende Genehmigung verwendet wurde. Dem Namen des Amazon 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: Verzweigungen basieren auf dem WorkSpaces Ausgangszustand. WennStopped, fährt mit dem Starten von fort WorkSpaces. WennUnhealthy, oder ErrorImpaired, fährt mit dem Abrufen von Schnappschüssen fort.

    • startWorkSpace: Startet den WorkSpaces , wenn er sich in einem Stopped Zustand befand.

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

    • waitForStartWorkSpaceResult: Wartet bis zu 30 Minuten, WorkSpaces bis der Available StatusUnhealthy, ErrorImpaired, oder nach dem Start erreicht wird.

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

    • branchOnWorkSpaceStateAfterStart: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Assertion fortgefahren. Andernfalls wird mit dem Abrufen von Schnappschüssen fortgefahren.

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

    • approval: Sendet eine Genehmigungsbenachrichtigung an das angegebene Amazon SNS-Thema und unterbricht die Automatisierung für bis zu 24 Stunden, bis die zuständigen Genehmigungsberechtigten die Wiederherstellungsmaßnahmen genehmigen oder ablehnen.

    • branchOnRebootAllowed: Wenn auf gesetzt Reboot istYes, fährt er mit dem Neustart von fort. 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 MinutenUnhealthy, bis der WorkSpaces Available Status oder nach dem Error Neustart erreicht ist.

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

    • branchOnWorkSpaceStateAfterReboot: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Assertion 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. Schlägt die Wiederherstellung fehl, fährt die Automatisierung mit dem Rebuild-Branch fort.

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

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

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

    • branchOnWorkSpaceStateAfterRestore: Wenn jaAvailable, WorkSpaces wird mit der endgültigen Assertion fortgefahren. Andernfalls fahren Sie mit dem Rebuild-Zweig fort.

    • branchOnRebuildAllowed: Wenn auf gesetzt Rebuild istYes, wird mit dem Neuaufbau von fortgefahren WorkSpaces. Andernfalls wird mit der endgültigen Assertion 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 nach dem Neuaufbau bis zu 30 Minuten UnhealthyError, WorkSpaces bis der Available Status oder erreicht ist.

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

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

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

Referenzen

Systems Manager Automation