Back to Details

gcloud-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Cloud CLI Skill

Google Cloud CLI 技能

Installation

安装

The skill invokes the 
gcloud
CLI. Install and initialize:
  • Linux/macOS: 
    curl https://sdk.cloud.google.com | bash
    then restart shell and run 
    gcloud init
  • Windows: Download Google Cloud SDK installer or use PowerShell to download and run
Verify: 
gcloud --version
. Configure: 
gcloud init
本技能调用 
gcloud
CLI，安装并初始化步骤：
  • Linux/macOS: 执行 
    curl https://sdk.cloud.google.com | bash
    ，随后重启 shell 并运行 
    gcloud init
  • Windows: 下载 Google Cloud SDK 安装程序 或使用 PowerShell 下载运行
验证命令：
gcloud --version
，配置命令：
gcloud init

Cheat Sheet & Best Practices

速查表与最佳实践

Config: 
gcloud config set project <id>
; 
gcloud config list
; 
gcloud config configurations create/activate <name>
— switch projects.
Auth: 
gcloud auth login
; use 
--impersonate-service-account
for SA; 
--access-token-file
for CI.
Hacks: Use 
--format="table(name,zone,status)"
or 
--format=json
+ jq to cut output. Use 
--flags-file=file.yaml
for long or repeated flags. Use named configurations for dev/staging/prod. Run 
gcloud components update
periodically.
配置: 
gcloud config set project <id>
; 
gcloud config list
; 
gcloud config configurations create/activate <name>
— 切换项目。
认证: 
gcloud auth login
；服务账户认证使用 
--impersonate-service-account
参数；CI 场景使用 
--access-token-file
参数。
实用技巧: 使用 
--format="table(name,zone,status)"
或 
--format=json
+ jq 裁剪输出内容；长参数或重复参数可使用 
--flags-file=file.yaml
读取；为开发/测试/生产环境配置命名配置项；定期执行 
gcloud components update
更新组件。

Certifications & Training

认证与培训

Free: Google Cloud Learn and Google Skills — Innovators Program (35 credits/month). Certs: Cloud Digital Leader, Cloud Engineer (associate), Cloud Architect/DevOps (professional). Skill data: Config, auth, compute/storage/IAM; no exposed service-account keys.
免费资源: Google Cloud Learn 和 Google Skills — 创新者计划（每月35积分）。认证: 云数字领导者、云工程师（助理级）、云架构师/DevOps（专业级）。技能数据: 配置、认证、计算/存储/IAM；不暴露服务账户密钥。

Hooks & Workflows

钩子与工作流

Suggested hooks: Pre-deploy: 
gcloud config get-value project
. Use when devops is routed for GCP tasks (contextual: 
gcp_project
).
Workflows: Use with devops (contextual: 
gcp_project
). Flow: detect GCP → load gcloud-cli → run CLI via skill script.
建议钩子: 部署前执行 
gcloud config get-value project
。当 devops 路由到 GCP 任务时使用（上下文参数：
gcp_project
）。
工作流: 配合 devops 使用（上下文参数：
gcp_project
）。流程：检测到 GCP → 加载 gcloud-cli → 通过技能脚本运行 CLI 命令。

Overview

概述

Google Cloud Platform CLI operations. 90%+ context savings.
Google Cloud Platform CLI 操作能力，可节省90%以上的上下文处理时间。

Requirements

要求

  • gcloud CLI installed
  • GOOGLE_PROJECT_ID environment variable
  • Authenticated via gcloud auth
  • 已安装 gcloud CLI
  • 配置 GOOGLE_PROJECT_ID 环境变量
  • 已通过 gcloud auth 完成认证

Tools (Progressive Disclosure)

工具（渐进式披露）

Compute

计算

ToolDescriptionConfirmation
instances-listList VM instancesNo
instances-createCreate VMYes
instances-deleteDelete VMREQUIRED
工具名称描述需确认
instances-list列出 VM 实例否
instances-create创建 VM是
instances-delete删除 VM必填

Storage

存储

ToolDescriptionConfirmation
storage-lsList buckets/objectsNo
storage-cpCopy objectsYes
storage-rmDelete objectsYes
工具名称描述需确认
storage-ls列出存储桶/对象否
storage-cp复制对象是
storage-rm删除对象是

IAM

IAM

ToolDescription
iam-listList IAM policies
service-accountsList service accounts
工具名称描述
iam-list列出 IAM 策略
service-accounts列出服务账户

Logging

日志

ToolDescription
logs-readRead logs
logs-tailTail logs in real-time
工具名称描述
logs-read读取日志
logs-tail实时追踪日志

BLOCKED

已封禁

ToolStatus
projects deleteBLOCKED
iam-policy deleteBLOCKED
工具名称状态
projects delete已封禁
iam-policy delete已封禁

Agent Integration

Agent 集成

  • devops (primary): Cloud operations
  • gcp-cloud-agent (primary): GCP specific
  • cloud-integrator (secondary): Multi-cloud
  • devops（主要）：云操作
  • gcp-cloud-agent（主要）：GCP 专属场景
  • cloud-integrator（次要）：多云场景

Security

安全

⚠️ Never expose service account keys ⚠️ Resource deletion requires confirmation
⚠️ 永远不要暴露服务账户密钥 ⚠️ 资源删除操作需要确认

Memory Protocol (MANDATORY)

内存协议（强制要求）

Before starting: Read 
.claude/context/memory/learnings.md
After completing:
  • New pattern -> 
    .claude/context/memory/learnings.md
  • Issue found -> 
    .claude/context/memory/issues.md
  • Decision made -> 
    .claude/context/memory/decisions.md
ASSUME INTERRUPTION: If it's not in memory, it didn't happen.
开始前： 读取 
.claude/context/memory/learnings.md
完成后：
  • 新的使用模式 → 写入 
    .claude/context/memory/learnings.md
  • 发现问题 → 写入 
    .claude/context/memory/issues.md
  • 做出决策 → 写入 
    .claude/context/memory/decisions.md
假设存在中断风险：未写入内存的内容等同于未发生。