Volcengine Vefaas

这是火山引擎veFaaS的命令行工具，核心功能涵盖无服务器应用部署、函数（拉取/上传部署）管理、环境变量配置、项目信息查看，以及CLI、认证、框架等问题排查。典型场景包括部署Web应用、CI/CD自动化运维、函数生命周期管理。通过输入CLI命令执行操作，支持SSO/AKSK登录，提供模板快速启动，含调试模式辅助排障，适配非交互的CI/AI编码场景。

volc-sdk-team

热度 34.26

最近更新 2026-06-25 23:40:09

分类：开发依赖：代码执行 / 联网浏览搜索 / MCP 服务应用场景：DevOps / 调试排错 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add volcengine-vefaas

Metadata

name: volcengine-vefaas
description: Deploy and manage serverless applications on Volcengine veFaaS. Use when the user wants to deploy web apps, manage functions (pull code, upload and deploy), configure environment variables, inspect veFaaS projects, troubleshoot vefaas CLI/auth/framework issues, or work with veFaaS services.
license: MIT

volcengine-vefaas: Volcengine FaaS CLI

vefaas is the command-line tool for Volcengine Function Service (veFaaS). It enables serverless application deployment, function management, and configuration through a streamlined workflow.

Installation

npm i -g https://vefaas-cli.tos-cn-beijing.volces.com/volcengine-vefaas-latest.tgz

Verify installation:

vefaas --version

Core Workflow

The typical deployment pattern:

Check Node.js: node --version (requires >= 18, recommended 20+)
- If version is too low, switch using nvm (nvm use 20) or fnm (fnm use 20), or manually install a newer version
Check CLI: vefaas --version to verify installation
Check Auth: vefaas login --check to verify login status
- If not logged in, run vefaas login --sso (opens browser, auto-completes when user authorizes - no manual input needed)
Deploy: vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes
Access: vefaas domains to view URLs

Quick Commands

Purpose	Command
Check auth	`vefaas login --check`
Login (SSO)	`vefaas login --sso` (non-interactive: opens browser, auto-completes when authorized, recommended)
Login (AK/SK)	`vefaas login --accessKey <AK> --secretKey <SK>`
Init from template	`vefaas init --template <name>`
Deploy new app	`vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes`
Deploy existing	`vefaas deploy --app <name> --yes`
List gateways	`vefaas run listgateways --first`
View URLs	`vefaas domains`
Set env var	`vefaas env set KEY VALUE`
View config	`vefaas config list`
Pull code	`vefaas pull --func <name>`
Inspect project	`vefaas inspect`

Global Options

Option	Description
`-d, --debug`	Enable debug mode for troubleshooting
`--yes`	Non-interactive mode (required for CI/AI coding)
`--region`	Region override (e.g., cn-beijing)

Cookbooks

Step-by-step guides for common scenarios:

Template Quickstart - Create and deploy from official templates
Deploy Existing Code - Deploy your existing project
Manage Functions - Manage functions (pull code, upload and deploy)

References

Detailed documentation on specific topics:

Authentication - Login methods and credentials
Configuration - Config files and settings
Environment Variables - Managing env vars
Framework Detection - Supported frameworks and auto-detection
MCP Deployment - MCP protocol, run.sh, proxy, and path-selection checks
Troubleshooting - Debug mode, common issues, and solutions

Important Notes

Always use --yes for non-interactive mode in CI/CD and AI coding scenarios
Use $(vefaas run listgateways --first) to get an available gateway
Config is stored in .vefaas/config.json after linking
Use --debug or -d to troubleshoot issues