Skip to content

Latest commit

 

History

History
68 lines (53 loc) · 3.55 KB

config-vm.md

File metadata and controls

68 lines (53 loc) · 3.55 KB

This section describes the schema for the virtual-machine-specific section of the container configuration. The virtual-machine container specification provides additional configuration for the hypervisor, kernel, and image.

hypervisor (object, OPTIONAL) specifies details of the hypervisor that manages the container virtual machine.

  • path (string, REQUIRED) path to the hypervisor binary that manages the container virtual machine. This value MUST be an absolute path in the runtime mount namespace.
  • parameters (array of strings, OPTIONAL) specifies an array of parameters to pass to the hypervisor.

Example

    "hypervisor": {
        "path": "/path/to/vmm",
        "parameters": ["opts1=foo", "opts2=bar"]
    }

kernel (object, REQUIRED) specifies details of the kernel to boot the container virtual machine with.

  • path (string, REQUIRED) path to the kernel used to boot the container virtual machine. This value MUST be an absolute path in the runtime mount namespace.
  • parameters (array of strings, OPTIONAL) specifies an array of parameters to pass to the kernel.
  • initrd (string, OPTIONAL) path to an initial ramdisk to be used by the container virtual machine. This value MUST be an absolute path in the runtime mount namespace.

Example

    "kernel": {
        "path": "/path/to/vmlinuz",
        "parameters": ["foo=bar", "hello world"],
        "initrd": "/path/to/initrd.img"
    }

image (object, OPTIONAL) specifies details of the image that contains the root filesystem for the container virtual machine.

This image contains the root filesystem that the virtual machine kernel will boot into, not to be confused with the container root filesystem itself. The latter, as specified by path from the Root Configuration section, will be mounted inside the virtual machine at a location chosen by the virtual-machine-based runtime.

Example

    "image": {
        "path": "/path/to/vm/rootfs.img",
	"format": "raw"
    }