关于 volcengine-vefaas
volcengine-vefaas 是用于在 Volcengine Function Service 上部署和管理无服务器应用的命令行技能,涵盖登录、项目初始化、部署、函数代码获取和配置。
主要功能
- 01从模板初始化项目
- 02部署新建或已有应用
- 03管理函数并获取代码
- 04配置环境变量
- 05检查登录状态并查看域名
适用场景
- 01从模板部署无服务器应用
- 02通过 CI/CD 发布现有项目
- 03拉取函数代码以便本地处理
- 04设置环境变量并检查配置
MCP 相关
文档提供 MCP 部署指南,涉及协议、run.sh、代理和路径选择检查;未说明该项目向 MCP 客户端暴露的工具或资源。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ volcengine/ volcengine-skills --skill volcengine-vefaas安装后在 Claude Code 中输入/volcengine-vefaas确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/authentication.mdconfiguration.mdenvironment-variables.mdframework-detection.mdmcp-deployment.mdtroubleshooting.mdreferences/cookbooks/deploy-existing-code.mdmanage-functions.mdtemplate-quickstart.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