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

# `AWSPremiumSupport-ExtendVolumesOnWindows`
<a name="automation-awspremiumsupport-extendvolumesonwindows"></a>

 **설명** 

`AWSPremiumSupport-ExtendVolumesOnWindows` 실행서는 대상 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에서 Amazon Elastic Block Store(Amazon EBS) 볼륨, 해당 파티션 및 파일 시스템을 확장합니다.

**중요 고려 사항**  
**작업 영향 및 볼륨 상태**: Amazon EBS 볼륨 수정은 `modifying`, `optimizing`및의 세 단계로 이루어집니다`completed`. 이 자동화는 볼륨이 `optimizing` 상태에 도달하면 파일 시스템 확장을 진행합니다. `optimizing` 상태 중에는 파티션 크기 조정 중에 일시적인 성능 영향과 잠재적인 파일 시스템 수준 중단이 발생할 수 있습니다. [Amazon EBS 볼륨 수정 진행 상황을 모니터링할](https://docs.aws.amazon.com//ebs/latest/userguide/monitoring-volume-modifications.html) 수 있습니다.
**비용 및 제한 사항**: Amazon EBS 볼륨 크기를 늘리면 월별 스토리지 비용이 증가합니다. 자세한 내용은 [Amazon EBS 요금을](https://aws.amazon.com/ebs/pricing) 참조하세요. 이 실행서에서 생성된 백업 AMI 및 관련 스냅샷은 크기와 보관 기간에 따라 추가 요금이 발생합니다. 일부 볼륨 유형의 경우 확장 후 GB당 동일한 IOPS 비율을 유지해야 하는 경우 프로비저닝된 IOPS를 수정해야 할 수 있습니다.
**백업 및 복구**: 런북은 볼륨을 변경하기 전에 백업 AMI를 생성합니다. AMI 및 연결된 스냅샷은 계정에서 자동으로 제거되지 않습니다. 더 이상 필요하지 않은 경우 이러한 백업을 수동으로 제거해야 합니다. 장애가 발생할 경우 스냅샷을 [사용하여 Amazon EBS 볼륨 교체에 설명된 대로 연결된 AMI의 스냅샷에서 볼륨을](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-restoring-volume.html) 복구할 수 있습니다.

 **어떻게 작동하나요?**

이 실행서는 다음 작업을 수행합니다.
+ 대상 인스턴스가 Systems Manager에서 관리되고 Windows Server를 실행 중인지 확인합니다.
+ 현재 Amazon EC2 인스턴스를 대상으로 하는이 실행서의 실행이 하나만 있는지 확인합니다.
+ 대상 인스턴스에서 백업 Amazon Machine Image(AMI)를 생성합니다.
+ 확장을 위해 지정된 Amazon EBS 볼륨을 확장합니다.
+ PowerShell 명령을 사용하여 대상 인스턴스의 파일 시스템 확장

**중요**  
`AWSPremiumSupport-*` 실행서에 액세스하려면 Business \+ Support, Enterprise Support 또는 통합 운영 구독이 필요합니다. 자세한 내용은 [AWS Support 플랜 비교](https://aws.amazon.com/premiumsupport/plans/)를 참조하세요.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnWindows) 

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeVolumes`
+ `ec2:ModifyVolume`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`

IAM 정책 예제:

```
 {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }
```

 **지침** 

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

1. Systems Manager[https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)의 문서로 이동합니다.

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

1. 입력 파라미터에 다음을 입력합니다.
   + **AutomationAssumeRole(선택 사항):**
     + 설명: (선택 사항) Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
     + 유형: `AWS::IAM::Role::Arn`
   + **InstanceId(필수):**
     + 설명: (필수) Amazon EC2 인스턴스의 ID입니다.
     + 유형: `String`
     + 패턴 허용: `^i-[0-9a-f]{8,17}$`
   + **VolumeExpansionCapSize(필수):**
     + 설명: (필수) Amazon EBS 볼륨이 증가할 최대 크기(GiB)입니다.
     + 유형: `String`
     + 패턴 허용: `^[0-9]{1,4}$`
   + **DiagnosticResults(필수):**
     + 설명: (필수) `DiagnoseDiskUsage` 문서의 사전 확인 스크립트 결과로, 한 줄 CSV 형식입니다. 문자열은 로 시작하고 각 볼륨에 대해 쉼표로 구분된 볼륨 정보가 `EXTEND;` 이어지며 볼륨은 세미콜론으로 구분됩니다. 각 볼륨의 정보에는 볼륨 ID, 드라이브 문자, 확장 플래그(확장하려면 1, 건너뛰려면 0), GB의 새 크기, AWS 리전 및 이유/작업이 포함됩니다.
     + 유형: `String`
     + 패턴 허용: `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. **실행**을 선택합니다.

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

1. 문서는 다음 단계를 수행합니다.
   + **AssertInstanceIsManagedInstance**:

     대상 인스턴스가 Systems Manager에서 관리되는지 확인합니다.
   + **DescribeInstance**:

     대상 Amazon EC2 인스턴스의 플랫폼 정보를 검색합니다.
   + **BranchOnPlatform**:

     대상 Amazon EC2 인스턴스 플랫폼이 Windows Server인지 확인합니다.
   + **CheckConcurrency**:

     현재 Amazon EC2 인스턴스를 대상으로 하는이 실행서의 실행이 하나만 있는지 확인합니다.
   + **CreateImage**:

     대상 인스턴스에서 백업 Amazon Machine Image(AMI)를 생성합니다.
   + **WaitUntilImageReady**:

     Amazon Machine Image(AMI)가 생성을 완료하고 `available` 상태에 도달할 때까지 기다립니다.
   + **ExtendEBSVolume**:

     확장을 위해 지정된 대상 인스턴스의 Amazon EBS 볼륨을 확장합니다.
   + **DescribeVolumes**:

     확장을 위해 지정된 대상 인스턴스의 Amazon EBS 볼륨을 설명합니다.
   + **ExtendFilesystem**:

     PowerShell 명령을 사용하여 대상 인스턴스의 파일 시스템을 확장합니다.

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

**참조**

Systems Manager Automation
+ [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)
+ [자동화 실행](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Automation 설정](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [자동화 워크플로 지원](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Amazon EBS 볼륨 수정 요청](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)