23장. 도메인 XML 조작
이 장에서는 게스트 가상 머신 XML 구성 파일의 구성 요소를 도메인 XML 이라고도 합니다. 이 장에서는 도메인 이라는 용어는 모든 게스트 가상 머신에 필요한 루트
<도메인>
요소를 나타냅니다. 도메인 XML에는 type
및 id
라는 두 가지 속성이 있습니다.type
은 도메인 실행에 사용되는 하이퍼바이저를 지정합니다. 허용되는 값은 드라이버별이지만 KVM
과 기타를 포함합니다. id
는 실행 중인 게스트 가상 머신의 고유한 정수 식별자입니다. 비활성 시스템에는 id
값이 없습니다. 이 장의 섹션에서는 도메인 XML의 구성 요소에 대해 설명합니다. 이 설명서의 추가 장에서는 도메인 XML을 조작해야 할 때 이 장을 확인할 수 있습니다.
중요
지원되는 관리 인터페이스(예: virsh 및 Virtual Machine Manager) 및 명령(예: virt-xml)을 사용하여 도메인 XML 파일의 구성 요소를 편집합니다. 텍스트 편집기에서 도메인 XML 파일을 직접 열고 편집하지 마십시오. 도메인 XML 파일을 직접 편집해야 하는 경우 virsh edit 명령을 사용합니다.
참고
이 장은 libvirt 업스트림 문서를 기반으로 합니다.
23.1. 일반 정보 및 메타데이터
이 정보는 다음 도메인 XML에 포함되어 있습니다.
그림 23.1. 도메인 XML 메타데이터
<domain type='kvm' id='3'> <name>fv0</name> <uuid>4dea22b31d52d8f32516782e98ab3fa0</uuid> <title>A short description - title - of the domain</title> <description>A human readable description</description> <metadata> <app1:foo xmlns:app1="http://app1.org/app1/">..</app1:foo> <app2:bar xmlns:app2="http://app1.org/app2/">..</app2:bar> </metadata> ... </domain>
도메인 XML의 이 섹션의 구성 요소는 다음과 같습니다.
element | 설명 |
---|---|
<name> | 가상 머신의 이름을 할당합니다. 이 이름은 alpha-numeric 문자로만 구성되어야 하며 단일 호스트 물리적 머신 범위 내에서 고유해야 합니다. 영구 구성 파일을 저장하기 위해 파일 이름을 형성하는 데 사용되는 경우가 많습니다. |
<uuid> | 가상 머신의 전역 고유 식별자를 할당합니다. 형식은 RFC 4122-호환해야 합니다(예: 3e3fce45-4f53-4fa7-bb32-11f34168b82b ). 새 시스템을 정의하거나 생성할 때 생략된 경우 임의의 UUID가 생성됩니다. 또한 sysinfo 사양을 사용하여 UUID를 제공할 수도 있습니다. |
<title> | 도메인에 대한 간단한 설명을 위한 공간을 만듭니다. 제목에는 새 줄이 포함되어서는 안 됩니다. |
<description> | 제목과 달리 이 데이터는 libvirt에서 사용되지 않습니다. 여기에는 사용자가 표시하도록 선택하는 모든 정보가 포함될 수 있습니다. |
<metadata> | 애플리케이션에서 사용자 지정 메타데이터를 XML 노드/트리 형태로 저장하는 데 사용할 수 있습니다. 애플리케이션은 XML 노드/트리에서 사용자 지정 네임 스페이스를 사용해야 하며, 네임 스페이스당 하나의 최상위 요소(애플리케이션 요구 사항이 있는 경우)는 이름 공간에 하위 요소를 사용해야 합니다. |