Skip to content
An extension for running Probot on Google Cloud Functions
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests bump to 0.2 to match lambda Sep 25, 2018
views 🤖 Init to winit Sep 13, 2018
.gitignore Add Travis Sep 25, 2018
.travis.yml
README.md
index.js Convert to createProbot Sep 25, 2018
package-lock.json Add tests Sep 25, 2018
package.json

README.md

Google Cloud Function Handler for Probot

A Probot extension to make it easier to run your Probot Apps in Google Cloud Functions.

Usage

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

Configuration

This package moves the functionality of probot run into a handler suitable for usage on Google Cloud Functions. 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 gcloud cli or Serverless Framework to set Environment Variables for the function so you don't have to include any secrets in the deployed package.

Differences from probot run

Local Development

Since GCF 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.

Only responds to Webhooks from GitHub

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.

You can’t perform that action at this time.