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) dont vous spécifiez l'état de fonctionnement. Unhealthy En fonction des valeurs que vous spécifiez pour les paramètres d'entrée et les instantanés disponibles, le runbook redémarre, restaure et reconstruit le fichier WorkSpaces jusqu'à ce que son état soit rétabli. Available Ce runbook utilise l'action aws:approve d'automatisation, qui suspend 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 WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. Cela est dû au fait que les WorkSpace données sont restaurées à partir du dernier instantané disponible et que 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 Restore a WorkSpace et Rebuild a 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, ou). Available

  • Si WorkSpaces c'est le casStopped, démarrez-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 instantané 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 du bundle WorkSpaces à partir de l'image du bundle la plus récente et attend le résultat.

  • Confirme l'état final du WorkSpaces isAvailable.

Exécuter 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-RecoverWorkSpaceWithApprovaldans Systems Manager sous Documents.

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

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • 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 lance ce runbook. Type :AWS::IAM::Role::Arn.

    • WorkspaceId (Obligatoire) :

      L'ID du WorkSpaces à récupérer. Doit correspondre au schéma^ws-[0-9a-z]{8,63}$. Type :String.

    • Redémarrage (facultatif) :

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

    • Restaurer (facultatif) :

      Réglez Yes sur pour WorkSpaces permettre 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 la 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.

    • Confirmez (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 d'instantanés peuvent dater de 12 heures. Modèle autorisé :^[Yy][Ee][Ss]$. Type :String.

    • Approbateurs (obligatoire) :

      Liste des noms d'utilisateur ou ARN IAM des approbateurs pour l'action d'automatisation. Vous pouvez spécifier des principes 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 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 la 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 prend fin s' WorkSpaces il est dans un autre état.

    • branchOnWorkSpaceInitialState: Branches basées sur l' WorkSpaces état initial. SiStopped, continue à démarrer le WorkSpaces. If UnhealthyError, orImpaired, procède à la récupération des instantanés.

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

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

    • waitForStartWorkSpaceResult: Attend jusqu'à 30 minutes jusqu' WorkSpaces à ce que le Available statut atteigne 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édez à 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 suspend l'automatisation pendant 24 heures au maximum, en attendant que les approbateurs désignés approuvent ou refusent les actions de restauration.

    • branchOnRebootAllowed: Si Reboot ce paramètre est défini surYes, redémarre le WorkSpaces. Sinon, passez à la branche de restauration.

    • rebootWorkSpace: Redémarre le. WorkSpaces

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

    • waitForRebootWorkSpaceResult: attend jusqu'à 30 minutes que le statut WorkSpaces atteigne ou atteigne Unhealthy Error le Available statut après le redémarrage.

    • 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, passez à la branche de restauration.

    • branchOnRestoreAllowed: si Restore ce paramètre est défini surYes, procède à la restauration du WorkSpaces. Sinon, passez à la branche de reconstruction.

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

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

    • waitForRestoreWorkSpaceResult: attend jusqu'à 30 minutes que le Available statut WorkSpaces soit atteint Unhealthy ou atteint 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, passez à la branche de reconstruction.

    • branchOnRebuildAllowed: si Rebuild ce paramètre est défini surYes, procède à la reconstruction du WorkSpaces. Dans le cas contraire, passez à l'assertion finale.

    • rebuildWorkSpace: Reconstruit l'image du bundle WorkSpaces à partir de la dernière image du bundle.

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

    • waitForRebuildWorkSpaceResult: attend jusqu'à 30 minutes que le statut WorkSpaces atteigne ou atteigne Unhealthy Error le Available statut après la reconstruction.

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

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

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

Références

Systems Manager Automation