View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Referencia del manual de procedimientos de Automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-RecoverWorkSpaceWithApproval

Description (Descripción)

El AWSSupport-RecoverWorkSpaceWithApproval runbook lleva a cabo los pasos de recuperación de la instancia de Amazon WorkSpaces (WorkSpaces) que especifiques si su estado operativo es el siguiente. Unhealthy Según los valores que especifiques para los parámetros de entrada y las instantáneas disponibles, el runbook se reinicia, restaura y reconstruye hasta que pasa a estar en estado. WorkSpaces Available Este libro de operaciones utiliza la acción de aws:approve automatización, que detiene temporalmente la automatización hasta que los directores designados aprueben o rechacen las acciones de recuperación seleccionadas.

importante

Restaurar o reconstruir una WorkSpace es una acción potencialmente destructiva que puede provocar la pérdida de datos. Esto se debe a que WorkSpace se restaura a partir de la última instantánea disponible y los datos recuperados de las instantáneas pueden tener una antigüedad de hasta 12 horas.

La opción de restauración recrea tanto el volumen raíz como el volumen de usuarios en función de las instantáneas más recientes. La opción de reconstrucción recrea el volumen de usuario a partir de la instantánea más reciente y recrea el volumen de usuario a WorkSpace partir de la imagen asociada al paquete a partir del cual WorkSpace se creó. Las aplicaciones que se instalaron o la configuración del sistema que se modificó después de su creación WorkSpace se pierden. Para obtener más información sobre la restauración y la reconstrucción WorkSpaces, consulte Restaurar WorkSpace y reconstruir a WorkSpace en la Guía de WorkSpaces administración de Amazon.

Antes de utilizar este manual, recomendamos revisar el tema Solución de problemas de Amazon WorkSpaces de la Guía de WorkSpaces administración de Amazon.

Funcionamiento

El runbook lleva a cabo las siguientes acciones de recuperación de forma secuencial y se detiene en cuanto WorkSpaces alcanza un Available estado:

  • Recupera el estado inicial del WorkSpaces y confirma que se encuentra en un estado recuperable (Unhealthy,,, Error ImpairedStopped, o). Available

  • Si WorkSpaces es asíStopped, lo inicia y espera el resultado.

  • Recupera las instantáneas de reconstrucción y restauración disponibles para. WorkSpaces

  • Envía una notificación de aprobación a través de Amazon Simple Notification Service (Amazon SNS) a los aprobadores designados y la detiene hasta que se aprueba o deniega.

  • Si se aprueba y Reboot se establece enYes, se reinicia WorkSpaces y espera el resultado.

  • Si aún no lo WorkSpaces está Available y Restore está establecido enYes, WorkSpaces restaura la instantánea más reciente y espera el resultado.

  • Si aún no WorkSpaces lo está Available y Rebuild está establecido enYes, reconstruye la imagen a WorkSpaces partir de la imagen del paquete más reciente y espera el resultado.

  • Confirma el estado final del es WorkSpaces . Available

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

/

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Política de IAM de ejemplo:


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

