Repolode
Submit
fujiwara

fujiwara/lambroll

A minimal command-line deployment tool for AWS Lambda functions, covering deploy, rollback, invoke, logs and diff.

Open-source alternative to:AWS SAM

View on GitHub
Stars
465
Forks
38
Open issues
8
Last commit
18 hours ago

What is it?

lambroll is a command-line tool for deploying AWS Lambda functions. It creates a zip archive from a local directory, then creates or updates the function's code, configuration, tags, aliases, function URLs and reserved concurrency. Versions can be published, rolled back to a previous version, listed and deleted.

The tool also covers day-to-day operations: invoking a function with JSON payloads from a flag or STDIN, streaming CloudWatch logs, showing the status of a function, and diffing the local function.json against the deployed configuration. A function.json file describes the function in the same structure as the CreateFunction API, and can be written in plain JSON or Jsonnet, with template helpers for environment variables, SSM parameters, CloudFormation outputs and Terraform state.

lambroll does not manage surrounding resources such as IAM roles, triggers or API Gateway. For those, the project points to tools like AWS SAM or the Serverless Framework.

Key features

  • 01Creates a zip archive from a local directory and deploys code and configuration.
  • 02Publishes versions, manages aliases and rolls back to a previous version.
  • 03Invokes functions with one or more JSON payloads and tails logs.
  • 04Diffs local function.json against the deployed function, with ignore and mask options.
  • 05Supports Jsonnet configuration and template functions for SSM, CloudFormation and Terraform state.
  • 06Deploys function URLs, Lambda@Edge functions and container images.

Use cases

  • Deploying a Lambda function from a CI pipeline with a single command.
  • Rolling back a bad release by switching an alias to the previous version.
  • Checking drift between a repository's function.json and what is running in AWS.
  • Invoking a function from the terminal during development with test payloads.

Quick start

  1. 1

    Install lambroll with Homebrew

    brew install fujiwara/tap/lambroll
  2. 2

    Create a directory and initialize function.json from an existing function

    lambroll init --function-name hello --download
  3. 3

    Deploy the function

    lambroll deploy

Things to know

  • lambroll does not manage related resources such as IAM roles, function triggers or API Gateway.
  • It does not build native binaries or extensions for the Linux Lambda runtime.

In collections

CLI & terminal tools

Topics

#aws-lambda#serverless#deployment#cli#go#aws#infrastructure-as-code#deploy#lambda

FAQ

What is lambroll?
A minimal command-line deployment tool for AWS Lambda functions, covering deploy, rollback, invoke, logs and diff. lambroll is a command-line tool for deploying AWS Lambda functions. It creates a zip archive from a local directory, then creates or updates the function's code, configuration, tags, aliases, function URLs and reserved concurrency. Versions can be published, rolled back to a previous version, listed and deleted.
Is lambroll free to use? What license does it have?
lambroll is open source under the MIT license. Check the license terms before using it in commercial products.
Is lambroll still maintained?
Actively maintained. The last commit to lambroll was on Nov 7, 2026.
What can I use lambroll for?
Deploying a Lambda function from a CI pipeline with a single command. Rolling back a bad release by switching an alias to the previous version. Checking drift between a repository's function.json and what is running in AWS. Invoking a function from the terminal during development with test payloads.
How do I install lambroll?
Install lambroll with Homebrew: brew install fujiwara/tap/lambroll Create a directory and initialize function.json from an existing function: lambroll init --function-name hello --download Deploy the function: lambroll deploy
Where can I get lambroll?
The source code and installation instructions are on GitHub: https://github.com/fujiwara/lambroll

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects