阿里云云效 DevOps 平台的现代化极速命令行工具
特性 • 安装 • 快速开始 • 命令列表 • 预算管理 • 配置
- 🚀 完整 API 覆盖 — 12 个业务域,100+ 个命令
- 💻 跨平台支持 — Windows、Linux、macOS
- 📊 多种输出格式 — JSON、纯文本、表格、Markdown
- ⚙️ 智能配置 — 四层优先级系统
- 🐚 Shell 自动补全 — Bash、Zsh、Fish、PowerShell
- 🔒 默认安全 — Unix 权限控制 (0600),支持环境变量
- ⚡ 极速运行 — 基于 Rust + Tokio 异步运行时构建
# 克隆仓库
git clone https://github.com/your-org/yunxiao-cli.git
cd yunxiao-cli
# 构建发布版本
cargo build --release
# 安装到 PATH
cp target/release/yunxiao-cli ~/.local/bin/通过 skills CLI 安装 Agent 技能,让 AI 助手更好地使用云效 CLI:
# 安装所有技能
npx skills add dev-zapi/yunxiao-cli --all
# 安装特定技能
npx skills add dev-zapi/yunxiao-cli --skill yunxiao-cli
npx skills add dev-zapi/yunxiao-cli --skill yunxiao-create-requirement可用技能:
- yunxiao-cli — 云效 CLI 完整使用指南
- yunxiao-create-requirement — 创建需求工作流
- Rust 1.75+(通过 rustup 安装)
- 从云效控制台获取个人访问令牌
从 云效控制台 获取令牌:
yunxiao-cli auth login --token <YOUR_TOKEN>或使用环境变量:
export YUNXIAO_CLI_TOKEN=<YOUR_TOKEN>yunxiao-cli auth whoami
yunxiao-cli org list# 列出项目
yunxiao-cli projex projects search --keyword "my-project"
# 查看代码库
yunxiao-cli codeup repos list
# 查看流水线
yunxiao-cli flow pipelines list
# 搜索工作项
yunxiao-cli projex workitems search --space-id <PROJECT_ID> --category Req
# 查看工作项详情(使用业务编号,自动解析项目)
yunxiao-cli projex workitems get -n PROJ-123
# 查看工作项类型字段配置
yunxiao-cli projex workitems fields --space-id <PROJECT_ID> --type-id <TYPE_ID>
# 查看工作项工作流
yunxiao-cli projex workitems flow --space-id <PROJECT_ID> --type-id <TYPE_ID>| 命令 | 描述 |
|---|---|
auth |
登录、登出、状态查看、个人信息 |
config |
配置管理 |
org |
组织与成员管理 |
projex |
项目、工作项、迭代 |
codeup |
代码库、代码组、分支、合并请求 |
flow |
流水线与运行记录 |
appstack |
应用交付与部署 |
packages |
制品仓库管理 |
testhub |
测试管理 |
insight |
效能分析指标 |
thoughts |
知识库 |
completion |
Shell 补全脚本生成 |
budget |
💰 成本追踪与预算管理 |
追踪和管理您的云效资源成本:
# 查看当月预算
yunxiao-cli budget status --org-id <ORG_ID>
# 查看预算历史
yunxiao-cli budget history --months 6 --org-id <ORG_ID>
# 获取详细分解
yunxiao-cli budget breakdown --org-id <ORG_ID># 配置月度预算上限
yunxiao-cli budget set-limit --amount 5000 --currency CNY --org-id <ORG_ID>
# 设置告警阈值
yunxiao-cli budget set-alert --threshold 80 --org-id <ORG_ID># 按服务查看成本
yunxiao-cli budget by-service --org-id <ORG_ID>
# 按项目查看成本
yunxiao-cli budget by-project --org-id <ORG_ID>
# 导出成本报表
yunxiao-cli budget export --format csv --month 2024-01 --org-id <ORG_ID>添加到配置文件(~/.config/yunxiao-cli/config.toml):
[budget]
monthly_limit = 5000
currency = "CNY"
alert_threshold = 80 # 使用率达到 80% 时告警
alert_email = "admin@example.com"~/.config/yunxiao-cli/config.toml
# 认证
token = "pt_xxxxxxxxxxxxxxxxxxxx"
# API 设置
domain = "openapi-rdc.aliyuncs.com"
organization_id = "org-xxxxxxxx"
# 输出与日志
default_output = "table"
log_level = "warn"
timeout = 30
# 预算设置
[budget]
monthly_limit = 10000
alert_threshold = 85- CLI 参数 —
--output json,--timeout 60 - 环境变量 —
YUNXIAO_CLI_TOKEN - 配置文件 —
~/.config/yunxiao-cli/config.toml - 默认值 — JSON, 30秒超时, warn 日志级别
| 变量 | 描述 |
|---|---|
YUNXIAO_CLI_TOKEN |
个人访问令牌 |
YUNXIAO_CLI_OUTPUT |
输出格式 |
YUNXIAO_CLI_TIMEOUT |
请求超时时间 |
YUNXIAO_CLI_ORG_ID |
默认组织 ID |
YUNXIAO_CLI_LOG_LEVEL |
日志级别 |
# 构建
cargo build
# 运行测试
cargo test
# 代码检查与格式化
cargo clippy --all-targets
cargo fmt
# 构建发布版本
cargo build --release- 文档: 云效 OpenAPI
- 端点:
https://openapi-rdc.aliyuncs.com - 认证: 通过
x-devops-pat请求头传递个人访问令牌
MIT 许可协议 — 详情请参见 LICENSE。
使用 Rust 精心打造 ❤️