mcpField
U
using-cloud-cli

using-cloud-cli

github.com/julianobarbosa云与 DevOps14107 次安装2 天前更新
代码仓库

关于 using-cloud-cli

using-cloud-cli 是使用云平台命令行工具的操作指南，面向执行 BigQuery、GCP 和 AWS 任务的用户。它提供常用命令模式，并强调凭证检查、查询成本估算和参数差异。

主要功能

  1. 01BigQuery 查询与成本预估
  2. 02gcloud 资源查询示例
  3. 03AWS 资源查询与筛选
  4. 04凭证与身份验证排查
  5. 05CLI 版本和参数提示

适用场景

  1. 01运行查询前估算 BigQuery 扫描费用
  2. 02列出或描述 GCP 计算资源
  3. 03使用 AWS CLI 检查云资源
  4. 04排查 CI 中的凭证权限错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill using-cloud-cli

安装后在 Claude Code 中输入/using-cloud-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

AWS.md
GCP.md
scripts/
bq-cost-check.sh

详细介绍

云 CLI 模式

凭据已预先配置。使用 --help 或 Context7 查看语法。

BigQuery

# Always estimate cost first
bq query --dry_run --use_legacy_sql=false 'SELECT ...'

# Run query
bq query --use_legacy_sql=false --format=json 'SELECT ...'

# List tables
bq ls project:dataset

# Get table schema
bq show --schema --format=json project:dataset.table

注意成本：按扫描的字节数计费。使用 --dry_run、分区表，并指定列。

GCP（gcloud）

# List resources
gcloud compute instances list --format=json

# Describe resource
gcloud compute instances describe INSTANCE --zone=ZONE --format=json

# Create with explicit project
gcloud compute instances create NAME --project=PROJECT --zone=ZONE

# Use --quiet for automation
gcloud compute instances delete NAME --quiet

AWS

# List resources
aws ec2 describe-instances --output json

# With JMESPath filtering
aws ec2 describe-instances --query 'Reservations[].Instances[].InstanceId' --output text

# Explicit region
aws s3 ls s3://bucket --region us-west-2

# Dry run where available
aws ec2 run-instances --dry-run ...

参考

  • GCP.md - GCP 服务模式和常用命令
  • AWS.md - AWS 服务模式和常用命令
  • scripts/ - 常见操作的辅助脚本

注意事项

  • gcloud auth login 和 gcloud auth application-default login 使用的是不同的凭据 — 脚本在用户环境中运行正常，却可能在 CI 中返回 401，因为 CI 只有后者。
  • AWS CLI v1 和 v2 的配置格式不同 — 两者可能都已安装；aws --version 可显示默认 aws 二进制文件的版本。
  • 估算 BigQuery 成本需要使用 --dry_run — 否则你可能以为查询免费，结果却运行了一个花费 100 美元的查询。务必先估算。
  • 优先级：AWS_PROFILE、--profile 标志和直接设置的 AWS_ACCESS_KEY_ID 环境变量之间存在三方优先级关系，具体顺序取决于配置，且很少有文档说明。
  • 通过 --impersonate-service-account 设置的 gcloud 身份模拟链中，每一跳都需要 IAM token-creator 权限 — 缺少任意一跳都会返回 403，并显示含糊的“permission denied”。
  • aws sts get-caller-identity 是验证当前实际使用凭据最省成本的方式 — 务必先检查。

评论

支持 Markdown