View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Referência do runbooks de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWSSupport-RecoverWorkSpaceWithApproval

Description

O AWSSupport-RecoverWorkSpaceWithApproval runbook executa etapas de recuperação na instância Amazon WorkSpaces (WorkSpaces) que você especifica se seu estado operacional forUnhealthy. Dependendo dos valores que você especificar para os parâmetros de entrada e os instantâneos disponíveis, o runbook reinicia, restaura e reconstrói o até que seu status se torne. WorkSpaces Available Esse runbook usa a ação de aws:approve automação, que pausa temporariamente a automação até que os diretores designados aprovem ou neguem as ações de recuperação selecionadas.

Importante

Restaurar ou reconstruir um WorkSpace é uma ação potencialmente destrutiva que pode resultar na perda de dados. Isso ocorre porque o WorkSpace é restaurado a partir do último instantâneo disponível e os dados recuperados dos instantâneos podem durar até 12 horas.

A opção de restauração recria o volume raiz e o volume do usuário com base nos snapshots mais recentes. A opção de reconstrução recria o volume do usuário a partir do snapshot mais recente e o recria da imagem associada ao pacote a WorkSpace partir do qual foi criado. WorkSpace Os aplicativos que foram instalados ou as configurações do sistema que foram alteradas após a WorkSpace criação são perdidos. Para obter mais informações sobre restauração e reconstrução WorkSpaces, consulte Restore a WorkSpace e Rebuild a WorkSpace no Guia de Administração da Amazon WorkSpaces .

Antes de usar este runbook, recomendamos revisar o tópico Solução de problemas da Amazon WorkSpaces no Guia de WorkSpaces administração da Amazon.

Como funciona

O runbook executa as seguintes ações de recuperação em sequência, parando assim que elas WorkSpaces atingem um Available estado:

  • Recupera o estado inicial do WorkSpaces e confirma que ele está em um estado recuperável (Unhealthy,, ErrorImpaired, Stopped ou). Available

  • Se WorkSpaces for o casoStopped, inicie e aguarde o resultado.

  • Recupera os instantâneos de reconstrução e restauração disponíveis para o. WorkSpaces

  • Envia uma notificação de aprovação por meio do Amazon Simple Notification Service (Amazon SNS) para os aprovadores designados e pausa até ser aprovada ou negada.

  • Se aprovado e Reboot definido comoYes, reinicia o WorkSpaces e aguarda o resultado.

  • Se o ainda não WorkSpaces estiver Available e Restore estiver definido comoYes, restaura o WorkSpaces do instantâneo mais recente e aguarda o resultado.

  • Se ainda não WorkSpaces estiver Available e Rebuild estiver definido comoYes, reconstrói a WorkSpaces partir da imagem do pacote mais recente e aguarda o resultado.

  • Confirma o estado final do WorkSpaces éAvailable.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

/

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Exemplo de política do 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*"
        }
    ]
}
Instruções

