4.20. template
템플릿 리소스 유형은 Red Hat Virtualization 환경의 모든 가상 머신 템플릿을 그룹화합니다. --vm-id|name 및 --name 만 필수 매개변수입니다. 선택적 매개변수를 지정하지 않으면 템플릿은 템플릿을 생성하는 데 사용된 가상 시스템의 설정을 상속합니다.
| 이름 | 유형 | 설명 | 필수 항목 | 사용자 Creatable | 사용자 Updatable |
|---|---|---|---|---|---|
--vm-id|name
|
string
|
템플릿 기반으로 사용되는 가상 머신에 대한 참조입니다.
|
제공됨
|
제공됨
|
없음
|
--name
|
string
|
가상 머신 템플릿의 이름입니다.
|
제공됨
|
예
|
제공됨
|
--memory
|
long
|
가상 머신 템플릿의 메모리 양(바이트)입니다.
|
없음
|
예
|
제공됨
|
--cpu-topology-cores
|
int
|
가상 머신 템플릿에서 사용 가능한 CPU 코어 수입니다.
|
없음
|
예
|
제공됨
|
--high_availability-enabled
|
부울
|
가상 머신 템플릿에 대한 고가용성을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--os-cmdline
|
string
|
정의된 커널과 함께 사용할 커널 명령줄 매개 변수 문자열입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--origin
|
string
|
가상 머신 템플릿의 원본입니다.
rhev,vmware 또는 xen 을 지정합니다.
|
없음
|
예
|
제공됨
|
--high_availability-priority
|
int
|
각 가상 머신 템플릿의 고가용성의 우선순위 값(예: 부팅 순서)을 설정합니다.
|
없음
|
예
|
제공됨
|
--timezone
|
string
|
Windows 가상 머신 템플릿에 대한 Sysprep 시간대 설정.
GMT+00:00 과 같은 형식을 지정합니다.
|
없음
|
예
|
제공됨
|
--domain-name
|
string
|
가상 머신 템플릿의 도메인 이름입니다.
|
없음
|
예
|
제공됨
|
--type
|
string
|
가상 머신 유형을 정의합니다.
desktop 또는 server 를 지정합니다.
|
없음
|
예
|
제공됨
|
--stateless
|
boolean
|
결과 가상 머신이 상태 비저장인 경우
true 로 설정합니다. 상태 비저장 가상 머신에는 부팅 시 생성된 디스크 이미지의 스냅샷이 포함되어 있습니다. 즉, 재부팅 후 상태 변경 사항이 유지되지 않습니다.
|
없음
|
예
|
제공됨
|
--delete_protected
|
boolean
|
이 템플릿에서 생성된 가상 머신을 삭제할 수 없도록 하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--sso-methods-method
|
컬렉션
|
사용된 Single Sign-On 메서드를 정의합니다. 예를 들면
--sso-methods-method method.id=GUEST_AGENT 입니다.
|
없음
|
예
|
제공됨
|
--rng_device-rate-bytes
|
int
|
마침표당 사용할 수 있는 바이트 수를 지정합니다.
|
없음
|
예
|
제공됨
|
--rng_device-rate-period
|
int
|
밀리초 단위의 기간을 지정합니다. 지정된 경우
--rng_device-rate-bytes 도 지정해야 합니다.
|
없음
|
예
|
제공됨
|
--rng_device-source
|
string
|
난수 생성기의 소스입니다.
random 또는 hwrng 를 지정합니다.
|
없음
|
예
|
제공됨
|
--console-enabled
|
boolean
|
VirtIO 콘솔 장치 기능을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--placement_policy-affinity
|
string
|
템플릿에서 생성된 각 가상 머신의 마이그레이션 선호도입니다.
migratable,user_migratable 또는 pinned 를 지정합니다.
|
없음
|
예
|
제공됨
|
--description
|
string
|
가상 머신 템플릿에 대한 설명입니다.
|
없음
|
예
|
제공됨
|
--comment
|
string
|
가상 머신 템플릿에 대한 주석입니다.
|
없음
|
예
|
제공됨
|
--custom_properties-custom_property
|
컬렉션
|
사용자 정의 스크립트에 매개 변수로 전달되는 사용자 정의 환경 변수 집합입니다.
|
없음
|
예
|
제공됨
|
--os-type
|
string
|
가상 머신 템플릿의 운영 체제 유형입니다.
|
없음
|
예
|
제공됨
|
--OS-boot
|
컬렉션
|
가상 머신 템플릿의 부팅 장치입니다.
cdrom,hd 또는 network 를 지정합니다. 예를 들면 --os-boot boot.dev=hd 입니다.
|
없음
|
예
|
제공됨
|
--cpu-topology-sockets
|
int
|
가상 머신 템플릿에서 사용 가능한 CPU 소켓 수입니다.
|
없음
|
예
|
제공됨
|
--cpu_shares
|
int
|
가상 머신에서 다른 가상 머신에 상대적으로 요청할 수 있는 CPU 리소스의 수준입니다. 예를 들어 우선순위가 낮은 가상 머신의 경우
512, 중간 우선 순위 가상 머신의 경우 1024, 우선 순위가 높은 가상 머신의 경우 2048 입니다.
|
없음
|
예
|
제공됨
|
--cpu-architecture
|
string
|
CPU 아키텍처를 정의합니다.
x86_64,ppc64 또는 undefined 를 지정합니다.
|
없음
|
예
|
제공됨
|
--os-kernel
|
string
|
결과 가상 머신이 부팅되도록 구성된 커널 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--display-type
|
string
|
표시 유형을 정의합니다.
spice 또는 vnc 를 지정합니다.
|
없음
|
예
|
제공됨
|
--display-monitors
|
int
|
사용 가능한 디스플레이 수를 정의합니다.
|
없음
|
예
|
제공됨
|
--display-single_qxl_pci
|
boolean
|
단일 가상 PCI 장치를 사용하여 여러 개의 모니터를 구동하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-allow_override
|
boolean
|
템플릿 콘솔 설정을 재정의할 수 있도록
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-smartcard_enabled
|
boolean
|
가상 머신의 스마트 카드 기능을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-file_transfer_enabled
|
boolean
|
SPICE 파일 전송을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-copy_paste_enabled
|
boolean
|
SPICE 클립보드 복사 및 붙여넣기를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-keyboard_layout
|
string
|
가상 시스템의 키보드 레이아웃을 정의합니다. 이 옵션은 VNC 프로토콜을 사용하는 경우에만 사용할 수 있습니다.
en-US 와 같은 형식을 지정합니다.
|
없음
|
예
|
제공됨
|
--os-initRd
|
string
|
지정된 커널과 함께 사용할 initrd 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--usb-enabled
|
부울
|
가상 머신에서 USB 지원을 활성화하려면
true 로 설정합니다. 이 옵션은 SPICE 프로토콜을 사용하는 가상 머신에만 사용할 수 있습니다.
|
없음
|
예
|
제공됨
|
--usb-type
|
string
|
USB 지원이 활성화된 경우 USB 유형을 정의합니다.
레거시 또는 를 지정합니다.
중요
레거시 USB 옵션은 더 이상 사용되지 않으며 Red Hat Virtualization 4.1에서 제거될 예정입니다.
|
없음
|
예
|
제공됨
|
--tunnel_migration
|
boolean
| libvirt 데몬을 통한 데이터 전송을 활성화하려면 true 로 설정합니다. 터널링된 전송은 더 강력한 암호화 알고리즘을 사용하지만 전송 중에 데이터 로드를 늘립니다.
|
없음
|
예
|
제공됨
|
--migration_downtime
|
int
|
실시간 마이그레이션 중에 가상 머신을 중단할 수 있는 최대 시간(밀리초)을 정의합니다.
|
없음
|
예
|
제공됨
|
--virtio_scsi-enabled
|
boolean
|
VirtIO 콘솔 장치를 가상 머신에 연결할 수 있도록 하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--soundcard_enabled:
|
boolean
|
건전한 카드를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--vm-disks-disk
|
컬렉션
|
템플릿에 연결된 디스크에 대한 참조입니다.
|
없음
|
예
|
없음
|
--id
|
string
|
가상 머신 템플릿의 ID입니다.
|
없음
|
예
|
제공됨
|
--permissions-clone
|
boolean
|
소스 가상 머신의 권한을 템플릿에 복사하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--version-version_name
|
string
| --version-base_template-id 매개변수와 함께 사용됩니다. 하위 템플릿의 이름을 정의합니다.
|
없음
|
예
|
제공됨
|
--version-base_template-id
|
string
|
루트 템플릿으로 사용할 템플릿 ID를 정의합니다. 이 템플릿을 루트 템플릿의 하위 템플릿으로 생성하려면 사용합니다.
|
없음
|
예
|
제공됨
|
--cpu-cpu_tune-vcpu_pin
|
컬렉션
|
호스트의 실제 CPU에 고정할 가상 시스템의 가상 CPU를 정의합니다.
|
없음
|
예
|
제공됨
|
--serial_number-policy
|
string
|
가상 머신 템플릿의 일련 번호 정책을 정의합니다.
호스트,vm 또는 custom 를 지정합니다. custom 를 사용하는 경우 --serial_number-value 를 사용하여 일련 번호 값도 정의합니다.
|
없음
|
예
|
제공됨
|
--serial_number-value
|
string
|
가상 머신 템플릿의 일련 번호를 정의합니다.
|
없음
|
예
|
제공됨
|
--bios-boot_menu-enabled
|
boolean
|
부팅 메뉴를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--cluster-id
|
string
|
클러스터 ID를 지정하여 사용할 클러스터를 정의합니다.
|
없음
|
예
|
제공됨
|
--cluster-name
|
string
|
클러스터 이름을 지정하여 사용할 클러스터를 정의합니다.
|
없음
|
예
|
제공됨
|
--cpu_profile-id
|
string
|
사용할 CPU 프로필을 정의합니다. cpuprofiles 목록 명령을 사용하여 전체 CPU 프로필 ID 목록을 검색합니다.
|
없음
|
예
|
제공됨
|
--expect
|
'201-created'
|
예상 HTTP 헤더가 반환될 때까지 요청이 비동기 상태가 됩니다. 작업이 완료되기 전에 성공으로 반환하는 장기 실행 작업에 유용합니다.
|
없음
|
예
|
제공됨
|
--correlation_id
|
string
|
시스템 간 로깅에 대한 작업의 태그 지정 식별자입니다. 클라이언트가 식별자를 정의하지 않으면 한 개가 생성됩니다.
|
없음
|
예
|
제공됨
|
--sso-methods-method 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
method.id
|
string
|
사용된 Single Sign-On 방법:
GUEST_AGENT.
|
--custom_properties-custom_property 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
custom_property.name
|
string
|
사용자 지정 속성 이름입니다.
|
custom_property.value
|
string
|
사용자 지정 속성 값입니다.
|
--os-boot 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
boot.dev
|
string
|
가상 머신 템플릿의 부팅 장치입니다.
cdrom,hd 또는 network 를 지정합니다.
|
--vm-disks-disk 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
disk.id
|
string
|
가상 디스크에 대한 참조입니다.
|
storage_domains.storage_domain
|
컬렉션
|
디스크 스토리지 도메인의 하위 매개변수 세트를 정의합니다.
|
--cpu-cpu_tune-vcpu_pin 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
vcpu_pin.vcpu
|
int
|
할당할 가상 CPU입니다.
|
vcpu_pin.cpu_set
|
string
|
호스트의 물리적 CPU입니다.
|
예 4.41. 새 템플릿 생성
[RHEVM shell (connected)]# add template --name MyTemplate1 --vm-name MyVM1
예 4.42. 템플릿 업데이트
[RHEVM shell (connected)]# update template MyTemplate1 --memory 1073741824
예 4.43. 템플릿 삭제
[RHEVM shell (connected)]# remove template MyTemplate1
다음 표에는 가상 머신 템플릿 리소스에 대한 작업이 나열되어 있습니다.
| 동작 | 설명 |
|---|---|
내보내기 | 내보내기 스토리지 도메인으로 템플릿을 내보냅니다. |