Siga estos pasos para configurar la automatización:

  1. Abra AWSSupport-RecoverWorkSpaceWithApproval en Systems Manager, en Documentos.

  2. Elija Ejecutar automatización.

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El AWS ARN del rol de IAM que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos. Tipo: AWS::IAM::Role::Arn.

    • WorkspaceId (Obligatorio):

      El ID del que se WorkSpaces va a recuperar. Debe coincidir con el patrón^ws-[0-9a-z]{8,63}$. Tipo: String.

    • Reiniciar (opcional):

      YesConfigúrelo para permitir WorkSpaces que se reinicie. Predeterminado: Yes. Valores permitidos: Yes |. No Tipo: String.

    • Restaurar (opcional):

      YesConfigúrelo en WorkSpaces para permitir la restauración. El sistema se restaura en la instantánea más reciente del volumen raíz. Se perderán todas las aplicaciones instaladas o la configuración del sistema que se haya modificado después de crear la instantánea más reciente. El volumen de usuario se recrea a partir de la instantánea más reciente y su contenido actual se sobrescribe. Predeterminado: No. Valores permitidos: Yes |. No Tipo: String.

    • Reconstruir (opcional):

      Configúrelo en Yes para permitir WorkSpaces que se reconstruya. El sistema se actualiza con la imagen más reciente del paquete a partir del cual WorkSpaces se creó. Se pierden todas las aplicaciones instaladas o los ajustes del WorkSpaces sistema cambiados después de su creación. El volumen de usuario se recrea a partir de la instantánea más reciente y se sobrescribe su contenido actual. Predeterminado: No. Valores permitidos: Yes |. No Tipo: String.

    • Confirmar (obligatorio):

      Introdúzcalo Yes para confirmar que tanto las acciones de restauración como las WorkSpaces de reconstrucción recuperan los datos de la instantánea más reciente y que los datos restaurados a partir de instantáneas pueden tener una antigüedad de hasta 12 horas. Patrón permitido:^[Yy][Ee][Ss]$. Tipo: String.

    • Autorizadores (obligatorio):

      Una lista de los nombres de usuario o ARN de IAM de los aprobadores de la acción de automatización. Puede especificar los principales como nombre de usuario de IAM, ARN de usuario de IAM, ARN de rol de IAM o ARN de usuario de rol asumido de IAM. Mínimo: 1, máximo: 10. Tipo: StringList.

    • MinRequiredApprovals (Opcional):

      El número mínimo de aprobaciones necesario para reanudar la ejecución de la automatización. El valor no puede superar el número de aprobadores definido por el Approvers parámetro. Predeterminado: 1. Valores permitidos: 1 —10. Tipo: Integer.

    • SNSTopicArn (Obligatorio):

      El ARN del tema de Amazon SNS utilizado para enviar la notificación de aprobación pendiente. El nombre del tema de Amazon SNS debe ir precedido de. Automation Tipo: String.

  4. Elija Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • getWorkSpaceInitialState: Recupera el estado actual de. WorkSpaces

    • assertWorkSpaceInitialState: Confirma que WorkSpaces se encuentra en un estado recuperable (Available,Error, StoppedUnhealthy, oImpaired). La automatización finaliza si se WorkSpaces encuentra en cualquier otro estado.

    • branchOnWorkSpaceInitialState: Se bifurcan según el WorkSpaces estado inicial. SiStopped, procede a iniciar el WorkSpaces. Si UnhealthyError, oImpaired, procede a recuperar las instantáneas.

    • startWorkSpace: Inicia WorkSpaces si estaba en un Stopped estado.

    • waitForStartWorkSpace: Espera hasta 10 minutos para WorkSpaces que alcance el Starting estado.

    • waitForStartWorkSpaceResult: Espera hasta 30 minutos para que alcance el WorkSpaces Available estado Unhealthy ErrorImpaired, o después de empezar.

    • getWorkSpaceStateAfterStart: recupera el WorkSpaces estado tras el intento de inicio.

    • branchOnWorkSpaceStateAfterStart: Si WorkSpaces esAvailable, pasa a la afirmación final. De lo contrario, procede a recuperar las instantáneas.

    • getWorkSpaceSnapshots: recupera las instantáneas de reconstrucción y restauración disponibles para. WorkSpaces

    • approval: Envía una notificación de aprobación al tema de Amazon SNS especificado y detiene la automatización durante un máximo de 24 horas, a la espera de que los aprobadores designados aprueben o rechacen las acciones de recuperación.

    • branchOnRebootAllowed: Si Reboot está establecido enYes, procede a reiniciar el. WorkSpaces De lo contrario, pasa a la rama de restauración.

    • rebootWorkSpace: Reinicia el WorkSpaces.

    • waitForRebootWorkSpace: Espera hasta 10 minutos para que alcance Rebooting el WorkSpaces estado.

    • waitForRebootWorkSpaceResult: Espera hasta 30 minutos para que alcance Unhealthy el WorkSpaces Available estado o Error se reinicie.

    • getWorkSpaceStateAfterReboot: recupera el WorkSpaces estado tras el intento de reinicio.

    • branchOnWorkSpaceStateAfterReboot: Si WorkSpaces esAvailable, pasa a la afirmación final. De lo contrario, pasa a la rama de restauración.

    • branchOnRestoreAllowed: Si Restore está establecido enYes, procede a restaurar el WorkSpaces. De lo contrario, pasa a la rama de reconstrucción.

    • restoreWorkSpace: restaura la instantánea WorkSpaces de la más reciente. Si se produce un error en la restauración, la automatización pasa a la rama de reconstrucción.

    • waitForRestoreWorkSpace: Espera hasta 10 minutos para WorkSpaces que alcance el Restoring estado.

    • waitForRestoreWorkSpaceResult: Espera hasta 30 minutos para que alcance Unhealthy el WorkSpaces Available estado o Error se restablezca.

    • getWorkSpaceStateAfterRestore: recupera el WorkSpaces estado tras el intento de restauración.

    • branchOnWorkSpaceStateAfterRestore: Si WorkSpaces esAvailable, pasa a la afirmación final. De lo contrario, pasa a la rama de reconstrucción.

    • branchOnRebuildAllowed: Si Rebuild está establecido enYes, continúa con la reconstrucción de WorkSpaces. De lo contrario, pasa a la afirmación final.

    • rebuildWorkSpace: Reconstruye la imagen WorkSpaces a partir de la imagen del paquete más reciente.

    • waitForRebuildWorkSpace: Espera hasta 10 minutos para que alcance Rebuilding el WorkSpaces estado.

    • waitForRebuildWorkSpaceResult: Espera hasta 30 minutos para que alcance Unhealthy el WorkSpaces Available estado o después Error de la reconstrucción.

    • getWorkSpaceStateAfterRebuild: recupera el WorkSpaces estado tras el intento de reconstrucción.

    • assertWorkSpaceFinalState: Confirma que el WorkSpaces estado esAvailable. La automatización falla si no WorkSpaces está en un Available estado.

  7. Una vez finalizada, revise la sección Salidas para ver los resultados detallados de la ejecución.

Referencias

Automatización de Systems Manager