8.6.2. Uploading a virtual machine image by using the CLI
You can upload an operating system image by using the virtctl command-line tool. You can use an existing data volume or create a new data volume for the image.
Prerequisites
-
You must have an
ISO,IMG, orQCOW2operating system image file. -
For best performance, compress the image file by using the virt-sparsify tool or the
xzorgziputilities. - The client machine must be configured to trust the OpenShift Container Platform router’s certificate.
-
You have installed the
virtctlCLI. -
You have installed the OpenShift CLI (
oc).
Procedure
Upload the image by running the
virtctl image-uploadcommand:$ virtctl image-upload dv <datavolume_name> \ --size=<datavolume_size> \ --image-path=</path/to/image><datavolume_name>- The name of the data volume.
<datavolume_size>-
The size of the data volume. For example:
--size=500Mi,--size=1G </path/to/image>The file path of the image.
참고-
If you do not want to create a new data volume, omit the
--sizeparameter and include the--no-createflag. - When uploading a disk image to a PVC, the PVC size must be larger than the size of the uncompressed virtual disk.
-
To allow insecure server connections when using HTTPS, use the
--insecureparameter. When you use the--insecureflag, the authenticity of the upload endpoint is not verified.
-
If you do not want to create a new data volume, omit the
Optional. To verify that a data volume was created, view all data volumes by running the following command:
$ oc get dvs
8.6.2.1. Supported custom video device types 링크 복사링크가 클립보드에 복사되었습니다!
When creating a virtual machine (VM), you can configure a custom video device type to override the default video configuration.
Configuring a custom video device allows you to specify different video devices, based on your guest operating system requirements and performance needs.
Custom video device support is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
Using a custom video device provides several advantages:
- Performance
- Certain video devices provide better performance than the default configuration. For example, VirtIO is a more efficient video device on AMD/x86_64 architecture than legacy VGA.
- Resolution flexibility
- With some video device types, you can set custom display resolutions.
- Memory efficiency
- Some video types are more memory efficient for headless or console-only operations.
You can configure the following video device types:
-
VirtIO: provides improved performance, and hardware-accelerated video decoding and encoding by offloading tasks to the host. Recommended for modern guest operating systems with available
VirtIOdrivers. - VGA: the standard for analog video display (default on AMD/x86_64 with BIOS).
- Bochs: an emulated graphics adapter that provides a simple interface for guest operating systems to manage display settings (default on AMD/x86_64 with EFI).
- Cirrus: a legacy video device that provides stable video output.
- ramfb: a simple, unaccelerated virtual display device primarily used in the QEMU emulator, and useful for ARM architecture.
| Architecture | Boot mode | Default type | Supported types |
|---|---|---|---|
| AMD/x86_64 | BIOS |
|
|
| AMD/x86_64 | EFI |
|
|
| ARM64 | BIOS/EFI |
|
|
| s390x | BIOS/EFI |
|
|