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
FLAG FACOLTATIVI
--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
Questi flag sono disponibili per tutti i comandi: --configuration, --format, --help, --project, --quiet.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
