+86 189 8218 1436 周一至五 10:00-22:00

使用 Google Cloud SDK 和命令行工具实战

TL;DR:面向小白讲清使用 Google Cloud SDK 和命令行工具能做什么,从安装、登录、建 VM 到日常运维,并给出避坑建议。

它是什么

Google Cloud SDK 是管理 GCP 资源的官方工具包,说人话就是「把控制台装进终端」。核心命令是 gcloud,常配合 gsutil(对象存储 Cloud Storage)、bq(BigQuery 等大数据/分析工具)这类配套命令行工具使用。第一次使用 Google Cloud SDK 和命令行工具,先别创建资源,复制下面这段只读命令,确认工具在不在:

gcloud --version
gsutil version
bq version

为什么先这么做?因为这三条只打印版本,不会创建资源,也不会产生费用。能输出版本号,说明终端找得到命令;如果某条提示 command not found,多半是 SDK 没装、组件没装全,或安装后没重开终端导致 PATH 没生效,先别慌,更不要立刻改项目配置。

它最大的价值,是把网页控制台里靠鼠标点的操作,变成可复制、可复用、可写进脚本的命令。比如在控制台里看项目、看虚拟机列表,在终端里可以这样查:

gcloud config list
gcloud projects list
gcloud compute instances list --format="table(name,zone,status)"

这些也是只读命令,适合第一次跟做:第一条看当前配置,第二条看账号能访问哪些项目,第三条看当前项目里的 VM 名称和状态。以后同一段命令可以发给同事、放进部署脚本,或每天定时检查,不用每次截图教别人点哪里。

另一个好处是调用方式统一:在 Linux 服务器、本地电脑或跳板机里,只要装好并登录,都是敲同一套 gcloud 命令;通过 SSH 登录 VM 做运维前,可以先确认「我是谁、在哪个项目」:

gcloud auth list
gcloud config get-value project

这样再衔接查日志、重启服务、发布脚本等 VM 流程,就不容易把操作打到错误项目里。

  • 小白常踩坑:没登录会要求认证;登录错 Google 账号、项目选错、权限不足或 Compute API 未启用,都可能导致列表为空或报错,不等于命令写错。
  • 安全坑:跳板机若多人共用,不要随便保存个人凭证,也不要把账号、密钥写进脚本;生产环境先只跑只读命令,创建、删除、开通计费的命令要看清项目再执行。

解决什么问题

使用 Google Cloud SDK 和命令行工具,最先解决的是“重复点控制台”的问题。批量创建 VM、开关防火墙、查看日志、配置权限时,命令比反复点击更省时间:三台机器还能手动点,三十台就很累,还容易漏填一个选项。命令把每一步写清楚,复制一次就能跑,结果也更好比较。

零基础最省事的做法,是打开 Google Cloud 控制台右上角的 Cloud Shell,它已经装好 SDK;本地装好 SDK 也可以。复制下面整段到终端执行,第一次会提示登录或选择项目,请选测试项目,别选生产项目。先初始化,是为了让后续命令知道“操作哪个项目”;启用服务,是为了让计算、日志和权限接口可用。

gcloud init

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
if [ "$PROJECT_ID" = "(unset)" ] || [ -z "$PROJECT_ID" ]; then
  echo "请先选择项目"
  exit 1
fi
ZONE="asia-east1-b"
gcloud services enable compute.googleapis.com logging.googleapis.com cloudresourcemanager.googleapis.com --project "$PROJECT_ID"

for NAME in demo-vm-1 demo-vm-2 demo-vm-3; do
  gcloud compute instances create "$NAME" 
    --project "$PROJECT_ID" 
    --zone "$ZONE" 
    --machine-type=e2-micro 
    --image-family=debian-12 
    --image-project=debian-cloud 
    --tags=demo-web
done

gcloud compute firewall-rules create demo-allow-http 
  --project "$PROJECT_ID" 
  --network=default 
  --allow=tcp:80 
  --target-tags=demo-web 
  --source-ranges=0.0.0.0/0

gcloud logging read 'resource.type="gce_instance"' 
  --project "$PROJECT_ID" 
  --freshness=1d 
  --limit=10 
  --format="table(timestamp,resource.labels.instance_id,textPayload)"

gcloud projects get-iam-policy "$PROJECT_ID" 
  --format="table(bindings.role,bindings.members)"

gcloud projects add-iam-policy-binding "$PROJECT_ID" 
  --member="user:$(gcloud config get-value account)" 
  --role="roles/compute.viewer"

gcloud compute firewall-rules delete demo-allow-http --project "$PROJECT_ID" --quiet
for NAME in demo-vm-1 demo-vm-2 demo-vm-3; do
  gcloud compute instances delete "$NAME" --project "$PROJECT_ID" --zone "$ZONE" --quiet
done

这段命令用循环一次创建三台小 VM;新增一条只开放 80 端口的防火墙规则,最后再删除;读取最近的虚拟机日志;查看权限,并给当前登录账号加一个只读角色;末尾清理 VM。为什么要清理?因为 VM 存在就可能计费,端口长期开放也会扩大暴露面。

  • 常见坑:没选项目、没有权限或配额不足都会报错;先确认项目,再找管理员确认授权,别自己乱加 Owner。
  • 常见坑:示例里的全网来源只适合临时演示;这里“开关防火墙”是增删一条规则,不是关掉整个网络保护。
  • 常见坑:刚建好的 VM 日志可能很少,这是正常的;临时排障时重点看时间戳、实例编号和错误信息。
  • 常见坑:示例资源名固定,重复运行可能提示已存在;如果中途中断,先让末尾清理跑完,或换干净测试项目。

