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"]],["上次更新時間: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."]]