기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Image Builder를 사용하여 가상 머신 이미지 가져오기 및 내보내기 가상화 환경에서 VM을 내보내면 해당 프로세스가 VM 환경, 설정 및 데이터의 스냅샷 역할을 하는 하나 이상의 디스크 컨테이너 파일 세트를 생성합니다. 이러한 파일을 사용하여 VM을 가져와서 이미지 레시피의 기본 이미지로 사용할 수 있습니다. 내보내기를 위해 사용자 지정 이미지 빌드의 출력으로 VM 디스크 파일을 생성하고 파일을 배포할 수 있습니다. Image Builder는 VM 디스크 컨테이너에 대해 다음과 같은 파일 형식을 지원합니다. + 개방형 가상화 아카이브(OVA) + 가상 머신 디스크(VMDK) + 가상 하드 디스크(VHD/VHDX) + 원시 가져오기는 디스크를 사용하여 Amazon Machine Image(AMI)와 Image Builder 이미지 리소스를 생성합니다. 이 리소스 중 하나는 사용자 지정 이미지 레시피의 기본 이미지로 사용될 수 있습니다. 가져오려면 VM 디스크를 S3 버킷에 저장해야 합니다. 또는 기존 EBS 스냅샷에서 가져올 수 있습니다. Image Builder 콘솔에서 이미지를 직접 가져온 다음 레시피에 출력 이미지 또는 AMI를 사용하거나 레시피 또는 레시피 버전을 생성할 때 가져오기 파라미터를 지정할 수 있습니다. 이미지 레시피의 일부로 가져오는 방법에 대한 자세한 내용은 [VM 가져오기 구성](create-image-recipes.md#import-vm-recipe-console-config)(을)를 참조합니다. ## Image Builder로 VM 가져오기 Image Builder는 Amazon EC2 VM 가져오기/내보내기 API와 통합되어 가져오기 프로세스를 백그라운드에서 비동기적으로 실행할 수 있도록 합니다. Image Builder는 VM 가져오기의 작업 ID를 참조하여 진행 상황을 추적하고 Image Builder 이미지 리소스를 출력으로 생성합니다. 이렇게 하면 VM 가져오기가 완료되기 전에 레시피의 Image Builder 이미지 리소스를 참조할 수 있습니다. ------ #### [ Console ] Image Builder 콘솔을 사용하여 VM을 가져오려면 다음 단계를 따르세요. 1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다. 1. 탐색 창에서 **이미지**를 선택합니다. 1. 가져오기 대화 상자를 열려면 **이미지 가져오기**를 선택합니다. 1. 다음 **일반** 정보를 입력합니다. + 이미지의 고유한 **이름을** 지정합니다. + 기본 이미지의 **버전**을 지정합니다. `major.minor.patch` 형식을 사용합니다. 1. 가져오기 유형: **VM 가져오기**를 선택합니다. 1. **이미지 가져오기** 페이지의 다음 섹션에 대한 세부 정보를 제공하세요. 작업을 마치면 **이미지 가져오기**를 선택합니다. **기본 이미지 운영 체제** 1. VM OS 플랫폼에 맞는 **이미지 운영 체제(OS)** 옵션을 선택합니다. 1. 목록에서 VM 버전과 일치하는 **OS 버전**을 선택합니다. **VM 가져오기 구성** 1. 가상화 환경에서 VM을 내보내는 경우 이 프로세스는 하나 이상의 디스크 컨테이너 파일 세트를 만듭니다. 이는 VM 환경, 설정 및 데이터의 스냅샷 역할을 합니다. 이러한 파일을 사용하여 VM을 이미지 레시피의 기본 이미지로 가져올 수 있습니다. 이미지 빌더에서 VM을 가져오는 작업에 대한 자세한 내용은 [VM 이미지 가져오기 및 내보내기](#vm-import-export) 섹션을 참조하세요. 가져오기 소스의 위치를 지정하려면 다음 단계를 따르세요.   **소스 가져오기** **디스크 컨테이너 1** 섹션에서 가져올 첫 번째 VM 이미지 디스크 컨테이너 또는 스냅샷의 소스를 지정합니다. 1. **소스** - S3 버킷 또는 EBS 스냅샷일 수 있습니다. 1. **디스크의 S3 위치 선택** - 디스크 이미지가 저장되어 있는 Amazon S3의 위치를 입력합니다. 위치를 찾아보려면 **S3 찾아보기**를 선택합니다. 1. 디스크 컨테이너를 추가하려면 **디스크 컨테이너 추가**를 선택합니다.   1. **IAM 역할** IAM 역할을 VM 가져오기 구성에 연결하려면 **IAM 역할** 드롭다운 목록에서 역할을 선택하거나 **새로운 역할 생성**을 선택하여 새 역할을 생성합니다. 새 역할을 생성하면 IAM 역할 콘솔 페이지가 별도의 탭에 열립니다.   1. **고급 설정 - *선택 사항*** 다음 설정은 선택 사항입니다. 이러한 설정을 사용하여 가져오기로 생성되는 기본 이미지에 대한 암호화, 라이선스, 태그 등을 구성할 수 있습니다. **기본 이미지 아키텍처** VM 가져오기 소스의 아키텍처를 지정하려면 **아키텍처** 목록에서 값을 선택합니다. **암호화** VM 디스크 이미지가 암호화된 경우 가져오기 프로세스에 사용할 키를 제공해야 합니다. 가져오기에 사용할 KMS 키를 지정하려면 **암호화(KMS 키)** 목록에서 값을 선택합니다. 목록에는 현재 리전에서 사용자 계정이 액세스할 수 있는 KMS 키가 포함되어 있습니다. **라이선스 관리** VM을 가져오면 가져오기 프로세스에서 VM OS를 자동으로 탐지하고 적절한 라이선스를 기본 이미지에 적용합니다. OS 플랫폼에 따라 라이선스 유형은 다음과 같습니다. + **라이선스 포함** - 플랫폼에 적합한 AWS 라이선스가 기본 이미지에 적용됩니다. + **기존 보유 라이선스 사용(BYOL)** - 해당하는 경우 VM의 라이선스를 유지합니다. 로 생성된 라이선스 구성을 기본 이미지 AWS License Manager 에 연결하려면 **라이선스 구성 이름** 목록에서를 선택합니다. License Manager에 대한 자세한 내용은 [작업 단원을 참조하십시오. AWS License Manager]() **참고** 라이선스 구성은 기업 계약 조건에 기반한 라이선스 규칙을 포함합니다. Linux는 BYOL 라이선스만 지원합니다. **태그(기본 이미지)** 태그는 키-값 페어를 사용하여 검색 가능한 텍스트를 Image Builder 리소스에 할당합니다. 가져온 기본 이미지에 태그를 지정하려면 **키** 및 **값** 상자를 사용하여 키-값 페어를 입력합니다. 태그를 추가하려면 **태그 추가**를 선택합니다. 태그를 제거하려면 **태그 제거**를 선택합니다. ------ #### [ AWS CLI ] 디스크에서 AMI로 VM을 가져와서 바로 참조할 수 있는 Image Builder 이미지 리소스를 생성하려면 AWS CLI의 다음 단계를 따릅니다. 1. AWS CLI에서 Amazon EC2 VM 가져오기/내보내기 **import-image** 명령을 사용하여 VM 가져오기를 시작합니다. 명령 응답에 반환되는 작업 ID를 적어둡니다. 이 정보는 다음 단계에 필요합니다. 자세한 내용은 *VM 가져오기/내보내기 사용 설명서*에서 [VM 가져오기/내보내기를 사용하여 VM을 이미지로 가져오기](https://docs.aws.amazon.com/vm-import/latest/userguide/vmimport-image-import.html)를 참조합니다.   1. **CLI 입력 JSON 파일 생성** 에서 사용되는 Image Builder **import-vm-image** 명령을 간소화하기 위해 명령에 전달하려는 모든 가져오기 구성이 포함된 JSON 파일을 AWS CLI생성합니다. **참고** JSON 파일의 데이터 값에 대한 이름 지정 규칙은 Image Builder API 작업 요청 파라미터에 지정된 패턴을 따릅니다. API 작업 요청 파라미터를 검토하려면 *EC2 Image Builder API* 참조의 [ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html) 작업을 참조하세요. 데이터 값을 명령줄 파라미터로 제공하려면 옵션으로서 Image Builder **import-vm-image** 명령으로 *AWS CLI 명령 참조*에 지정된 파라미터 이름을 참조합니다. 다음은 이 예제에서 지정하는 파라미터의 요약입니다. + **name**(문자열, 필수) - 가져오기에서 출력으로 생성할 이미지 빌더 이미지 리소스의 이름입니다. + **semanticVersion**‬(문자열, 필수) – 특정 버전을 나타내기 위해 각 위치에 숫자 값이 있는 ... 형식으로 버전을 지정하는 출력 이미지의 시맨틱 버전. 예를 들어 `1.0.0`입니다. Image Builder 리소스의 시맨틱 버전 관리에 대한 자세한 내용은 [Image Builder의 의미 체계 버전 관리](ibhow-semantic-versioning.md)(을)를 참조하십시오. + **설명**(문자열) – 이미지 레시피에 대한 설명입니다. + **platform**(문자열, 필수) - 가져온 VM의 운영 체제 플랫폼. + **vmImportTaskId**(문자열, 필수) - Amazon EC2 VM 가져오기 프로세스의 `ImportTaskId`(AWS CLI). Image Builder는 가져오기 프로세스를 모니터링하여 생성한 AMI를 가져와 레시피에 즉시 사용할 수 있는 이미지 빌더 이미지 리소스를 빌드합니다. + **태그**(문자열 맵) - 태그는 가져오기 리소스에 연결되는 키-값 페어입니다. 키-값 페어는 최대 50개까지 허용됩니다. Image Builder **import-vm-image** 명령에서 사용할 파일을 `import-vm-image.json`(으)로 저장합니다. ``` { "name": "example-request", "semanticVersion": "1.0.0", "description": "vm-import-test", "platform": "Linux", "vmImportTaskId": "import-ami-01ab234567890cd1e", "tags": { "Usage": "VMIE" } } ``` 1. **이미지 가져오기** 생성한 파일을 입력으로 사용하여 **[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)** 명령을 실행합니다. ``` aws imagebuilder import-vm-image --cli-input-json file://import-vm-image.json ``` **참고** JSON 파일 경로의 시작 부분에 `file://` 표기법을 포함시켜야 합니다. JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\$1)를 사용하고 Linux 및 macOS에서는 슬래시(/)를 사용합니다. ------ ## 의 이미지 빌드에서 VM 디스크 배포 AWS CLI AWS CLI에서 Image Builder 배포 구성을 사용하여 정규 이미지 빌드 프로세스의 일부로 대상 리전의 S3 버킷에 지원되는 VM 디스크 형식 파일을 배포하도록 설정할 수 있습니다. 자세한 내용은 [예:에서 출력 VM 디스크에 대한 배포 설정 생성 AWS CLI](cr-upd-ami-distribution-settings.md#cli-create-vm-dist-config) 단원을 참조하십시오.