Serverless Force Bench
SFB(Serverless Force Bench) is a tool for bench testing on AWS Serverless.
1. How to use it?
1.1 Requirements
-
node -v>= v16.16.0 -
npm -v>= 9.6.6 -
docker -v>= 24.0.2 - Setting AWS Credentials
1.2 Install the CLI
npm i -g sfb1.3 Show Help Options
sfb help2. Stack
Before using CLI, you need to first deploy the base stack in your chosen region.
Permissions: Managing stacks usually requires administrator permissions.
2.1 Deploy/Update
# deploy a new stack or update stack
sfb deploy
# deploy a new stack or update stack in specify region
sfb deploy --region <your-region>2.2 Remove
# remove the stack
sfb remove
# remove the stack in specify region
sfb remove --region <your-region>2.3 List Deployed Regions
sfb regions3. Tasks
Permissions: Using the CLI usually requires ordinary permissions:
- lambda:invokeFunction
- ec2:describeRegions
- cloudformation:describeStacks
3.1 Create Task
# show how create a new task
sfb create --help
# create a new task in current region
sfb create --name test --type API --n 10 --c 2 --compute Lambda --url https://api.com
# create a new task in specific region(s)
sfb create --name test --type API --n 10 --c 2 --compute Fargate --delay 30 --url https://api.com --regions ap-southeast-1,us-east-2
3.2 List Tasks
# list all tasks
sfb ls
# show a specific task detail
sfb ls [taskId]
3.3 Remove Tasks
# remove all tasks
sfb rm
# remove a specific task
sfb rm [taskId]
3.4 Abort Task
# abort a specific task
sfb abort <taskId>