gcloud-version

Display Google Cloud SDK installed component versions

TLDR

Display version information for all installed components, along with available updates to them

$ gcloud version

Display help

$ gcloud version --help

PARAMETERS

--only-cli
Displays only the core gcloud CLI version, omitting the detailed list of installed components (like gsutil, bq, etc.) and system information.

The gcloud version command is an essential utility within the Google Cloud SDK, designed to provide a comprehensive overview of the installed gcloud CLI and its associated components. When executed, it typically displays the version of the gcloud command-line tool itself, along with the versions of various gcloud components like gsutil, bq, and others that are part of your SDK installation. Beyond just component versions, it often includes valuable system information such as the Python version being used by the SDK and details about the operating system.

This command is invaluable for troubleshooting, verifying successful SDK installations, and confirming that specific components are up-to-date. While a quick gcloud --version might provide just the main CLI version, gcloud version offers a more detailed breakdown, making it the preferred choice for a thorough version check. It helps users quickly ascertain the exact environment they are working with, which is crucial for debugging compatibility issues or ensuring that the correct tool versions are present for specific tasks.

CAVEATS

The command requires the Google Cloud SDK to be installed and properly configured on the system. The exact output format and listed components may vary slightly depending on the SDK version, installed components, and the operating system.

TYPICAL OUTPUT EXAMPLE

A common output from gcloud version might look like this:

Google Cloud SDK 465.0.0
bq 2.0.100
core 2024.03.15
gsutil 5.28

Python 3.10.12 (64-bit)
Runtime: Python
Locale: en_US
Platform: Linux-6.5.0-26-generic-x86_64-with-glibc2.35
Modules: Pylint, numpy, requests, google-auth, OpenSSL, setuptools
gcloud: [location]
bq: [location]
gsutil: [location]

Note that the [location] placeholders will be actual file paths on your system.

HISTORY

The gcloud version command has been a fundamental part of the Google Cloud SDK since its early iterations. Its primary function, to report the versions of the CLI and its components, has remained consistent. As the Google Cloud ecosystem and the SDK evolved, the command's output expanded to include more granular component details and system information, reflecting the growing complexity and modularity of the SDK. It has consistently served as a quick diagnostic tool for developers and administrators.