mcpField
V
volcengine-vefaas

volcengine-vefaas

github.com/volcengine云与 DevOps24109 次安装2 天前更新
代码仓库

关于 volcengine-vefaas

用于操作火山引擎 veFaaS 的技能,面向部署、函数与沙箱管理及故障排查等任务。它提供 CLI 工作流,并要求知识类问题和 SDK、OpenAPI 开发先检索官方文档。

主要功能

  1. 01部署应用并管理函数
  2. 02管理沙箱应用与实例
  3. 03设置环境变量和应用配置
  4. 04查看日志、用量并排查故障
  5. 05检索官方文档并辅助 SDK、OpenAPI 开发

适用场景

  1. 01将项目部署到 veFaaS
  2. 02发布、回滚或诊断线上函数
  3. 03管理沙箱实例与镜像
  4. 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.yaml
references/
mcp-deployment.md
vefaas-application.md
vefaas-auth.md
vefaas-cli.md
vefaas-docs.md
vefaas-function.md
vefaas-openapi.md
vefaas-sandbox.md
vefaas-trigger.md
vefaas-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

核心工作流

典型的部署流程:

  1. 检查 Node.js:node --version(需要 >= 18,推荐 20+)
    • 如果版本过低,可使用 nvm(nvm use 20)或 fnm(fnm use 20)切换版本,或手动安装较新版本
  2. 检查 CLI:运行 vefaas --version 验证安装
  3. 检查认证:运行 vefaas login --check 验证登录状态
    • 如果尚未登录,运行 vefaas login --sso(打开浏览器,用户授权后会自动完成,无需手动输入)
  4. 部署:vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes
  5. 访问:运行 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
查看 URLvefaas domains
设置环境变量vefaas env set KEY VALUE
查看配置vefaas config list
拉取代码vefaas pull --func <name>
检查项目vefaas inspect

全局选项

选项说明
-d, --debug启用调试模式以排查问题
--yes非交互模式(CI/AI 编码时必需)
--region覆盖区域(例如 cn-beijing)

操作指南

常见场景的分步指南:

参考文档

特定主题的详细文档:

重要说明

  • 在 CI/CD 和 AI 编码场景中,非交互模式务必使用 --yes
  • 使用 $(vefaas run listgateways --first) 获取可用网关
  • 关联项目后,配置会存储在 .vefaas/config.json 中
  • 使用 --debug 或 -d 排查问题

评论

支持 Markdown