doctl

DigitalOcean 命令行客户端

补充说明

doctl 管理 DigitalOcean 的 Droplet、Kubernetes、数据库、App Platform 等资源。它使用 API token 认证，支持多 context 和 JSON 输出。

常用示例

doctl auth init
doctl auth list
doctl account get
doctl compute droplet list
doctl compute droplet create web \
  --image ubuntu-24-04 --size s-1vcpu-1gb --region sgp1
doctl compute droplet delete <droplet-id>
doctl kubernetes cluster list
doctl kubernetes cluster kubeconfig save my-cluster
doctl databases list
doctl apps list
doctl compute region list
doctl compute size list

易错点与排错

• token 权限不足时列表可能为空或操作被拒；按最小权限创建专用 token。
• 多 context 时先 doctl auth list；操作错账号的代价很高。
• --size、--region、--image 都是 slug；用 list 命令查可用值。
• 删除 Droplet 会连带删除其本地磁盘数据；先做快照或备份。
• kubeconfig save 会合并到现有配置；冲突时确认 context 名称。
• API 有速率限制；批量操作要加退避和重试。
• 计费按小时/月计算；创建前确认规格和区域价格。
• 默认输出适合人看；脚本用 --output json 并固定字段。

相关命令

• hcloud — Hetzner Cloud CLI
• kubectl — Kubernetes 集群操作
• terraform — 声明式管理资源