View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Automation 런북 참조

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWSSupport-RecoverWorkSpaceWithApproval

설명

AWSSupport-RecoverWorkSpaceWithApproval 실행서는 운영 상태가 인 경우 지정한 Amazon WorkSpaces(WorkSpaces) 인스턴스에서 복구 단계를 수행합니다Unhealthy. 입력 파라미터에 지정한 값과 사용 가능한 스냅샷에 따라 실행서는 상태가가 될 때까지 WorkSpaces를 재부팅, 복원 및 재구축합니다Available. 이 실행서는 지정된 보안 주체가 선택한 복구 작업을 승인하거나 거부할 때까지 aws:approve 자동화를 일시적으로 일시 중지하는 자동화 작업을 사용합니다.

중요

WorkSpace를 복원하거나 재빌드하는 작업은 데이터 손실을 초래할 수 있는 잠재적으로 파괴적인 작업입니다. 이는 WorkSpace가 사용 가능한 마지막 스냅샷에서 복원되고 스냅샷에서 복구되는 데이터가 12시간 가량 경과된 내용일 수 있기 때문입니다.

복원 옵션은 최신 스냅샷을 기반으로 루트 볼륨과 사용자 볼륨을 모두 재생성합니다. 재빌드 옵션은 가장 최근 스냅샷에서 사용자 볼륨을 재생성하고 WorkSpace가 생성된 번들과 연결된 이미지에서 WorkSpace를 다시 생성합니다. WorkSpace가 생성된 이후에 변경된 시스템 설정 또는 설치된 애플리케이션이 손실됩니다. 작업 영역 복원 및 재빌드에 대한 자세한 내용은 Amazon WorkSpaces 관리 안내서의 WorkSpace 복원 및 WorkSpace 재빌드를 참조하세요.

이 실행서를 사용하기 전에 Amazon WorkSpaces 관리 안내서의 Amazon WorkSpaces 문제 해결 주제를 검토하는 것이 좋습니다. Amazon WorkSpaces

작동 방식

실행서는 다음 복구 작업을 순서대로 수행하여 WorkSpaces가 Available 상태에 도달하는 즉시 중지합니다.

  • WorkSpaces의 초기 상태를 검색하고 복구 가능 상태(Unhealthy, Error, ImpairedStopped, 또는 Available)인지 확인합니다.

  • WorkSpaces가 인 경우는 WorkSpaces를 Stopped시작하고 결과를 기다립니다.

  • WorkSpaces에 사용 가능한 재구축 및 복원 스냅샷을 검색합니다.

  • Amazon Simple Notification Service(Amazon SNS)를 통해 지정된 승인자에게 승인 알림을 보내고 승인 또는 거부될 때까지 일시 중지합니다.

  • 승인되고 로 설정된 경우 Reboot는 WorkSpaces를 Yes재부팅하고 결과를 기다립니다.

  • WorkSpaces가 여전히가 아니Available고 로 설정된 경우 YesRestore는 가장 최근 스냅샷에서 WorkSpaces를 복원하고 결과를 기다립니다.

  • WorkSpaces가 여전히가 아니Available고 로 설정된 경우 YesRebuild는 최신 번들 이미지에서 WorkSpaces를 다시 빌드하고 결과를 기다립니다.

  • WorkSpaces의 최종 상태가 인지 확인합니다Available.

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

/

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

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*"
        }
    ]
}
지침

