关于 volcengine-vefaas
用于操作火山引擎 veFaaS 的技能,面向部署、函数与沙箱管理及故障排查等任务。它提供 CLI 工作流,并要求知识类问题和 SDK、OpenAPI 开发先检索官方文档。
主要功能
- 01部署应用并管理函数
- 02管理沙箱应用与实例
- 03设置环境变量和应用配置
- 04查看日志、用量并排查故障
- 05检索官方文档并辅助 SDK、OpenAPI 开发
适用场景
- 01将项目部署到 veFaaS
- 02发布、回滚或诊断线上函数
- 03管理沙箱实例与镜像
- 04查询 veFaaS 能力或编写集成代码
MCP 相关
可指导将 MCP Server 部署到 veFaaS,涵盖 STDIO、SSE 和 Streamable-HTTP。它本身是操作 veFaaS 的技能,并非 MCP 服务。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ volcengine/ volcengine-agent-toolkit --skill volcengine-vefaas安装后在 Claude Code 中输入/volcengine-vefaas确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/mcp-deployment.mdvefaas-application.mdvefaas-auth.mdvefaas-cli.mdvefaas-docs.mdvefaas-function.mdvefaas-openapi.mdvefaas-sandbox.mdvefaas-trigger.mdvefaas-troubleshooting.md详细介绍
原文在翻译后有更新,译文可能不是最新。
volcengine-vefaas:Volcengine FaaS CLI
vefaas 是 Volcengine Function Service(veFaaS)的命令行工具。它通过简化的工作流,实现无服务器应用部署、函数管理和配置。
安装
npm i -g https://vefaas-cli.tos-cn-beijing.volces.com/volcengine-vefaas-latest.tgz
验证安装:
vefaas --version
核心工作流
典型的部署流程:
- 检查 Node.js:
node --version(需要 >= 18,推荐 20+)- 如果版本过低,可使用 nvm(
nvm use 20)或 fnm(fnm use 20)切换版本,或手动安装较新版本
- 如果版本过低,可使用 nvm(
- 检查 CLI:运行
vefaas --version验证安装 - 检查认证:运行
vefaas login --check验证登录状态- 如果尚未登录,运行
vefaas login --sso(打开浏览器,用户授权后会自动完成,无需手动输入)
- 如果尚未登录,运行
- 部署:
vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes - 访问:运行
vefaas domains查看 URL
常用命令
| 用途 | 命令 |
|---|---|
| 检查认证 | vefaas login --check |
| 登录(SSO) | vefaas login --sso(非交互式:打开浏览器,授权后自动完成,推荐) |
| 登录(AK/SK) | vefaas login --accessKey <AK> --secretKey <SK> |
| 从模板初始化 | vefaas init --template <name> |
| 部署新应用 | vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes |
| 部署已有应用 | vefaas deploy --app <name> --yes |
| 列出网关 | vefaas run listgateways --first |
| 查看 URL | vefaas domains |
| 设置环境变量 | vefaas env set KEY VALUE |
| 查看配置 | vefaas config list |
| 拉取代码 | vefaas pull --func <name> |
| 检查项目 | vefaas inspect |
全局选项
| 选项 | 说明 |
|---|---|
-d, --debug | 启用调试模式以排查问题 |
--yes | 非交互模式(CI/AI 编码时必需) |
--region | 覆盖区域(例如 cn-beijing) |
操作指南
常见场景的分步指南:
参考文档
特定主题的详细文档:
- 身份验证 - 登录方式和凭证
- 配置 - 配置文件和设置
- 环境变量 - 管理环境变量
- 框架检测 - 支持的框架和自动检测
- MCP 部署 - MCP 协议、
run.sh、代理和路径选择检查 - 故障排除 - 调试模式、常见问题及解决方案
重要说明
- 在 CI/CD 和 AI 编码场景中,非交互模式务必使用
--yes - 使用
$(vefaas run listgateways --first)获取可用网关 - 关联项目后,配置会存储在
.vefaas/config.json中 - 使用
--debug或-d排查问题
评论
支持 Markdown