View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Référence du dossier d’exploitation Automation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWSSupport-RecoverWorkSpaceWithApproval

Description

Le AWSSupport-RecoverWorkSpaceWithApproval runbook exécute les étapes de restauration sur l'instance Amazon WorkSpaces (WorkSpaces) que vous spécifiez si son état de fonctionnement l'estUnhealthy. En fonction des valeurs que vous spécifiez pour les paramètres d'entrée et des instantanés disponibles, le runbook redémarre, restaure et reconstruit le WorkSpaces jusqu'à ce que son état soit atteint. Available Ce runbook utilise l'action aws:approve d'automatisation, qui interrompt temporairement l'automatisation jusqu'à ce que les responsables désignés approuvent ou refusent les actions de restauration sélectionnées.

Important

La restauration ou la reconstruction d'un site WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. En effet, le fichier WorkSpace est restauré à partir du dernier instantané disponible et les données récupérées à partir des instantanés peuvent dater de 12 heures.

L'option de restauration recrée à la fois le volume racine et le volume utilisateur en fonction des instantanés les plus récents. L'option de reconstruction recrée le volume utilisateur à partir de l'instantané le plus récent et le recrée WorkSpace à partir de l'image associée au bundle à partir duquel WorkSpace il a été créé. Les applications installées ou les paramètres système modifiés après leur WorkSpace création sont perdus. Pour plus d'informations sur la restauration et la reconstruction WorkSpaces, consultez Restaurer un WorkSpace et Reconstruire un WorkSpace dans le Guide d' WorkSpaces administration Amazon.

Avant d'utiliser ce runbook, nous vous recommandons de consulter la rubrique Résolution WorkSpaces des problèmes liés à Amazon dans le Guide d' WorkSpaces administration Amazon.

Comment ça marche

Le runbook exécute les actions de restauration suivantes dans l'ordre, en s'arrêtant dès qu' WorkSpaces il atteint un Available état :

  • Récupère l'état initial du WorkSpaces et confirme qu'il est dans un état récupérable (Unhealthy,, Error ImpairedStopped, ouAvailable).

  • Si WorkSpaces c'est le casStopped, lancez-le et attendez le résultat.

  • Récupère les instantanés de reconstruction et de restauration disponibles pour le. WorkSpaces

  • Envoie une notification d'approbation via Amazon Simple Notification Service (Amazon SNS) aux approbateurs désignés et fait une pause jusqu'à ce qu'elle soit approuvée ou refusée.

  • S'il Reboot est approuvé et défini surYes, redémarre le WorkSpaces et attend le résultat.

  • Si ce n' WorkSpaces est toujours pas le cas Available et qu'Restoreil est défini surYes, restaure le WorkSpaces cliché le plus récent et attend le résultat.

  • Si ce n' WorkSpaces est toujours pas le cas Available et Rebuild qu'il est défini surYes, reconstruit l'image WorkSpaces à partir de l'image du bundle la plus récente et attend le résultat.

  • Confirme l'état final de WorkSpaces l'étatAvailable.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

/

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Exemple de politique IAM :


