16.4. 이미지 업로더 도구

16.4.1. 이미지 업로더 도구

engine-image-uploader 명령을 사용하여 내보내기할 스토리지 도메인을 나열하고 가상 머신 이미지를 OVF 형식으로 내보내기 스토리지 도메인에 업로드하여 Red Hat Enterprise Virtualization Manager에서 자동으로 인식할 수 있습니다.

참고

이미지 업로더는 Red Hat Enterprise Virtualization에 의해 생성된 gzip으로 압축된 OVF 파일만 지원합니다.
아카이브에는 다음과 같은 형식의 이미지와 마스터 디렉토리가 들어 있습니다: 
|-- images
|   |-- [Image Group UUID]
|        |--- [Image UUID (this is the disk image)]
|        |--- [Image UUID (this is the disk image)].meta
|-- master
|   |---vms
|       |--- [UUID]
|             |--- [UUID].ovf

16.4.2. engine-image-uploader 명령 구문

이미지 업로더 명령의 기본 구문은 다음과 같습니다: 
engine-image-uploader [options] list
engine-image-uploader [options] upload [file].[file]...[file]
이미지 업로더 명령은 list 및 upload 두 동작을 지원합니다.
  • list 동작은 이미지를 업로드할 수 있는 내보내기 스토리지 도메인을 나열합니다.
  • upload 동작은 지정된 내보내기 스토리지 도메인에 이미지를 업로드합니다.
이미지 업로더 명령을 사용하는 경우 위의 동작 중 하나를 지정해야 합니다. 또한 upload 동작을 사용하려면 최소 하나의 로컬 파일을 지정해야 합니다.
engine-image-uploader 명령을 자세히 지정하기 위한 여러 매개 변수가 있습니다. 이러한 매개 변수의 기본값은 /etc/ovirt-engine/imageuploader.conf 파일에서 설정할 수 있습니다.

일반 옵션

-h, --help
이미지 업로더 명령을 사용하는 방법에 대한 정보를 표시합니다.
--conf-file=[PATH]
명령을 사용할 설정 파일로 [PATH]를 설정합니다. 기본값은 etc/ovirt-engine/imageuploader.conf입니다.
--log-file=[PATH]
로그 출력 결과를 작성하기 위해 명령이 사용할 특정 파일 이름으로 [PATH]를 설정합니다. 기본값은 /var/log/ovirt-engine/ovirt-image-uploader/ovirt-image-uploader-[date].log입니다.
--cert-file=[PATH]
engine을 검증하기 위한 인증서로 [PATH]를 설정합니다. 기본값은 /etc/pki/ovirt-engine/ca.pem입니다.
--insecure
engine 검증을 시도하지 않도록 지정합니다.
--quiet
콘솔 출력을 최소로 감소시키는 자동 모드 (quiet mode)를 설정합니다.
-v, --verbose
보다 자세한 콘솔 출력을 표시하는 상세 표시 모드 (verbose mode)를 설정합니다.
-f, --force
강제 모드 (Force mode)는 업로드된 소스 파일이 내보내기 도메인에 있는 기존 파일과 동일한 파일 이름일 경우에 사용해야 합니다. 이 옵션은 기존 파일을 강제로 덮어쓰기합니다.

Red Hat Enterprise Virtualization Manager 옵션

-u [USER], --user=[USER]
명령 실행에 사용할 사용자 인증을 지정합니다. [USER]은/는 [username]@[domain] 형식으로 지정합니다. 사용자는 지정된 도메인에 존재해야 하며 Red Hat Enterprise Virtualization Manager가 알고 있어야 합니다.
-r [FQDN], --engine=[FQDN]
이미지가 업로드될 Red Hat Enterprise Virtualization Manager의 IP 주소 또는 정규화된 도메인 이름을 지정합니다. 이미지 업로더는 Red Hat Enterprise Virtualization Manager가 설치된 시스템과 동일한 컴퓨터에서 실행되는 것을 전제로 합니다. 기본값은 localhost:443입니다.

내보내기 스토리지 도메인 옵션

