SuperAPI AI 工具集

hcloud-setup

部署与运维

查看项目

更新于 10-15 20:32

技能介绍

用途:该技能面向需要安装、配置或初始化 hcloud CLI 的场景,包括管理上下文与 API 令牌、设置默认配置项、启用 shell 补全等。

安装方式:可从 GitHub Releases 下载预编译二进制,或使用 Go(go install github.com/hetznercloud/cli/cmd/hcloud@latest)、Homebrew(brew install hcloud)、WinGet(winget install HetznerCloud.CLI)、Scoop(scoop install hcloud)以及 Docker(docker run --rm -e HCLOUD_TOKEN="<token>" hetznercloud/cli:latest <command>)。资料指出基于 apt 的 Debian 系发行版提供的版本过旧,建议改用其他方式;WinGet 与 Scoop 条目并非由 Hetzner 维护。

上下文管理:使用 hcloud context create <name> 创建上下文(加 --token-from-env 则从 HCLOUD_TOKEN 读取),可切换、查看、列出、删除、重命名及取消激活上下文。

配置管理:配置文件位于 ~/.config/hcloud/cli.toml,优先级依次为命令行标志、环境变量、上下文配置、全局配置、默认值。支持 hcloud config set/get/list/add/remove/unset,并可用 --global、--allow-sensitive 等标志。偏好键包括 debug、default-ssh-keys、endpoint、poll-interval、quiet、sort.<resource> 等;token、context、config 为只读键,可通过 config get/list 读取但不能用 set/unset 修改。

Shell 补全:支持 Bash、Zsh、Fish、PowerShell,通过 hcloud completion <shell> 生成并加载。

输出与命令:list/describe/create 支持 JSON 与 YAML 输出,describe 另支持 Go 模板格式,list 支持表头与列选择选项;另有 hcloud version 与 hcloud all list(可加 --paid、--selector)等命令。

限制:资料未提供收费、平台支持范围、性能或效果方面的说明;Docker 持久化配置需挂载 cli.toml;Go 构建的二进制不会嵌入正确版本信息。