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-09-04 UTC."],[[["\u003cp\u003eThe \u003ccode\u003egdcloud artifacts vm-images package\u003c/code\u003e command packages a VM image file into an OCI artifact.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the source and destination of the VM image, along with its name, version, and operating system.\u003c/p\u003e\n"],["\u003cp\u003eThe command allows you to limit image distribution to specific organizations' object storage or prevent it altogether.\u003c/p\u003e\n"],["\u003cp\u003eYou can define the minimum disk size requirement for the VM image and designate it as a GDCH internal cluster node image if needed.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define the GDCH project that the image belongs to which modifies the OCI metadata target harbor property.\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/appliance/resources/gdcloud-reference/gdcloud) page."]]
