Download the gdcloud CLI

This document explains how to download the gdcloud CLI in your Google Distributed Cloud (GDC) air-gapped environment. GDC offers multiple gdcloud CLI bundle options for various use cases, such as:

Platform: Select the operating system (OS) and architecture that correspond with your local environment.
GDC version: Select the binary version of the gdcloud CLI, which corresponds with GDC patch versions. We recommend using the latest version available, but you can download archived versions for specific use cases.
Type: Select the bundle type based on your needs. The Full bundle type includes all supported gdcloud CLI commands for your selected platform. The Lite bundle type includes a subset of the gdcloud CLI commands from the Full bundle to provide a smaller download size.

Both Full and Lite bundle archives include the bin/component_bundles/ directory for installing components such as storage-cli-dependencies. A standalone gdcloud CLI binary copied outside the extracted bundle directory doesn't include component bundles and can't run gdcloud components install.

The available gdcloud CLI bundles give you flexibility to run the CLI as you prefer. For more information, see Available gdcloud CLI bundles.

This document is for all audience groups that work on GDC that must use a dedicated command-line interface tool for their air-gapped hardware and software workflows. For more information, see Audiences for GDC air-gapped documentation.

Before you begin

Confirm that you have network access to an active GDC environment and know your GDC console URL (hostname). Unlike the Google Cloud CLI, the gdcloud CLI isn't publicly available for download; you download the bundle directly from your GDC console. Contact your Infrastructure Operator or Platform Administrator if you don't have this URL.
Configure an organization network policy to allow traffic from a specific CIDR outside the organization to the artifact registry. Use service all in the OrganizationNetworkPolicy resource configuration.