To pull OCI packages from a registry, run:
gdcloud artifacts pull SOURCE DESTINATION
To pull a single manifest repository from the registry, run:
gdcloud artifacts pull SOURCE DESTINATION --single-manifest-repo
To pull OCI packages from a registry without adhering to TLS protocols, run:
gdcloud artifacts pull SOURCE DESTINATION --insecure
The SOURCE is a reference of a remote OCI image. For example, gcr.io/cloud-marketplace/google/nginx:1.25.
The DESTINATION path specified must point to an empty directory.
This command writes the extracted image to the output path specified in SOURCE. This output path must point to an empty directory.
可选标志
--insecure Allow pulling from the registry, and establishing a connection to the server, even for server connections otherwise considered insecure.
--single-manifest-repo Pull a single-manifest repository from the registry, where the source is the reference for manifest instead of the image index.
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-04。"],[[["\u003cp\u003eThe \u003ccode\u003egdcloud artifacts pull\u003c/code\u003e command is used to pull OCI packages from a registry to a local destination.\u003c/p\u003e\n"],["\u003cp\u003eThe source of the OCI package is defined by a reference, such as \u003ccode\u003egcr.io/cloud-marketplace/google/nginx:1.25\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe destination for pulled OCI packages must be an empty directory.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--insecure\u003c/code\u003e flag allows pulling from registries and connecting to servers even with insecure TLS protocols.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--single-manifest-repo\u003c/code\u003e flag enables pulling a single-manifest repository, where the source is a manifest reference instead of the image index.\u003c/p\u003e\n"]]],[],null,["# gdcloud artifacts pull\n\nNAME\n----\n\ngdcloud artifacts pull - Pull OCI packages from a registry.\n\nSYNOPSIS\n--------\n\n gdcloud artifacts pull SOURCE DESTINATION [flags]\n\n### EXAMPLES\n\n To pull OCI packages from a registry, run:\n\n gdcloud artifacts pull SOURCE DESTINATION\n\n To pull a single manifest repository from the registry, run:\n\n gdcloud artifacts pull SOURCE DESTINATION --single-manifest-repo\n\n To pull OCI packages from a registry without adhering to TLS protocols, run:\n\n gdcloud artifacts pull SOURCE DESTINATION --insecure\n\n The SOURCE is a reference of a remote OCI image. For example, gcr.io/cloud-marketplace/google/nginx:1.25.\n The DESTINATION path specified must point to an empty directory.\n This command writes the extracted image to the output path specified in SOURCE. This output path must point to an empty directory.\n\n### OPTIONAL FLAGS\n\n --insecure Allow pulling from the registry, and establishing a connection to the server, even for server connections otherwise considered insecure.\n --single-manifest-repo Pull a single-manifest repository from the registry, where the source is the reference for manifest instead of the image index.\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."]]