다음 단계에 따라 자동화를 구성합니다.

  1. Systems Manager의 Documents에서 AWSSupport-RecoverWorkSpaceWithApproval을 엽니다.

  2. 자동화 실행(Execute automation)을 선택합니다.

  3. 입력 파라미터에 다음을 입력합니다.

    • AutomationAssumeRole(선택 사항):

      Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 AWS IAM 역할 ARN입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다. 유형: AWS::IAM::Role::Arn.

    • WorkspaceId(필수):

      복구할 WorkSpaces의 ID입니다. 패턴과 일치해야 합니다^ws-[0-9a-z]{8,63}$. 유형: String.

    • 재부팅(선택 사항):

      WorkSpaces를 재부팅Yes하려면 로 설정합니다. 기본값: Yes. 허용되는 값: Yes | No. 유형: String.

    • 복원(선택 사항):

      WorkSpaces를 복원Yes하려면 로 설정합니다. 시스템이 루트 볼륨의 가장 최근 스냅샷으로 복원됩니다. 가장 최근 스냅샷이 생성된 후 설치되거나 시스템 설정이 변경된 애플리케이션은 모두 손실됩니다. 사용자 볼륨은 최신 스냅샷에서 다시 생성되고 현재 내용을 덮어씁니다. 기본값: No. 허용되는 값: Yes | No. 유형: String.

    • 재구축(선택 사항):

      WorkSpaces를 재구축Yes하려면 로 설정합니다. 시스템은 WorkSpaces가 생성된 번들의 최신 이미지로 새로 고쳐집니다. WorkSpaces가 생성된 후 설치되거나 시스템 설정이 변경된 애플리케이션은 모두 손실됩니다. 사용자 볼륨은 최신 스냅샷에서 다시 생성되고 현재 내용을 덮어씁니다. 기본값: No. 허용되는 값: Yes | No. 유형: String.

    • 승인(필수):

      Yes를 입력하여 복원 및 재구축 작업이 가장 최근 스냅샷에서 WorkSpaces를 복구하고 스냅샷에서 복원된 데이터가 12시간 이전일 수 있음을 확인합니다. 허용되는 패턴: ^[Yy][Ee][Ss]$. 유형: String.

    • 승인자(필수):

      자동화 작업에 대한 승인자의 IAM 사용자 이름 또는 ARNs 목록입니다. 보안 주체를 IAM 사용자 이름, IAM 사용자 ARN, IAM 역할 ARN 또는 IAM 수임 역할 사용자 ARN으로 지정할 수 있습니다. 최소: 1, 최대: 10. 유형: StringList.

    • MinRequiredApprovals(선택 사항):

      자동화 실행을 재개하는 데 필요한 최소 승인 수입니다. 값은 Approvers 파라미터에 정의된 승인자 수를 초과할 수 없습니다. 기본값: 1. 허용되는 값: 1–10. 유형: Integer.

    • SNSTopicArn(필수):

      대기 중인 승인 알림을 보내는 데 사용되는 Amazon SNS 주제 ARN입니다. Amazon SNS 주제 이름에는 접두사가 붙어야 합니다Automation. 유형: String.

  4. 실행을 선택합니다.

  5. 자동화가 시작됩니다.

  6. 문서는 다음 단계를 수행합니다.

    • getWorkSpaceInitialState: WorkSpaces의 현재 상태를 검색합니다.

    • assertWorkSpaceInitialState: WorkSpaces가 복구 가능 상태(Available, Error, StoppedUnhealthy, 또는 Impaired)인지 확인합니다. WorkSpaces가 다른 상태에 있으면 자동화가 종료됩니다.

    • branchOnWorkSpaceInitialState: 초기 WorkSpaces 상태를 기반으로 분기합니다. Stopped인 경우 WorkSpaces를 시작합니다. Unhealthy, Error또는 Impaired인 경우는 스냅샷 검색을 진행합니다.

    • startWorkSpace: WorkSpaces가 Stopped 상태인 경우 시작합니다.

    • waitForStartWorkSpace: WorkSpaces가 Starting 상태에 도달할 때까지 최대 10분 동안 기다립니다.

    • waitForStartWorkSpaceResult: WorkSpaces가 시작 후 Unhealthy, Impaired, 또는 Available 상태에 도달할 때까지 최대 Error30분 동안 기다립니다.

    • getWorkSpaceStateAfterStart: 시작 시도 후 WorkSpaces 상태를 검색합니다.

    • branchOnWorkSpaceStateAfterStart: WorkSpaces가 인 경우는 최종 어설션으로 Available진행합니다. 그렇지 않으면가 스냅샷 검색을 진행합니다.

    • getWorkSpaceSnapshots: WorkSpaces에 사용 가능한 재구축 및 복원 스냅샷을 검색합니다.

    • approval: 지정된 Amazon SNS 주제에 승인 알림을 보내고 지정된 승인자가 복구 작업을 승인하거나 거부할 때까지 기다리면서 최대 24시간 동안 자동화를 일시 중지합니다.

    • branchOnRebootAllowed:이 로 Reboot 설정된 경우 Yes는 WorkSpaces를 재부팅합니다. 그렇지 않으면가 복원 브랜치로 이동합니다.

    • rebootWorkSpace: WorkSpaces를 재부팅합니다.

    • waitForRebootWorkSpace: WorkSpaces가 Rebooting 상태에 도달할 때까지 최대 10분 동안 기다립니다.

    • waitForRebootWorkSpaceResult: 재부팅 후 WorkSpaces가 Unhealthy, Error또는 Available 상태에 도달할 때까지 최대 30분 동안 기다립니다.

    • getWorkSpaceStateAfterReboot: 재부팅 시도 후 WorkSpaces 상태를 검색합니다.

    • branchOnWorkSpaceStateAfterReboot: WorkSpaces가 인 경우는 최종 어설션으로 Available진행합니다. 그렇지 않으면가 복원 브랜치로 이동합니다.

    • branchOnRestoreAllowed: Restore가 로 설정된 경우는 WorkSpaces 복원을 Yes진행합니다. 그렇지 않으면가 브랜치 재구축으로 진행합니다.

    • restoreWorkSpace: 가장 최근 스냅샷에서 WorkSpaces를 복원합니다. 복원에 실패하면 자동화가 재구축 브랜치로 진행됩니다.

    • waitForRestoreWorkSpace: WorkSpaces가 Restoring 상태에 도달할 때까지 최대 10분 동안 기다립니다.

    • waitForRestoreWorkSpaceResult: 복원 후 WorkSpaces가 Unhealthy, Error또는 Available 상태에 도달할 때까지 최대 30분 동안 기다립니다.

    • getWorkSpaceStateAfterRestore: 복원 시도 후 WorkSpaces 상태를 검색합니다.

    • branchOnWorkSpaceStateAfterRestore: WorkSpaces가 인 경우는 최종 어설션으로 Available진행합니다. 그렇지 않으면가 브랜치 재구축으로 진행합니다.

    • branchOnRebuildAllowed: Rebuild가 로 설정된 경우 Yes는 WorkSpaces를 다시 빌드합니다. 그렇지 않으면가 최종 어설션으로 진행합니다.

    • rebuildWorkSpace: 최신 번들 이미지에서 WorkSpaces를 다시 빌드합니다.

    • waitForRebuildWorkSpace: WorkSpaces가 Rebuilding 상태에 도달할 때까지 최대 10분 동안 기다립니다.

    • waitForRebuildWorkSpaceResult: 재구축 후 WorkSpaces가 Unhealthy, Error또는 Available 상태에 도달할 때까지 최대 30분까지 기다립니다.

    • getWorkSpaceStateAfterRebuild: 재구축 시도 후 WorkSpaces 상태를 검색합니다.

    • assertWorkSpaceFinalState: WorkSpaces 상태가 인지 확인합니다Available. WorkSpaces가 Available 상태가 아니면 자동화가 실패합니다.

  7. 완료 후 출력 섹션에서 실행의 자세한 결과를 검토합니다.

참조

Systems Manager Automation