把操作写进脚本后,测试环境和生产环境更容易保持一致,只改项目配置就能复用;同事接手时也能从脚本看出做过什么,方便复盘和交接。它适合自动化部署、临时排障、权限核查和多项目巡检等场景:人只判断结果,重复动作交给命令行工具完成。

怎么上手

第一次一定先在测试项目里练手,别直接连生产 VM。使用 Google Cloud SDK 和命令行工具时,本地会记住“默认项目”,后面很多命令不写项目名也会按它执行;项目选错,轻则查不到机器,重则连错环境。

  1. 先安装 SDK。macOS/Linux 打开终端,复制下面两行;安装时若询问是否修改 PATH,输入 y。Windows 请下载官方安装器,安装时勾选 Add gcloud to PATH,再打开新的 PowerShell。这样做是为了让终端知道去哪里找命令。

    curl https://sdk.cloud.google.com | bash
    exec -l "$SHELL"
  2. 确认系统路径已生效。macOS/Linux 复制第一段,Windows PowerShell 复制第二段;能看到命令信息或路径,并显示版本号就算成功。常见坑是装完没重开终端,或安装时没同意修改 PATH,这时会提示“找不到命令”。

    command -v gcloud
    gcloud --version
    Get-Command gcloud
    gcloud --version
  3. 初始化并选默认项目。下面命令会打开浏览器登录,让你选择配置和项目;第一次请选择测试项目。公司账号登录成功也不代表有项目权限,若列表里没有测试项目,先找管理员开权限。

    gcloud init
  4. 之后换账号、登录过期,执行下面这段;前一行负责换账号或重新登录,后一行负责检查配置,重点看 account、project、region、zone。注意登录只换凭证,不一定换项目;项目不对就回到上一步重新初始化。没看到区域说明没设默认区域,连接时显式带可用区即可。

    gcloud auth login
    gcloud config list
  5. 先列出 VM,看 NAME、ZONE、STATUS。列表为空通常不是命令坏,而是项目选错、权限不足、Compute Engine API 未启用或机器没开机;若提示 API 未启用,在测试项目执行启用命令后重试。

    gcloud compute instances list
    gcloud services enable compute.googleapis.com
  6. 最后连接实例。macOS/Linux 复制第一段,Windows PowerShell 复制第二段;它们会连接列表中的第一台 VM,所以第一次建议在测试项目只放一台测试机。若有多台,先确认第一台不是生产机;列表为空时不要执行,否则变量为空会报错。第一次还会生成密钥并询问是否信任主机,按提示确认;卡住多半是防火墙或权限。

    VM_NAME=$(gcloud compute instances list --format="value(name)" | head -n 1)
    VM_ZONE=$(gcloud compute instances list --format="value(zone.basename())" | head -n 1)
    gcloud compute ssh "$VM_NAME" --zone "$VM_ZONE"
    $VM_NAME = (gcloud compute instances list --format="value(name)" | Select-Object -First 1)
    $VM_ZONE = (gcloud compute instances list --format="value(zone.basename())" | Select-Object -First 1)
    gcloud compute ssh $VM_NAME --zone $VM_ZONE

与替代方案对比

以「看项目里有哪些虚拟机」为例。网页控制台最直观,点几下就见名称、区域、状态,适合初次认识和少量改动(只改一两台、加个标签)。坑是步骤记在脑子里:换人、隔天再点容易漏勾选项,也难复现。

命令行相反。使用 Google Cloud SDK 和命令行工具,动作变成可复制的文字,适合批量、重复、可自动化(定时任务或 CI)。首次在本地终端或 Cloud Shell 复制下面这组;第二条会开浏览器登录并让选项目,按提示走:

gcloud --version
gcloud init
gcloud config list
gcloud compute instances list --format="table(name,zone,status)"
gcloud compute instances list --format="csv[no-heading](name,zone,status)" --filter="status=RUNNING"

先初始化,是因为 Google Cloud SDK 封装了认证、项目和常用参数:配置存到本地后,列表命令不用贴令牌、不用每次写项目参数,格式和过滤也统一。坑:公司电脑可能已有默认配置,先看第三条输出的 account、project,别把生产项目覆盖成练习项目;若列表提示 Compute API 未启用,先去控制台启用,不是命令错。CSV 那条去掉表头,给脚本直接读,别只盯屏幕抄。

直接调 REST 接口或写脚本更灵活,但门槛高:令牌、项目路径、分页、重试、401/404 都得自己兜。下面这条能跑,可括号里又借了 SDK 拿令牌和项目 ID;别把令牌打进日志或聊天里。

curl -sS -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://compute.googleapis.com/compute/v1/projects/$(gcloud config get-value project)/aggregated/instances"
  • Terraform、Ansible、CI 适合复杂编排:一次管网络、防火墙、实例、权限的依赖。
  • 但 success、state 不等于云端真实状态:手改控制台、state 没刷新、apply 中断都会对不上。
  • 排障仍要掌握 gcloud,重跑上面列表命令核对名字、zone、status;先认事实,再改编排代码。

最佳实践

使用 Google Cloud SDK 和命令行工具时,先把“少给权限、少留密钥、先备份再动手”当成习惯。原因很简单:命令行没有二次确认,项目选错或权限过大,一条命令就可能删错资源、开错防火墙。

常见问题(FAQ)

不会 Linux 也能学会吗?

可以,先记登录、查看、连接三类命令,再逐步学脚本和权限。

gcloud 和 Google Cloud SDK 是什么关系?

Google Cloud SDK 是工具包,gcloud 是其中最常用的主命令。

命令行会覆盖控制台里的设置吗?

会操作同一批资源,建议先用只读命令核对,再执行变更命令。

生产环境最怕哪类误操作?

最怕选错项目、区域或账号,执行前务必确认当前配置并保留回滚方案。

不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。

查看代维服务 →

发表评论