vefaas 是火山引擎函数服务(veFaaS)的命令行工具,用于在 veFaaS 上完成无服务器应用的部署、函数管理与配置。
用途与主要能力:
- 应用部署:支持从官方模板初始化新项目,也支持部署已有项目;可创建新应用并指定网关,或对已有应用执行部署。
- 函数管理:支持拉取指定函数的代码、上传并部署,以及查看项目信息。
- 配置与环境:可设置环境变量、查看当前配置;项目关联后配置保存在 .vefaas/config.json。
- 访问入口:通过域名命令查看已部署应用的访问 URL。
使用方式:
- 安装:npm i -g https://vefaas-cli.tos-cn-beijing.volces.com/volcengine-vefaas-latest.tgz,并用 vefaas --version 验证。
- 环境要求:Node.js 版本需 >= 18,推荐 20+,版本过低时可用 nvm 或 fnm 切换。
- 登录:可用 vefaas login --check 检查登录状态;未登录时运行 vefaas login --sso(打开浏览器,授权后自动完成),或使用 vefaas login --accessKey <AK> --secretKey <SK>。
- 部署:新建应用使用 vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes;已有应用使用 vefaas deploy --app <name> --yes。
- 查看访问地址:vefaas domains。
- 常用命令还包括 vefaas init --template <name>、vefaas env set KEY VALUE、vefaas config list、vefaas pull --func <name>、vefaas inspect。
全局选项:-d/--debug 开启调试模式;--yes 启用非交互模式(CI/AI 编码场景必需);--region 覆盖区域(如 cn-beijing)。
适用场景:需要在火山引擎 veFaaS 上快速部署 Web 应用、从模板创建项目、管理函数代码与配置、以及在自动化流程中执行无交互部署的开发者。
限制与注意事项:Node.js 版本需满足要求;未登录时需先完成认证;在 CI/CD 和 AI 编码场景中应始终使用 --yes;网关可通过 $(vefaas run listgateways --first) 获取;遇到问题可用 --debug 排查。具体支持的框架自动检测范围、MCP 部署细节及排错内容在资料中仅列出章节标题,未提供详细正文。