{
    "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*"
        }
    ]
}
Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Ouvrez AWSSupport-RecoverWorkSpaceWithApproval dans le Gestionnaire de systèmes sous Documents.

  2. Choisissez Execute automation (Exécuter l’automatisation).

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole (Facultatif) :

      L'ARN du rôle AWS IAM qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook. Type :AWS::IAM::Role::Arn.

    • WorkspaceId (Obligatoire) :

      L'ID de l'objet WorkSpaces à récupérer. Doit correspondre au modèle^ws-[0-9a-z]{8,63}$. Type :String.

    • Redémarrer (facultatif) :

      Réglez Yes sur pour WorkSpaces autoriser le redémarrage. Valeur par défaut : Yes. Valeurs autorisées : Yes |No. Type :String.

    • Restaurer (facultatif) :

      Réglez Yes sur pour WorkSpaces autoriser la restauration. Le système est restauré sur l'instantané le plus récent du volume racine. Toutes les applications installées ou les paramètres système modifiés après la création du dernier instantané sont perdus. Le volume utilisateur est recréé à partir de l'instantané le plus récent et son contenu actuel est remplacé. Valeur par défaut : No. Valeurs autorisées : Yes |No. Type :String.

    • Reconstruire (facultatif) :

      Réglez Yes sur pour WorkSpaces permettre leur reconstruction. Le système est actualisé avec l'image la plus récente du bundle à partir duquel il WorkSpaces a été créé. Toutes les applications installées ou les paramètres système modifiés après WorkSpaces leur création sont perdus. Le volume utilisateur est recréé à partir de l'instantané le plus récent et son contenu actuel est remplacé. Valeur par défaut : No. Valeurs autorisées : Yes |No. Type :String.

    • Reconnaître (obligatoire) :

      Entrez Yes pour confirmer que les actions de restauration et de reconstruction permettent de récupérer les données WorkSpaces à partir de l'instantané le plus récent et que les données restaurées à partir des instantanés peuvent dater de 12 heures. Schéma autorisé :^[Yy][Ee][Ss]$. Type :String.

    • Approbateurs (obligatoire) :

      Liste des noms d'utilisateur IAM ou des ARN des approbateurs de l'action d'automatisation. Vous pouvez spécifier les principaux sous forme de nom d'utilisateur IAM, d'ARN d'utilisateur IAM, d'ARN de rôle IAM ou d'ARN d'utilisateur de rôle d'assume le rôle IAM. Minimum : 1, maximum : 10. Type :StringList.

    • MinRequiredApprovals (Facultatif) :

      Le nombre minimum d'approbations requises pour reprendre l'exécution de l'automatisation. La valeur ne peut pas dépasser le nombre d'approbateurs défini par le Approvers paramètre. Valeur par défaut : 1. Valeurs autorisées : 1 —10. Type :Integer.

    • SNSTopicArn (Obligatoire) :

      L'ARN de rubrique Amazon SNS utilisé pour envoyer la notification d'approbation en attente. Le nom de la rubrique Amazon SNS doit être préfixé par. Automation Type :String.

  4. Sélectionnez Execute (Exécuter).

  5. L'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • getWorkSpaceInitialState: Récupère l'état actuel du WorkSpaces.

    • assertWorkSpaceInitialState: confirme que l'état WorkSpaces est récupérable (Available,Error, StoppedUnhealthy, ouImpaired). L'automatisation s'arrête s'il se WorkSpaces trouve dans un autre état.

    • branchOnWorkSpaceInitialState: Branches basées sur l' WorkSpaces état initial. SiStopped, procède au démarrage du WorkSpaces. SiUnhealthy, ou ErrorImpaired, procède à la récupération des instantanés.

    • startWorkSpace: Démarre WorkSpaces s'il était dans un Stopped état.

    • waitForStartWorkSpace: Attend jusqu'à 10 minutes pour que le Starting statut WorkSpaces soit atteint.

    • waitForStartWorkSpaceResult: Attend jusqu'à 30 minutes WorkSpaces pour que le Available statut soit atteint UnhealthyError,Impaired, ou après le démarrage.

    • getWorkSpaceStateAfterStart: Récupère l' WorkSpaces état après la tentative de démarrage.

    • branchOnWorkSpaceStateAfterStart: Si WorkSpaces c'est le casAvailable, passe à l'assertion finale. Sinon, procède à la récupération des instantanés.

    • getWorkSpaceSnapshots: Récupère les instantanés de reconstruction et de restauration disponibles pour le. WorkSpaces

    • approval: envoie une notification d'approbation à la rubrique Amazon SNS spécifiée et interrompt l'automatisation pendant 24 heures au maximum, en attendant que les approbateurs désignés approuvent ou refusent les actions de restauration.

    • branchOnRebootAllowed: S'Rebootil est réglé surYes, redémarre le WorkSpaces. Sinon, passe à la branche de restauration.

    • rebootWorkSpace: Redémarre le. WorkSpaces

    • waitForRebootWorkSpace: Attend jusqu'à 10 minutes pour que le Rebooting statut WorkSpaces soit atteint.

    • waitForRebootWorkSpaceResult: Attend jusqu'à 30 minutes WorkSpaces pour que le Available statut soit atteint Unhealthy ou après le redémarrage. Error

    • getWorkSpaceStateAfterReboot: Récupère l' WorkSpaces état après la tentative de redémarrage.

    • branchOnWorkSpaceStateAfterReboot: Si WorkSpaces c'est le casAvailable, passe à l'assertion finale. Sinon, passe à la branche de restauration.

    • branchOnRestoreAllowed: S'il Restore est réglé surYes, procède à la restauration du WorkSpaces. Sinon, passe à la branche de reconstruction.

    • restoreWorkSpace: restaure le WorkSpaces cliché le plus récent. Si la restauration échoue, l'automatisation passe à la branche de reconstruction.

    • waitForRestoreWorkSpace: Attend jusqu'à 10 minutes pour que le Restoring statut WorkSpaces soit atteint.

    • waitForRestoreWorkSpaceResult: Attend jusqu'à 30 minutes WorkSpaces pour que le Available statut soit atteint Unhealthy ou après la restauration. Error

    • getWorkSpaceStateAfterRestore: récupère l' WorkSpaces état après la tentative de restauration.

    • branchOnWorkSpaceStateAfterRestore: Si WorkSpaces c'est le casAvailable, passe à l'assertion finale. Sinon, passe à la branche de reconstruction.

    • branchOnRebuildAllowed: s'il Rebuild est défini surYes, procède à la reconstruction du WorkSpaces. Dans le cas contraire, passe à l'assertion finale.

    • rebuildWorkSpace: Reconstruit le WorkSpaces à partir de l'image du bundle la plus récente.

    • waitForRebuildWorkSpace: Attend jusqu'à 10 minutes pour que le Rebuilding statut WorkSpaces soit atteint.

    • waitForRebuildWorkSpaceResult: Attend jusqu'à 30 minutes WorkSpaces pour que le Available statut soit atteint Unhealthy ou après la reconstruction. Error

    • getWorkSpaceStateAfterRebuild: Récupère l' WorkSpaces état après la tentative de reconstruction.

    • assertWorkSpaceFinalState: confirme que le WorkSpaces statut estAvailable. L'automatisation échoue s'il n' WorkSpaces est pas dans un Available état.

  7. Une fois l'exécution terminée, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution.

Références

Systems Manager Automation