Stay organized with collections
Save and categorize content based on your preferences.
NAME
gdcloud artifacts push - Push OCI packages to a registry.
SYNOPSIS
gdcloud artifacts push SOURCE DESTINATION [flags]
EXAMPLES
To push a OCI packages to a registry, run:
gdcloud artifacts push SOURCE DESTINATION
To push a single manifest of the repository to the registry, run:
gdcloud artifacts push SOURCE DESTINATION --single-manifest-repo
To push OCI packages to a registry without adhering to TLS protocols, run:
gdcloud artifacts push SOURCE DESTINATION --insecure
The SOURCE path must point to a directory containing the OCI bundle.
The DESTINATION is a reference of a remote OCI image. For example, gcr.io/cloud-marketplace/google/nginx:1.25.
This command writes the extracted image to the output path specified in SOURCE. This output path must point to an empty directory.
OPTIONAL FLAGS
--ca-cert-path string Absolute file path to the user-provided CA certificate file that is used to push a manifest over a HTTPS connection.
--insecure Allow pushing to the registry, and establish a connection to the server, even for server connections otherwise considered insecure.
--single-manifest-repo Tag and push the single manifest of the repository, as opposed to the image index, to the registry.
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe \u003ccode\u003egdcloud artifacts push\u003c/code\u003e command is used to push OCI packages to a specified registry.\u003c/p\u003e\n"],["\u003cp\u003eThe command requires a source directory containing the OCI bundle and a destination representing the remote OCI image reference.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--insecure\u003c/code\u003e flag allows pushing to the registry without enforcing secure TLS protocols.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--single-manifest-repo\u003c/code\u003e flag pushes a single manifest of the repository instead of the image index.\u003c/p\u003e\n"],["\u003cp\u003eYou can provide an absolute file path to a user-provided CA certificate file using \u003ccode\u003e--ca-cert-path\u003c/code\u003e to push over a HTTPS connection.\u003c/p\u003e\n"]]],[],null,["# gdcloud artifacts push\n\nNAME\n----\n\ngdcloud artifacts push - Push OCI packages to a registry.\n\nSYNOPSIS\n--------\n\n gdcloud artifacts push SOURCE DESTINATION [flags]\n\n### EXAMPLES\n\n To push a OCI packages to a registry, run:\n\n gdcloud artifacts push SOURCE DESTINATION\n\n To push a single manifest of the repository to the registry, run:\n\n gdcloud artifacts push SOURCE DESTINATION --single-manifest-repo\n\n To push OCI packages to a registry without adhering to TLS protocols, run:\n\n gdcloud artifacts push SOURCE DESTINATION --insecure\n\n The SOURCE path must point to a directory containing the OCI bundle.\n The DESTINATION is a reference of a remote OCI image. For example, gcr.io/cloud-marketplace/google/nginx:1.25.\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 --ca-cert-path string Absolute file path to the user-provided CA certificate file that is used to push a manifest over a HTTPS connection.\n --insecure Allow pushing to the registry, and establish a connection to the server, even for server connections otherwise considered insecure.\n --single-manifest-repo Tag and push the single manifest of the repository, as opposed to the image index, to the registry.\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."]]