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:

1. 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
2. Check CLI: vefaas --version to verify installation
3. 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)
4. Deploy: vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes
5. Access: vefaas domains to view URLs

Quick Commands

Global Options

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
• 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