跳到正文

Google Cloud CLI 版本记录

Google · 一套命令行工具,用于管理 Google Cloud 项目、云资源和应用,适合终端操作与自动化部署。

Cask开发工具自带更新
主页
安装命令
brew install --cask gcloud-cli
近 30 天安装
50,571
App榜第 5
近一年安装
60万
365 天累计
最新版本
594.0.0
下载大小
55MB
gz
更新节奏
每周
近 30 天 5 个版本
  1. 594.0.0

    最新

    OpenNavo 编辑 Homebrew 收录

    Google Cloud CLI 594.0.0 于 2026-11-17 发布,让位置参数不再被 --account 和 --project 覆盖,并把多组命令提升为正式可用。

    破坏性
    认证命令上 --account 不再覆盖账号参数。账单命令现在要求 ACCOUNT_ID,不再用后面的 --account。shared-vpc 现在要求 PROJECT_ID,不再用后面的 --project。
    命令行
    设置凭据文件覆盖时 config-helper 不再崩溃。失败操作现在会带上错误原因和帮助链接。
    正式版
    Agent Registry 技能加密和修订下载已正式可用。BigLake 取消发布和 Cloud SQL 蓝绿部署已正式可用。Cloud Tasks 批量创建和批量删除已正式可用。Cloud Run 部署和服务命令的区域端点已正式可用。
    新增
    AlloyDB 新增 z4d-highmem-16-standardlssd 机器类型。Composer 更新可以把 Composer 3 回滚到上一个镜像。GKE 创建和更新可以开启集群缩放到零及延迟。
    修复
    model-garden 部署不再忽略 --system-labels。存储桶更新现在会合并重复的标签参数。

    Google Cloud CLI 594.0.0 于 2026-11-17 发布,让位置参数不再被后面的 --account 或 --project 覆盖,并把多组命令提升为正式可用,供在终端管理 Google Cloud 的人使用。官方说明:https://docs.cloud.google.com/sdk/docs/release-notes

    • 认证、账单和 Compute shared-vpc 命令现在以位置参数为准,不再被后面的 --account 或 --project 覆盖。
    • Agent Registry、BigLake 取消发布、Cloud SQL 蓝绿部署、Cloud Tasks 批量操作和 Cloud Run 区域端点已正式可用。
    • AlloyDB 新增机器类型,Composer 3 可以回滚镜像,GKE 可以把集群缩放到零。
    • 设置凭据文件覆盖时 config-helper 不再崩溃,失败的长时运行操作会带上错误原因。
  2. 593.0.0
  3. 592.0.0

    OpenNavo 编辑 Homebrew 收录

    Google Cloud CLI 592.0.0 于 2026-11-03 发布,Datastore 与 Firestore 模拟器不再支持 Java 25 之前的版本,Debian 基础镜像也已精简。

    • Cloud Datastore 模拟器(gcloud beta emulators datastore start)不再支持 Java 25 之前的版本;可升级到 Java 25 或更高版本,或改用旧版 gcloud CLI。
    • Cloud Firestore 模拟器(gcloud emulators firestore start)同样要求 Java 25 或更高版本。
    • Debian 基础 Docker 镜像不再包含系统 Python 和 C 编译器;gcloud、gsutil 和 bq 始终使用镜像内置的 Python。
    • 在这些镜像中设置 CLOUDSDK_PYTHON=python3 会导致 gcloud、gsutil 和 bq 调用失败;取消该设置即可使用内置 Python。
    • google-cloud-cli 模拟器及 App Engine 的 deb 和 rpm 包改为依赖 headless JRE,优先使用 Java 25。
    • gcloud agent-registry skills create 和 update 移除了 --scanning-state 标志,改用 --scanning-policy。
    • AlloyDB 新增 --connection-pooling-authproxy-pooler-scaling-type 标志,并将 autoscaler 相关标志提升为 GA。
  4. 591.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    Google Cloud CLI 591.0.0 于 2026 年 10 月 27 日发布,本次更新修复了 macOS 组件更新卡死的问题,将内置 Python 更新至 3.14.9,并将多个命令组提升为 GA。

    破坏性变更与已知问题

    • 修复了 macOS 上 gcloud components update 卡住并在打印 "WARNING: Known issue encountered updating Python modules" 后立即退出的问题,该问题导致无法更新至最新版本。
    • 该问题存在于 590.0.0 和 590.0.1 版本中,因此这两个版本的安装仍包含此缺陷,需要执行一次性规避操作:gcloud components --flags-file=<(echo 'update:')。
    • 从 589.0.0 或更早版本更新,或从 591.0.0 起更新,无需规避操作。

    Google Cloud CLI

    • 将内置 Python 更新至 3.14.9。

    新增

    • Agent Registry:将 gcloud agent-registry skills、skills revisions、publishers 和 findings 命令组提升为 GA。
    • Audit Manager:新增 gcloud audit-manager audit-schedules describe 命令。
    • Beyondcorp:为 security gateways create 和 update 新增 --dispatch-info-output-type 参数,并为 applications create 和 update 新增上游 dispatchInfo 配置。
    • Cloud Bigtable:为 table create 命令新增 --timestamp-granularity 参数(millis 或 micros);微秒粒度仅在 Enterprise Plus 实例上受支持。
    • Cloud DNS:--endpoint-ip 现为 gcloud beta dns outbound-endpoints create 的可选参数。
    • Cloud IAM:为 workload identity pool OIDC providers create 和 update 新增 --discovery-uri 和 --actor-providers 参数。
    • Cloud Storage:为 gcloud storage buckets create 新增 --labels 和 --labels-file 参数。
    • Compute Engine:为 backend services create 和 update 新增熔断器参数和 --no-circuit-breakers,并在 gcloud compute instance-groups managed list-instances 中为 ACTION、HEALTH_STATE 和 STATUS 增加着色。
    • Database Migration:为 conversion workspaces create 和 update 新增 --ai-processing-location 参数。
    • Kubernetes Engine:为 gcloud container node-pools update 新增 --node-config-update-mode 参数。
    • Workspace Key Access:新增 gcloud beta workspace-key-access 命令组。

    变更

    • 将 Dataproc 弹性配置参数和 Redis 集群基本身份验证命令提升为 GA。
    • 将 GKE Hub 的 --prioritized 参数和 config-management update 命令提升为 GA。
    • 将 Secure Source Manager 的 branch-rules、hooks、issues、issues comments、pull-requests 和 pull-requests comments 命令组提升为 beta。
    • 将 WildFire 分析配置文件命令和服务器 TLS 策略命令提升为 GA。
    • 从 gcloud beta network-security firewall-endpoints wildfire-verdict-change-requests create 移除 --async 参数。
    • 将 Cloud Spanner Emulator 更新至 v1.5.59。
    • Cloud Bigtable:针对 CVE-2026-94439 使用 1.26.9 重新构建。
  5. 590.0.1

    展开

    OpenNavo 编辑 Homebrew 收录

    更新证书信任和随附组件,涉及 certifi、企业证书代理、App Engine Python、BigQuery、Cloud SQL Proxy 和 gsutil。

    certifi 更新至 2026.10.19,并从随附证书库移除不再受信任的 CA 根证书。enterprise-certificate-proxy 更新至 0.3.24、App Engine Python 至 1.9.119、Cloud SQL Proxy 至 2.26.3、gsutil 至 5.38。BigQuery 还从随附的 httplib2 中移除不再受信任的 AAA Certificate Services 根证书。Linux、Windows 和 Alpine Docker 镜像中的随附 Python 使用 grpcio 1.84.1 与 pip 26.2.2 重新构建,此项并非 macOS 改动。

    https://docs.cloud.google.com/sdk/docs/release-notes#59001_2026-10-22

  6. 590.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    移除已退役组件、更新安全依赖,并扩展数据库和 Kubernetes 命令。

    不兼容变更
    移除 gcloud-man-pages,命令文档改用 --help 查看。移除 app-engine-grpc 和 cloud-build-local 组件。
    安全
    更新内置 Python 的 pyOpenSSL 和 cryptography 依赖。重新构建 Cloud Bigtable 工具以修复 CVE-2026-39820。
    数据库
    Cloud SQL 实例命令新增 PostgreSQL 19 支持。内置 Cloud SQL Proxy 更新至 2.26.2。
    Kubernetes
    默认 kubectl 更新至 1.35.9。新增 reservedSystemCpus 和 Windows Server 2025 节点池选项。
    修复
    修复 Apigee 使用 mTLS 时的身份验证问题。修复 Dataplex 中 dbt 元数据导入失败的问题。

    移除已退役组件、更新安全依赖,并扩展数据库和 Kubernetes 命令。

    不兼容变更

    • 移除 gcloud-man-pages,命令文档改用 --help 查看。
    • 移除 app-engine-grpc 和 cloud-build-local 组件。

    安全

    • 更新内置 Python 的 pyOpenSSL 和 cryptography 依赖。
    • 重新构建 Cloud Bigtable 工具以修复 CVE-2026-39820。

    数据库

    • Cloud SQL 实例命令新增 PostgreSQL 19 支持。
    • 内置 Cloud SQL Proxy 更新至 2.26.2。

    Kubernetes

    • 默认 kubectl 更新至 1.35.9。
    • 新增 reservedSystemCpus 和 Windows Server 2025 节点池选项。

    修复

    • 修复 Apigee 使用 mTLS 时的身份验证问题。
    • 修复 Dataplex 中 dbt 元数据导入失败的问题。

    https://docs.cloud.google.com/sdk/docs/release-notes#59000_2026-10-20

  7. 589.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    弃用 Skaffold 组件,调整 Python、Alpine 镜像和存储上传校验默认行为,并更新多个云服务命令。请查看迁移提示与完整官方原文。

    Google Cloud CLI 589.0.0

    本地化摘要

    弃用 Skaffold 组件,调整 Python、Alpine 镜像和存储上传校验默认行为,并更新多个云服务命令。请查看迁移提示与完整官方原文。

    迁移与默认行为:Skaffold 组件将在 2027-01-15 之后的发行版中移除,部分安装请求已报错,请按官方链接独立安装。Alpine 镜像不再含系统 python3,改用捆绑 Python。Cloud Storage 可恢复上传默认启用服务端哈希校验。已弃用的 saas-runtime 命令组被隐藏,请改用 app-lifecycle-manager;beyondcorp app 被弃用;Compute disk-types list 的 NAME 和 --regexp 被弃用,请改用 --filter。beta device-run sessions submit xctest 被移除,alpha 仍可用。Cloud Composer 导出会跳过写入 --destination 之外的对象并警告。

    完整官方原文(未翻译)

    589.0.0 (2026-10-13)

    Breaking Changes
    • (Google Cloud CLI) Deprecated the skaffold component in Google Cloud CLI. The component will be removed from Google Cloud CLI releases after January 15, 2027. A portion of gcloud components install skaffold attempts now return an error. Please install Skaffold following the instructions at https://skaffold.dev/docs/install/.
    Google Cloud CLI
    • Updated Linux and Windows bundled Python to install cryptography 46.0.7 from the official PyPI wheels instead of custom builds.
    • Updated the Alpine-based Docker images (:alpine, :VERSION-alpine) to use a bundled Python and no longer include a system python3.
    • Updated bundled Python to 3.14.8 on Linux and Windows, and in the Alpine-based Docker images. This updates the OpenSSL that Python uses for TLS to 3.5.9.
    AlloyDB
    • Added --enable-express flag to gcloud beta alloydb clusters create|update.
    Apigee
    • Promoted gcloud apigee apis delete to GA. The command deletes an API proxy and all of its revisions. Every command in gcloud apigee apis now serves GA.
    • Fixed an issue where gcloud apigee apis import --from-template discarded a template's endpoints and targets whenever the template referenced a feature. A template that declared its own topology and used features only for policies compiled to a proxy with no ProxyEndpoint, and the import failed. A template's endpoints and targets now seed the proxy, and features are applied on top of them.
    App Engine
    • Fixed an issue where gcloud beta app migrate-to-run dropped the Serverless VPC Access connector for deployed versions.
    • Fixed an issue where gcloud beta app migrate-to-run mapped App Engine Flexible instance_ip_mode to Cloud Run ingress.
    • Fixed an issue where gcloud beta app migrate-to-run did not route all egress through Direct VPC for internal-only App Engine Flexible apps.
    App Lifecycle Manager
    • Hid the deprecated gcloud beta saas-runtime command group. Existing commands continue to work and print a deprecation warning. Use gcloud beta app-lifecycle-manager instead.
    Beyondcorp
    • Deprecated gcloud beta beyondcorp app command group.
    BigLake
    • Added --service-directory-name flag to gcloud biglake delta-sharing catalogs update.
    BigQuery
    • Added support for Azure Data Lake Storage URIs (abfs:// and abfss://) in inline external table definitions (--external_table_definition).
    • Added --dataplex_entry_group flag to bq mk --transfer_config and bq update --transfer_config to allow integration with Dataplex Entry Groups.
    • Added support to filter Transfer Configs by Dataplex Entry Group using --filter="metadata_destination.dataplex_configuration:*" for bq ls --transfer_config.
    Cloud Alerting
    • Promoted gcloud monitoring alerts command group to GA.
    Cloud Composer
    • Updated gcloud composer environments storage dags export, gcloud composer environments storage data export, gcloud composer environments storage plugins export, gcloud beta composer environments storage dags export, gcloud beta composer environments storage data export, and gcloud beta composer environments storage plugins export to skip, with a warning, objects that would be written outside of the local --destination directory.
    Cloud DNS
    • Added gcloud beta dns outbound-endpoints command group.
    • Added --outbound-endpoints flag to gcloud beta dns managed-zones and gcloud beta dns policies.
    Cloud Firestore
    • Promoted gcloud firestore change-streams commands to GA.
    Cloud Storage
    • Added server-side hash validation by default for resumable uploads in gcloud storage cp, gcloud storage mv, and gcloud storage rsync. To disable this behavior, run gcloud config set storage/enable_server_side_hash_validation False.
    Compute Engine
    • Optimized gcloud compute instance-groups managed list-instances by passing --limit and --page-size to the backend API and terminating page fetching early when the limit is reached.
    • Added CMEK_ENCRYPTION option to --local-ssd-encryption-mode flag of gcloud beta compute instances create to encrypt Local SSDs with customer-managed encryption keys.
    • Fixed gcloud beta compute disk-types list returning no results when --zones or --regions is specified. Deprecated NAME positional argument and --regexp flag of this command. Use --filter instead.
    • Promoted loadBalancingScheme value EXTERNAL_PASSTHROUGH to GA in import and export schemas for gcloud compute backend-services.
    • Promoted IPAddresses and loadBalancingScheme value EXTERNAL_PASSTHROUGH to GA in import and export schemas for gcloud compute forwarding-rules.
    • Promoted gcloud compute advice capacity to GA.
    • Promoted gcloud compute advice capacity-history to GA.
    Database Migration
    • Updated --ssl-flags flag documentation and parsing for gcloud database-migration connection-profiles commands to support custom delimiter syntax (^DELIM^) for values containing commas (e.g. server_certificate_dn).
    • Added --dbm-port flag to gcloud database-migration connection-profiles create sqlserver and gcloud database-migration connection-profiles update commands to specify the Database Mirroring (DBM) port for SQL Server Distributed Availability Group (DAG) migrations.
    • Added --sqlserver-dag-source-ag and --sqlserver-dag-linked-server flags to gcloud database-migration migration-jobs create and gcloud database-migration migration-jobs update commands to configure SQL Server Distributed Availability Group (DAG) migrations.
    Device Run
    • Removed gcloud beta device-run sessions submit xctest. The command remains available in the alpha release track.
    GKE Hub
    • Added --prioritized flag to gcloud beta container fleet rolloutsequences upgrade and gcloud beta container hub rolloutsequences upgrade.
    Kubernetes Engine
    • Added --wiz-sensor-api-key-secret-uri, --wiz-sensor-proxy-secret-uri, and --wiz-sensor-registry-secret-uri flags to gcloud container clusters create, create-auto, and update commands to configure Wiz Sensor.
    Looker
    • Fixed gcloud looker instances update --linked-lsp-project-number sending an empty update mask and failing.
    Oracle Database
    • Added update command to the following gcloud oracle-database command groups to support adding, updating, removing, and clearing labels using --update-labels, --remove-labels, and --clear-labels flags:
      • gcloud oracle-database cloud-exadata-infrastructures update
      • gcloud oracle-database cloud-vm-clusters update
      • gcloud oracle-database db-systems update
      • gcloud oracle-database exascale-db-storage-vaults update
      • gcloud oracle-database goldengate-connections update
      • gcloud oracle-database goldengate-connection-assignments update
      • gcloud oracle-database goldengate-deployments update
      • gcloud oracle-database odb-networks odb-subnets update
    Workbench
    • Fixed --nic-type flag choices in gcloud workbench instances create to use VIRTIO_NET instead of VIRTIGO_NET.

    Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

    Sources

  8. 588.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    移除 Managed Flink Client,并更新 API 工具、IAM 和 Kubernetes 组件。

    亮点
    移除了 managed-flink-client 组件。Apigee API 导入现已正式发布(GA);相关修复可改进由模板生成的代理。BigLake Hive 的目录、数据库和表命令现已正式发布(GA)。Cloud SQL Proxy 已更新至 2.26.0;默认 kubectl 已更新至 1.35.9。

    移除 Managed Flink Client,并更新 API 工具、IAM 和 Kubernetes 组件。

    • 移除了 managed-flink-client 组件。
    • Apigee API 导入现已正式发布;相关修复改进了模板生成的代理。
    • BigLake Hive 目录、数据库和表命令现已正式发布。
    • Cloud SQL Proxy 更新至 2.26.0;默认 kubectl 更新至 1.35.9。

    精选亮点。完整官方变更: https://docs.cloud.google.com/sdk/docs/release-notes#58800_2026-10-06

  9. 587.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    新增对 Python 3.15 的支持,并扩展 Cloud Run 和 Cloud Tasks 工具。

    亮点
    新增对 Python 3.15 的支持。移除 Anywhere Cache 暂停功能和已弃用的 Edge Cloud VPN 命令。Cloud Run 在 beta 版中新增服务和实例 SSH 命令。Cloud Tasks 在 alpha/beta 版中新增批量创建和批量删除选项。

    新增对 Python 3.15 的支持,并扩展 Cloud Run 和 Cloud Tasks 工具。

    • 新增对 Python 3.15 的支持。
    • 移除 Anywhere Cache 暂停功能和已弃用的 Edge Cloud VPN 命令。
    • Cloud Run 在 beta 版中新增服务和实例 SSH 命令。
    • Cloud Tasks 在 alpha/beta 版中新增批量创建和批量删除选项。

    精选亮点。完整官方更新: https://docs.cloud.google.com/sdk/docs/release-notes#58700_2026-09-29

  10. 586.0.0

    展开

    OpenNavo 编辑 Homebrew 收录

    移除捆绑的 Kustomize 和 kpt,并提供迁移通知和 API 密钥限制。

    亮点
    移除捆绑的 Kustomize 和 kpt;请使用它们的上游安装。宣布移除 google-cloud-sdk Snap;请迁移到 google-cloud-cli。弃用 gcloud-man-pages,并将在 590.0.0 中移除;请使用 --help。创建和更新 API 密钥需要 API 目标限制。

    移除内置的 Kustomize 和 kpt,并附有迁移通知和 API 密钥限制。

    • 移除内置的 Kustomize 和 kpt;请使用其上游安装。
    • 宣布移除 google-cloud-sdk Snap;请迁移到 google-cloud-cli。
    • 弃用 gcloud-man-pages,将在 590.0.0 中移除;请使用 --help。
    • API 密钥的创建和更新需要 API 目标限制。

    精选亮点。完整官方变更: https://docs.cloud.google.com/sdk/docs/release-notes#58600_2026-09-22

  11. 585.0.0
  12. 584.0.0
  13. 583.0.0
  14. 582.0.0
  15. 581.0.0
  16. 580.0.0
  17. 579.0.0
  18. 578.0.0
  19. 577.0.0
  20. 576.0.0
  21. 575.0.1
  22. 575.0.0
  23. 574.0.0
  24. 573.0.0