Siga estas etapas para configurar a automação:

  1. Abra AWSSupport-RecoverWorkSpaceWithApproval no Systems Manager em Documentos.

  2. Escolha Execute automation.

  3. Para os parâmetros de entrada, insira o seguinte:

    • AutomationAssumeRole (Opcional):

      A função AWS IAM ARN que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook. Tipo:AWS::IAM::Role::Arn.

    • WorkspaceId (Obrigatório):

      O ID do WorkSpaces a ser recuperado. Deve corresponder ao padrão^ws-[0-9a-z]{8,63}$. Tipo:String.

    • Reinicialização (opcional):

      Defina como Yes para permitir que o WorkSpaces seja reinicializado. Padrão: Yes. Valores permitidos: Yes |No. Tipo:String.

    • Restauração (opcional):

      Defina como Yes para permitir que WorkSpaces o seja restaurado. O sistema é restaurado para o snapshot mais recente do volume raiz. Todos os aplicativos instalados ou as configurações do sistema alteradas após a criação do instantâneo mais recente são perdidos. O volume do usuário é recriado a partir do instantâneo mais recente e seu conteúdo atual é sobrescrito. Padrão: No. Valores permitidos: Yes |No. Tipo:String.

    • Reconstrução (opcional):

      Defina como Yes para permitir que WorkSpaces o seja reconstruído. O sistema é atualizado com a imagem mais recente do pacote a partir do qual o WorkSpaces foi criado. Todos os aplicativos instalados ou as configurações do sistema alteradas após WorkSpaces a criação são perdidos. O volume do usuário é recriado a partir do instantâneo mais recente e seu conteúdo atual é sobrescrito. Padrão: No. Valores permitidos: Yes |No. Tipo:String.

    • Confirmar (obrigatório):

      Insira Yes para confirmar que as ações de restauração e reconstrução recuperam as WorkSpaces do instantâneo mais recente e que os dados restaurados dos instantâneos podem durar até 12 horas. Padrão permitido:^[Yy][Ee][Ss]$. Tipo:String.

    • Aprovadores (obrigatórios):

      Uma lista de nomes de usuário do IAM ou ARNs dos aprovadores da ação de automação. Você pode especificar os principais como nome de usuário do IAM, ARN do usuário IAM, ARN da função do IAM ou ARN do usuário assumindo a função do IAM. Mínimo: 1, Máximo: 10. Tipo:StringList.

    • MinRequiredApprovals (Opcional):

      O número mínimo de aprovações necessárias para retomar a execução da automação. O valor não pode exceder o número de aprovadores definido pelo Approvers parâmetro. Padrão: 1. Valores permitidos: 1 —10. Tipo:Integer.

    • SNSTopicArn (Obrigatório):

      O tópico ARN do Amazon SNS usado para enviar a notificação de aprovação pendente. O nome do tópico do Amazon SNS deve ser prefixado com. Automation Tipo:String.

  4. Clique em Executar.

  5. A automação é iniciada.

  6. O bucket realiza as seguintes etapas:

    • getWorkSpaceInitialState: recupera o estado atual do WorkSpaces.

    • assertWorkSpaceInitialState: confirma que WorkSpaces está em um estado recuperável (Available,, Error StoppedUnhealthy, ou). Impaired A automação termina se o WorkSpaces estiver em qualquer outro estado.

    • branchOnWorkSpaceInitialState: Filiais com base no WorkSpaces estado inicial. SeStopped, prossegue com o início do WorkSpaces. SeUnhealthy,Error, ouImpaired, continuar com a recuperação dos instantâneos.

    • startWorkSpace: Inicia WorkSpaces se estivesse em um Stopped estado.

    • waitForStartWorkSpace: Espera até 10 minutos para que o WorkSpaces Starting status alcance.

    • waitForStartWorkSpaceResult: Aguarda até 30 minutos para WorkSpaces que o Available status alcanceUnhealthy, ErrorImpaired, ou após o início.

    • getWorkSpaceStateAfterStart: recupera o WorkSpaces estado após a tentativa inicial.

    • branchOnWorkSpaceStateAfterStart: Se sim WorkSpaces Available, prossegue para a afirmação final. Caso contrário, prossiga com a recuperação dos instantâneos.

    • getWorkSpaceSnapshots: recupera os instantâneos de reconstrução e restauração disponíveis para o. WorkSpaces

    • approval: envia uma notificação de aprovação para o tópico especificado do Amazon SNS e pausa a automação por até 24 horas, esperando que os aprovadores designados aprovem ou neguem as ações de recuperação.

    • branchOnRebootAllowed: Se Reboot estiver definido comoYes, prossegue com a reinicialização do. WorkSpaces Caso contrário, prossiga para a ramificação de restauração.

    • rebootWorkSpace: Reinicializa o. WorkSpaces

    • waitForRebootWorkSpace: Espera até 10 minutos para que o WorkSpaces Rebooting status alcance.

    • waitForRebootWorkSpaceResult: espera até 30 minutos para que o WorkSpaces Available status alcance UnhealthyError, ou após a reinicialização.

    • getWorkSpaceStateAfterReboot: recupera o WorkSpaces estado após a tentativa de reinicialização.

    • branchOnWorkSpaceStateAfterReboot: Se sim WorkSpaces Available, prossegue para a afirmação final. Caso contrário, prossiga para a ramificação de restauração.

    • branchOnRestoreAllowed: Se Restore estiver definido comoYes, prossegue com a restauração do WorkSpaces. Caso contrário, prossiga para a ramificação de reconstrução.

    • restoreWorkSpace: restaura o WorkSpaces instantâneo mais recente. Se a restauração falhar, a automação prosseguirá para a ramificação de reconstrução.

    • waitForRestoreWorkSpace: Espera até 10 minutos para que o WorkSpaces Restoring status alcance.

    • waitForRestoreWorkSpaceResult: Aguarda até 30 minutos para WorkSpaces que o Available status alcance UnhealthyError, ou após a restauração.

    • getWorkSpaceStateAfterRestore: recupera o WorkSpaces estado após a tentativa de restauração.

    • branchOnWorkSpaceStateAfterRestore: Se sim WorkSpaces Available, prossegue para a afirmação final. Caso contrário, prossiga para a ramificação de reconstrução.

    • branchOnRebuildAllowed: Se Rebuild estiver definido comoYes, prossegue com a reconstrução do. WorkSpaces Caso contrário, prossiga para a afirmação final.

    • rebuildWorkSpace: reconstrói a imagem WorkSpaces do pacote mais recente.

    • waitForRebuildWorkSpace: Espera até 10 minutos para que o WorkSpaces Rebuilding status alcance.

    • waitForRebuildWorkSpaceResult: espera até 30 minutos para que o WorkSpaces Available status alcance UnhealthyError, ou após a reconstrução.

    • getWorkSpaceStateAfterRebuild: recupera o WorkSpaces estado após a tentativa de reconstrução.

    • assertWorkSpaceFinalState: confirma que o WorkSpaces status éAvailable. A automação falhará se o não WorkSpaces estiver em um Available estado.

  7. Após a conclusão, revise a seção Saídas para ver os resultados detalhados da execução.

Referências

Automação do Systems Manager