Exciting news!Announcing our $4.6M Series Seed. Learn more
Log in


Package Overview
File Explorer

Advanced tools


Serverless plugin for leo microservices


Version published
Yearly downloads
increased by411.04%

Weekly downloads




Serverless plugin. Deploy your leo bots and microservices using serverless.


  1. Must have an AWS account
  2. AWS CLI must be installed and configured
  3. Must have the Leo Platform deployed to your AWS account
  4. Must have nodejs

Install serverless globally

If you don't have serverless framework globally installed

npm install serverless -g

Migrate an existing leo microservice to serverless

Copy the migrateToServerless.js file into your existing microservice directory.

node migrateToServerless.js

See additional notes within the migrateToServerless.js script.

Create a new NodeJS Leo Microservice and Bot

serverless create --template-url https://github.com/LeoPlatform/serverless-leo/tree/master/templates/microservice -p my-microservice cd my-microservice npm install serverless create bot --name my-bot-name

Add serverless-leo to existing NodeJS project

npm install serverless-leo --save-dev

Leo serverless.yml

plugins: - serverless-leo # Enable serverless-leo plugin custom: leoStack: TestBus # Configure serverless-leo functions: hello: handler: index.handler events: - leo: helloWorldTestQueue # Trigger Lambda from a Leo Queue world: handler: index.handler events: - leo: cron: 0 0 1 * * * # Trigger Lambda from a Leo Cron (down to minute)

Deploy your microservice

Use the standard serverless deploy cli command to deploy your microservice. Optional -s or -stage parameter (standard serverless).


Requires the leo platform (bus). Step 2 in this guide: https://github.com/LeoPlatform/Leo#install-the-leo-platform-stack

Nodejs - https://github.com/LeoPlatform/serverless-leo/tree/master/examples/nodejs
Java - https://github.com/LeoPlatform/serverless-leo/tree/master/examples/java-quickstart
Python (incomplete) - https://github.com/LeoPlatform/serverless-leo/tree/master/examples/python


Trigger lambdas from a Leo queue

Create a "bot" that will run when events are added to a queue. The events will be handled in order and only one lambda will handle events at a time.

hello: handler: index.handler events: - leo: helloWorldTestQueue

You can specify multiple queues for a single lambda. Each will become a separate bot, visible in the bus ui (Botmon).

Name bots

You can define the queue as an object and give the bot a name. Otherwise the name of the bot will be the name of the lambda plus the queue.

hello: handler: index.handler events: - leo: queue: helloWorldTestQueue name: helloBot

Trigger lambdas on a schedule

Create a "bot" that will run on a cron schedule. Only one lambda will run at any given time for a single bot.

world: handler: index.handler events: - leo: cron: 0 0 1 * * *

The bot will be named the same as the lambda.


Create multiple bots using the same lambda by adding "botCount". This will create the number of bots specified and pass in "botNumber" into the event when the bot is ran.

world: handler: index.handler events: - leo: queue: helloWorldTestQueue botCount: 4

This allows you to partition the queue, or change the configuration of the bot based on the value of the variable at run time.

Manual bots

Create bots without a trigger by adding "register: true".

world: handler: index.handler events: - leo: register: true

LeoRegister configuration

You can configure the plugin to use different stacks for different stages.

custom: dev: leoStack: TestBus test: # The arn for the LeoInstallFunction lambda in your leo platform stack. # This is an alternative to using the leoStack variable. EG: the bus and lambda are in different accounts. leoRegister: arn:aws:lambda:us-east-1:123456:function:TestBus-LeoInstallFunction-2IMP25UOQ64G

In this example leoStack would be used when deployed using --stage dev. leoRegister would be used when using --stage test

Invoke local bot

You can invoke a bot to run on your local machine as if it were running in the cloud. It will respect the checkpoint and update it as it progresses.

Run it locally with this command (from the main microservice directory)
serverless invoke-bot -s test -f your_function_name

Options - in order to run a specific bot there are additional options you can pass

-f/--functionName The name of the function the bot uses.
-s/--stage The stage of the microservice.
-n/--name The name of the bot. A regular expression will be used to compare against the prefix, suffix, name, queue, and cron on the bot.
-b/--botNumber The botNumber to execute. If there is no suffix/prefix/queue and there are multiple bots for the lambda, the botNumber can be used to identify the bot.



What is serverless-leo?

Serverless plugin for leo microservices

Is serverless-leo popular?

The npm package serverless-leo receives a total of 237 weekly downloads. As such, serverless-leo popularity was classified as not popular.

Is serverless-leo well maintained?

We found that serverless-leo demonstrated a healthy version release cadence and project activity. It has 6 open source maintainers collaborating on the project.

Last updated on 24 May 2022


Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc