This package has been deprecated

    Author message:

    Renamed to @probot/adapter-aws-lambda-serverless. See https://github.com/probot/adapter-aws-lambda-serverless/releases/tag/v2.0.0

    @probot/serverless-lambda

    1.0.2 • Public • Published

    AWS Lambda Extension for Probot

    A Probot extension to make it easier to run your Probot Apps in AWS Lambda.

    Usage

    $ npm install @probot/serverless-lambda
    // handler.js
    const { serverless } = require("@probot/serverless-lambda");
    const appFn = require("./");
    module.exports.probot = serverless(appFn);

    Configuration

    This package moves the functionality of probot run into a handler suitable for usage on AWS Lambda + API Gateway. Follow the documentation on Environment Configuration to setup your app's environment variables. You can add these to .env, but for security reasons you may want to use the AWS CLI or Serverless Framework to set Environment Variables for the function so you don't have to include any secrets in the deployed package.

    To use .env files with the Serverless Framework, you can install the serverless-dotenv-plugin. This will take care of keeping your secrets out of your deployed package.

    Serverless dotenv plugin usage

    plugins:
      - serverless-dotenv-plugin # Load .env as environment variables 
     
    provider:
      name: aws
      runtime: nodejs12.x

    For the private key, since AWS environment variables cannot be multiline strings, you could Base64 encode the .pem file you get from the GitHub App or use KMS to encrypt and store the key.

    Differences from probot run

    Local Development

    Since Lambda functions do not start a normal node process, the best way we've found to test this out locally is to use serverless-offline. This plugin for the serverless framework emulates AWS Lambda and API Gateway on your local machine, allowing you to continue working from https://localhost:3000/probot before deploying your function to AWS.

    Long running tasks

    Some Probot Apps that depend on long running processes or intervals will not work with this extension. This is due to the inherent architecture of serverless functions, which are designed to respond to events and stop running as quickly as possible. For longer running apps we recommend using other deployment options.

    If you use HTTP routes or WEBHOOK_PATH

    This extension is designed primarily for receiving webhooks from GitHub and responding back as a GitHub App. If you are using HTTP Routes in your app to serve additional pages, you should take a look at serverless-http, which can be used with Probot's express server by wrapping probot.server.

    Install

    npm i @probot/serverless-lambda

    DownloadsWeekly Downloads

    783

    Version

    1.0.2

    License

    ISC

    Unpacked Size

    13.6 kB

    Total Files

    8

    Last publish

    Collaborators

    • bkeepers
    • gr2m
    • hiimbex
    • jasonetco
    • lee-dohm
    • probotbot
    • tcbyrd