To package a VM image into a format compatible with System Artifact Registry, run:
gdcloud artifacts vm-images package SOURCE DESTINATION \
--name IMAGE_NAME \
--version VERSION_NUMBER \
--os IMAGE_OS
OPTIONAL FLAGS
--limit-object-storage-distribution string Limit the distribution of the image to object storage in specific organizations.
Set the value to "gdchservices" to only distribute the image to the
object storage of the "gdchservices" organization.
Set the value to "none" to prevent the distribution of the image to the
object storage of any organization.
If this value is empty, the image is distributed to the
object storage of all organizations.
--minimum-disk-size string Minimum size of the disk this image can be used on. For example, 10GB.
--name string Name of the VM image.
--node-vm-image If set, the VM image is a GDC air-gapped internal cluster node image.
--os string Operating system of the image. Must be one of: [rhel-8 rocky-linux-8 rocky-linux-9 ubuntu-2004 ubuntu-2204 ubuntu-2404 windows-10 windows-2019]
--version string Version of the VM image. For example, 0.1.
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003ePackages a VM image file into an OCI artifact using the \u003ccode\u003egdcloud artifacts vm-images package\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the source and destination of the VM image, along with the image's name, version, and operating system.\u003c/p\u003e\n"],["\u003cp\u003eAllows limiting the distribution of the image to object storage in specific organizations or preventing distribution to any organization's object storage.\u003c/p\u003e\n"],["\u003cp\u003eSupports setting a minimum disk size for the image and can flag the image as a GDC air-gapped internal cluster node image.\u003c/p\u003e\n"],["\u003cp\u003eAccepts various operating systems, including rhel-8, rocky-linux-8/9, ubuntu-2004/2204/2404, and windows-10/2019, and provides several global flags for configuration and output.\u003c/p\u003e\n"]]],[],null,["# gdcloud artifacts vm-images package\n\nNAME\n----\n\ngdcloud artifacts vm-images package - Package a VM image file into an OCI artifact.\n\nSYNOPSIS\n--------\n\n gdcloud artifacts vm-images package SOURCE DESTINATION [flags]\n\n### EXAMPLES\n\n To package a VM image into a format compatible with System Artifact Registry, run:\n\n gdcloud artifacts vm-images package SOURCE DESTINATION \\\n --name IMAGE_NAME \\\n --version VERSION_NUMBER \\\n --os IMAGE_OS\n\n### OPTIONAL FLAGS\n\n --limit-object-storage-distribution string Limit the distribution of the image to object storage in specific organizations.\n Set the value to \"gdchservices\" to only distribute the image to the\n object storage of the \"gdchservices\" organization.\n Set the value to \"none\" to prevent the distribution of the image to the\n object storage of any organization.\n If this value is empty, the image is distributed to the\n object storage of all organizations.\n --minimum-disk-size string Minimum size of the disk this image can be used on. For example, 10GB.\n --name string Name of the VM image.\n --node-vm-image If set, the VM image is a GDC air-gapped internal cluster node image.\n --os string Operating system of the image. Must be one of: [rhel-8 rocky-linux-8 rocky-linux-9 ubuntu-2004 ubuntu-2204 ubuntu-2404 windows-10 windows-2019]\n --version string Version of the VM image. For example, 0.1.\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-reference/gdcloud) page."]]