Civo CLI

概览

GitHubGitHub

Civo CLI 是一个用 Go 编写的命令行工具，用于在终端中管理 Civo.com 账户及其资源。虽然 Civo 提供了 Web 控制面板，但当用户需要自动化操作、运行脚本或管理多个复杂服务时，CLI 是更合适的选择。 ### 主要能力 Civo CLI 支持管理的资源类型包括： - **计算与存储**：Instances（实例）、Volumes（卷）、Disk Images（磁盘镜像）、Resource Snapshots（资源快照） - **Kubernetes**：Kubernetes clusters（集群）、Kubernetes applications（应用） - **网络与安全**：Networks（网络）、Firewalls（防火墙）、Load Balancers（负载均衡器）、Domains and Domain Records（域名及记录） - **其他资源**：Object Stores（对象存储）、Database Backup and Restore（数据库备份与恢复）、SSH Keys、Teams、Permissions、Quota、Sizes、Region 等 ### 安装方式 该工具以二进制文件形式分发，支持多种操作系统： - **macOS**：通过 Homebrew 安装，或使用 curl 脚本安装 - **Windows**：通过 Chocolatey 或 Scoop 安装 - **Linux**：通过 curl 脚本、Homebrew、wget 下载二进制文件，或从源码编译 - **Docker**：提供 Docker 镜像 `civo/cli:latest`，镜像内包含 kubectl，可通过挂载配置文件使用 ### 认证与配置 使用前需要通过 API Key 进行认证。API Key 可在 Civo 网站获取，通过 `civo apikey add` 命令添加到 CLI 中。支持存储多个 API Key 以管理不同账户，并通过 `civo apikey current` 切换默认 Key。此外，支持通过全局环境变量 `CIVO_TOKEN` 传入 Token，适用于脚本和 CI/CD 场景。 ### 全局选项 CLI 提供多项全局参数，包括指定配置文件路径（`--config`）、输出格式（`-o`，支持 json/human/custom）、自定义输出字段（`-f`）、指定区域（`--region`）、JSON 美化输出（`--pretty`）以及自动确认提示（`-y`）。 ### 更新机制 CLI 每 24 小时会提醒用户检查更新，遇到错误时也会提示更新版本。可通过 `civo update` 命令升级到最新版本。 该项目采用 Apache-2.0 协议开源，目前处于活跃开发和维护状态。

Q&A

如何在 macOS 上安装 Civo CLI？由 AI 生成

可以通过 Homebrew 安装，执行 `brew tap civo/tools` 然后 `brew install civo`；或者直接运行 `curl -sL https://civo.com/get | sh`。

如何在 Windows 上安装 Civo CLI？由 AI 生成

可以通过 Chocolatey 执行 `choco install civo-cli` 安装，或者通过 Scoop 先添加 extras bucket 再执行 `scoop install civo` 安装。

如何配置 API Key？由 AI 生成

使用 `civo apikey add <名称> <密钥>` 添加 API Key。如果有多个 Key，使用 `civo apikey current <名称>` 设置默认使用的 Key。也可以通过设置 `CIVO_TOKEN` 环境变量来认证。

如何使用 Docker 运行 Civo CLI？由 AI 生成

先创建配置文件 `touch $HOME/.civo.json`，然后运行 `docker run -it --rm -v $HOME/.civo.json:/.civo.json civo/cli:latest`。建议设置 alias 简化命令。

如何更新 Civo CLI 到最新版本？由 AI 生成

运行 `civo update` 命令即可将 CLI 更新到最新版本。CLI 也会每 24 小时自动提醒用户更新。

Civo CLI 支持哪些输出格式？由 AI 生成

通过 `-o` 或 `--output` 参数指定，支持 json、human（默认）和 custom 三种格式。还可以使用 `--pretty` 美化 JSON 输出，或用 `-f` 指定自定义输出字段。