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 key 檔啟用 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=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

為持久磁碟建立 snapshot 以備份或複製。

--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

列出 bucket／物件（別名：`gcloud storage ls`）。

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

上傳或複製物件。`-r` 用於遞迴複製目錄。

-r；-m 平行；-c 保留 cache-control；-p 保留 ACL；-n 不覆寫；-z <fmt> 上傳時壓縮

雙向目錄同步（平行、快速）。來源／目的地可以是本地或 `gs://`。

-r；-d 刪除多餘項目；-c 以校驗碼比對；-n 試跑；-x 排除

建立新的 Cloud Storage bucket，可指定 location／class。

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

對 BigQuery 執行臨時 SQL 查詢。

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

顯示專案／資料集／資料表／工作的 metadata。

--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 standard／flex。

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

發布單一訊息——適合臨時測試。

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

從 subscription 拉取（並自動 ack）N 條訊息——健全性檢查很實用。

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

把 gcloud 本身與所有已安裝 component 更新到最新版本。

安裝可選的 gcloud component（kubectl、bq、gsutil、app-engine-python 等）。

<name>

印出 gcloud 環境：python 版本、安裝位置、當前設定。

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

在瀏覽器中開啟公開的 gcloud issue tracker，並預先填入環境資訊。

--log-level=debug