gcloud

打印 gcloud、gsutil、bq 及核心库的版本。

顶层帮助，展示完整的命令分组列表。

展示任意 gcloud 命令的参数与示例（路径分隔符为空格）。

阅读深入的文档：`configurations`、`projections`、`filters`、`offline` 等。

configurations；projections；filters；offline；access-control

首次运行向导——登录、选择项目、选择默认 region / zone。

授权 gcloud 使用你的用户凭据访问 GCP（浏览器 OAuth 流程）。

--no-launch-browser；--no-activate

设置 Application Default Credentials——供客户端库（Python / Node / Go）使用。

--scopes <scope1,scope2>；--no-launch-browser

使用下载的 JSON 密钥文件激活 service account。

列出所有已认证的账户。

--format=yaml；--filter

撤销一个或所有账户的凭据。

<account>；--all

打印当前激活的项目。

设置激活的项目。

列出你有权限访问的所有项目。

--format='table(projectId,name,projectNumber)'；--limit

列出所有保存的配置（具名 profile）。

--format=yaml

创建一个新的具名配置。

--no-activate

切换到一个已存在的配置。

在不修改持久配置的情况下使用某个配置（CI / 脚本）。

按属性设置默认值（region / zone / project / account）。

compute/region；compute/zone；container/cluster；compute/region us-central1

选择输出格式：`json`、`yaml`、`table`、`csv`、`value`、`default`。

json；yaml；table；csv；value；default；get(<expr>):label

服务端过滤——表达式语法见 `gcloud topic filters`。

name=foo；zone:us-*；status:RUNNING

限制结果数（其他情况下服务端分页无上限）。

列出当前项目中的所有 service account。

--project；--format=json；--limit

为 service account 创建一个 JSON key——供不支持 ADC 的工具使用。

--iam-account <sa>；--key-file-type json

在项目级授予某个 member 一个角色。

--member=user:foo@bar / serviceAccount:foo / group:bar / domain:bar；--role=roles/owner

列出所有 VM 及其 zone、机器规格、状态。

--project；--filter；--format=table；--limit

使用默认镜像（Debian 12）创建一个 VM。

--zone；--machine-type；--image-family；--image-project；--preemptible；--tags；--labels；--metadata；--service-account；--scopes

打开到 VM 的 SSH 会话（自动生成 / 保存密钥到 `~/.ssh/google_compute_engine`）。

--zone；--ssh-key-file；--command <cmd>；--tunnel-through-iap；--internal-ip

删除一台 VM（可选是否同时删除磁盘）。

--zone；--delete-disks=all / data / boot

列出所有持久磁盘。

--filter='zone:us-*'；--format=table

为持久磁盘创建快照，用于备份或克隆。

--source-disk <name>；--source-disk-zone；--description

列出所有 GKE 集群。

--region；--format=table；--limit

把集群的 kubeconfig 合并到 `~/.kube/config` 并切换 context。

--region；--zone；--project；--internal-ip

创建一个 Autopilot 或 Standard GKE 集群。

--num-nodes；--machine-type；--region；--enable-autoscaling；--enable-autorepair；--cluster-version；--release-channel rapid|regular|stable

列出桶 / 对象（别名：`gcloud storage ls`）。

-r；-l；-h；gs://；-d（只列目录）

上传或复制对象。`-r` 表示递归复制目录。

-r；-m 并行；-c 保留 cache-control；-p 保留 ACL；-n no-clobber；-z <fmt> 上传时压缩

双向目录同步（并行、快速）。源 / 目标可以是本地或 `gs://`。

-r；-d 删除多余项；-c checksum 比较；-n 演练；-x 排除

创建一个 Cloud Storage 桶，可指定 location / 类。

--location；--default-storage-class；--uniform-bucket-level-access；--public-access-prevention

对 BigQuery 运行一条即席 SQL 查询。

--use_legacy_sql=false；--max_rows；--destination_table；--parameter；--format=json

显示某个 project / dataset / table / job 的元数据。

--format=pretty；--schema；--view

将本地 CSV/JSON/Parquet 文件批量加载到 BigQuery 表。

--source_format=CSV|JSON|PARQUET|AVRO|NEWLINE_DELIMITED_JSON；--autodetect；--replace；--skip_leading_rows=1

用默认 Cloud Build 配置从当前目录构建一个容器。

--tag；--config <file>；--machine-type；--timeout；--gcs-source-staging-dir；--no-source-image-upload

部署到 App Engine 标准 / 弹性环境。

--image-url；--version；--promote；--stop-previous-version

发布单条消息——适合临时测试。

--message；--attributes；--ordering-key

从一个订阅拉取（并自动 ack）N 条消息——适合做健全性检查。

--limit；--auto-ack；--format=json

把 gcloud 自身以及所有已安装组件更新到最新版本。

安装一个可选 gcloud 组件（kubectl、bq、gsutil、app-engine-python 等）。

<name>

打印 gcloud 环境：python 版本、安装位置、激活的配置。

--run-diagnostics；--log-level=debug

打开浏览器进入公共 gcloud issue tracker，环境信息会自动预填。

--log-level=debug