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
MARCAS OPCIONALES
--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.
MARCAS GENERALES DE GCLOUD
Estas marcas están disponibles para todos los comandos: --configuration, --format, --help, --project y --quiet.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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."]]