다음 옵션은 이미지를 업로드할 내보내기 도메인을 지정합니다. 이러한 옵션은 동시에 함께 사용할 수 없습니다. -e 또는 -n 옵션 중 하나를 사용해야 합니다.
-e [EXPORT_DOMAIN], --export-domain=[EXPORT_DOMAIN]
스토리지 도메인 EXPORT_DOMAIN을 업로드할 대상으로 설정합니다.
-n [NFSSERVER], --nfs-server=[NFSSERVER]
NFS path [NFSSERVER]을/를 업로드할 대상으로 설정합니다.

가져오기 옵션

다음 옵션을 사용하여 이미지를 내보내기 도메인에 업로드할 때 포함된 업로드할 이미지 속성을 사용자 정의할 수 있습니다.
-i, --ovf-id
이미지의 UUID가 업데이트되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지의 새 UUID를 생성합니다. 이는 업로드된 이미지와 환경에 이미 존재하는 이미지 사이에서 ID충돌이 발생하지 않게 합니다.
-d, --disk-instance-id
이미지에 있는 각 디스크의 인스턴스 ID 이름이 변경되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지에 있는 디스크의 새 UUID를 생성합니다. 이는 업로드된 이미지에 있는 디스크와 환경에 이미 존재하는 디스크 간의 충돌이 발생하지 않게 합니다.
-m, --mac-address
이미지의 네트워크 구성 요소가 해당 이미지에서 제거되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지에서 네트워크 인터페이스 카드를 제거하여 환경에 이미 존재하는 다른 가상 머신의 네트워크 카드와 충돌하지 않게 합니다. 이 옵션을 사용하지 않은 경우 관리 포털을 사용하여 네트워크 인터페이스 카드를 새로 가져오기한 이미지에 추가하여 Manager가 MAC 주소 충돌이 발생하지 않게 할 수 있습니다.
-N [NEW_IMAGE_NAME], --name=[NEW_IMAGE_NAME]
업로드될 이미지의 새 이름을 지정합니다.

16.4.3. 이미지 업로더와 호환하는 OVF 아카이브 만들기

개요

engine-image-uploader 도구를 사용하여 업로드할 수 있는 파일을 만들 수 있습니다.

절차 16.3. 이미지 업로더와 호환하는 OVF 아카이브 만들기

  1. Manager를 사용하여 빈 내보내기 도메인을 생성합니다. 빈 내보내기 도메인을 통해 어떤 디렉토리에 가상 머신이 들어 있는지를 쉽게 확인할 수 있습니다.
  2. 생성한 비어있는 내보내기 도메인에 가상 머신을 내보냅니다.
  3. 내보내기 도메인으로 사용되는 스토리지 서버에 로그인하여 NFS 공유의 root를 찾아 마운트 지점 아래의 서브 디렉토리로 변경합니다. 새 내보내기 도메인으로 시작했으므로 내보내기된 디렉토리 아래에는 하나의 디렉토리만 있습니다. 이에는 images/ 및 master/ 디렉토리가 포함되어 있습니다.
  4. tar -zcvf my.ovf images/ master/ 명령을 실행하여 tar/gzip OVF 아카이브를 생성합니다.
  5. 만든 OVF 파일 (예에서는 my.ovf로 부름)을 전달 받으면 누구나 engine-image-uploader 명령을 사용하여 Red Hat Enterprise Virtualization Manager로 가져오기할 수 있습니다.
결과

배포할 수 있는 압축된 OVF 이미지 파일이 생성되었습니다. 이 파일을 받으면 누구나 engine-image-uploader 명령을 사용하여 이미지를 Red Hat Enterprise Virtualization 환경에 업로드할 수 있습니다.

16.4.4. 기본적인 engine-image-uploader 사용 예

다음은 내보내기 스토리지 도메인을 나열하기 위해 engine 업로더 명령을 사용하는 방법의 예입니다:

예 16.6. 이미지 업로더를 사용하여 내보내기 스토리지 도메인 목록 보기

# engine-image-uploader list
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
Export Storage Domain Name | Datacenter  | Export Domain Status
myexportdom               | Myowndc 　  | active
다음은 OVF (Open Virtualization Format) 파일을 업로드하는 방법의 예입니다:

예 16.7. 이미지 업로더를 사용하여 파일 업로드

# engine-image-uploader -e myexportdom upload myrhel6.ovf
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):