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

# 이미지 가져오기
<a name="import-image"></a>

사용자 지정된 EC2 AMIs를 가져와 WorkSpaces 애플리케이션 이미지를 생성할 수 있습니다. 작동 방식은 다음과 같습니다.

1. EC2 [Image Builder를 포함하여 원하는 방법을 사용하여 EC2 ](https://docs.aws.amazon.com/imagebuilder/)AMI를 사용자 지정합니다.

1. 사용자 지정 AMI를 WorkSpaces 애플리케이션으로 가져와 WorkSpaces 애플리케이션 이미지를 생성합니다.

1. 선택적으로 추가 이미지 사용자 지정을 위해 Image Builder 사용

AMI 가져오기를 통해 생성된 이미지는 이고 `type = "custom"` WorkSpaces 애플리케이션에서 제공하는 이미지는 입니다`type = "native"`.

에서 이미지에 stream.\* 인스턴스 유형을 사용할 수 있습니다`type = "native"`. 다음 인스턴스 유형 중 하나를 사용하려면 AMI를 가져오고를 사용하여 이미지를 생성해야 합니다`type = "custom"`.
+ GeneralPurpose.\*
+ MemoryOptimized.\*
+ ComputeOptimized.\*
+ 가속화됨.\*

## 이미지 가져오기를 위한 사전 조건
<a name="import-image-prerequisites"></a>

이러한 모든 사전 조건은 성공적인 워크플로 실행에 중요합니다. 지원되는 AMI 구성 및 기타 필수 요구 사항은 다음과 같습니다.

### 필수 AMI 속성
<a name="required-ami-properties"></a>

EBS  
+ 500GB 이하 크기
  + < 200GB인 AMI를 가져올 수 있지만 가져온 이미지는 최소 200GB를 사용합니다.
+ GP2
  + gp2 또는 gp3 EBS 볼륨 유형의 AMI를 가져올 수 있지만 가져온 이미지는 gp2를 사용합니다.
+ 이미지당 볼륨 1개
+ `/dev/sda1` 루트 디바이스 이름
+ 이미지 유형: 머신
+ 아키텍처: x86\_64
+ 가상화 유형: HVM
+ 부팅 모드: UEFI
+ TPM 지원: v2.0. 이는 필수입니다. TPM 지원 AMI를 찾으려면 [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\#ami-windows-tpm-find](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) 참조하십시오.
+ ENA 지원: true
+ 플랫폼: Windows
+ 플랫폼 세부 정보: Windows

### 운영 체제 속성
<a name="operating-system-properties"></a>

Windows Server 2022/2025 **풀 베이스**  
+ Windows Server **Core**는 지원되지 않습니다.
+ SQL Server를 사용하는 Windows는 지원되지 않습니다.

에이전트  
+ EC2 시작 V2 버전 >= 2.1.1
+ SSM 에이전트 필요

드라이버  
+ EC2 ENA 드라이버 버전 >= 2.9.0
+ EC2 NVMe 드라이버 버전 >= 1.6.0

라이브러리 지원  
+ .NET Framework 4.8 이상
  + Windows Server 2022/2025에 기본적으로 설치됨
+ PowerShell 5.1 이상
  + Windows Server 2022/2025에 기본적으로 설치됨
+ Windows 기능: 원격 데스크톱 서비스 라이선싱 및 원격 데스크톱 서비스 세션 호스트를 설치해서는 안 됩니다.
+ 포트: 포트 8000, 8300 및 8443은 차단 해제되고 점유 해제되어야 합니다.
+ 부팅 모드: UEFI

Accelerated.g4dn, Accelerated.g5, Accelerated.G6 또는 Accelerated.G6e와 같은 그래픽 인스턴스에서 이미지를 사용하려면 AMI에 적절한 GRID 드라이버를 설치해야 합니다. 자세한 내용은 [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html) 참조하십시오. 드라이버가 올바르게 설정되지 않으면 스트리밍이 작동하지만 그래픽 카드를 사용하지 못할 수 있습니다.

**중요**  
AMI의 "소유자 계정 ID"는 AWS계정 ID여야 합니다. 퍼블릭 EC2 AMI는 가져올 수 없습니다.  
이미지를 가져오기 전에 Windows 업데이트를 수행하고 자동 Windows 업데이트를 비활성화합니다.  
암호화된 EC2 AMIs는 현재 지원되지 않습니다.

### IAM 역할 요구 사항
<a name="iam-role-requirements"></a>

**중요**  
“이미지 가져오기에 사용할 수 있는 다음 권한을 가진 IAM 역할을 생성합니다.

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

이 IAM 역할에 대해 다음 신뢰 관계를 추가합니다.

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## 이미지를 가져오려면
<a name="import-image-procedure"></a>

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) WorkSpaces 애플리케이션 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **이미지를** 선택한 다음 **이미지 레지스트리**를 선택합니다.

1. **이미지 가져오기**를 선택합니다.

1. **AMI ID** - WorkSpaces 애플리케이션으로 가져오려는 AMI의 AMI ID를 입력합니다. 이 필드를 사용하여 AMI를 검색할 수도 있습니다.

1. **이미지 이름** - 가져오기 작업으로 인해 생성될 이미지의 고유한 이름을 입력합니다.

1. **표시 이름***(선택 사항)* - 이미지에 표시할를 입력합니다.

1. **설명***(선택 사항)* - 이미지에 대한 설명을 입력합니다.

1. **IAM 역할** - 이미지 가져오기를 위해 생성한 IAM 역할을 선택합니다. 자세한 내용은 단원을 참조하십시오[IAM 역할 요구 사항](#iam-role-requirements).

1. **WorkSpaces 애플리케이션 에이전트 관리** - 항상 최신 WorkSpaces 애플리케이션 에이전트 버전을 사용하려면이 옵션을 선택하면 새 에이전트 버전이 릴리스될 AWS때에서 사용할 수 있는 최신 기능, 성능 개선 및 보안 업데이트로 스트리밍 인스턴스가 자동으로 업데이트됩니다.

1. **런타임 검증***(선택 사항)*:이 옵션을 선택하면 서비스가 가져오는 이미지로 인스턴스를 프로비저닝하고 스트리밍 테스트를 실행합니다.
   + 
**참고**  
이러한 스트리밍 테스트는 백그라운드에서 실행되며 WorkSpaces 애플리케이션 클라이언트를 통해이 인스턴스에 연결할 수 없습니다.
   + 이미지가 WorkSpaces 애플리케이션에 적합하다는 신뢰도를 높이려면이 옵션을 사용하는 것이 좋습니다.
   + 해당 인스턴스의 시간당 요금이 청구됩니다.
   + 스트리밍 테스트에 영향을 미치지 않을 수 있는 사소한 변경 후 AMI를 다시 가져오고 런타임 검증이 마지막으로 통과한 경우 런타임 검증을 실행하지 않아도 됩니다.
   + **인스턴스 유형 선택***(선택 사항)*: 스트리밍 테스트를 실행하는 데 적합한 인스턴스 패밀리, 유형 및 크기를 선택합니다. 플릿 생성에 사용할 인스턴스와 동일한 인스턴스를 사용하는 것이 좋습니다.

1. **애플리케이션 카탈로그 및 시작 성능 매니페스트***(선택 사항)*: 최종 사용자를 위한 애플리케이션 카탈로그를 생성하고 애플리케이션의 시작 성능을 개선하기 위한 세부 정보를 제공합니다.
   + **애플리케이션 카탈로그**: 애플리케이션 카탈로그를 생성하려면 이미지를 설치한 애플리케이션에 대한 세부 정보를 지정합니다. 스트리밍하려는 각 애플리케이션에 대해 이름, 표시 이름, 시작할 실행 파일, 표시할 아이콘을 지정할 수 있습니다.
   + **시작 성능**: 애플리케이션 최적화 매니페스트에 파일을 추가하면 새 플릿 인스턴스에서 애플리케이션을 처음 시작하는 데 걸리는 시간이 줄어듭니다. 최적화 매니페스트는 애플리케이션마다 있는 줄로 구분된 텍스트 파일입니다.

   자세한 내용은 단원을 참조하십시오[애플리케이션 세부 정보](applications-details.md).

1. **태그***(선택 사항)* - **태그 추가**를 선택하고 태그의 키와 값을 입력합니다. 태그를 더 추가하려면 이 단계를 반복합니다. 자세한 내용은 [Amazon WorkSpaces 애플리케이션 리소스에 태그 지정](tagging-basic.md) 단원을 참조하십시오.

1. **이미지 가져오기** - 입력한 모든 정보를 검토하고 **이미지 가져오기**를 선택합니다. 서비스는 호환성 검사를 실행하여 AMI가 WorkSpaces 애플리케이션과 호환되는지 확인합니다.
   + 정적 검사에 실패하면 즉시 오류가 발생합니다.
   + 정적 검사가 통과하면 가져오기 요청이 제출되고 선택한 옵션에 따라를 사용하여 새 WorkSpaces 애플리케이션 이미지를 생성하는 데 30\~60분이 걸릴 수 있습니다. `type = "custom"`