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 specified registry.\u003c/p\u003e\n"],["\u003cp\u003eThe command requires a source (remote OCI image reference) and a destination (empty directory path) for the pull operation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--insecure\u003c/code\u003e flag allows pulling packages from insecure server connections.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--single-manifest-repo\u003c/code\u003e flag enables pulling a single manifest repository instead of the entire 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/appliance/resources/gdcloud-reference/gdcloud) page."]]