Go HTML Shell JavaScript COBOL Python Other
Latest commit aa2e5d5 May 18, 2017 @alexellis committed on GitHub Document envVars to create method

README.md

Functions as a Service (FaaS)

Build Status

FaaS is a framework for building serverless functions on Docker with first class support for metrics. Any UNIX process can be packaged as a function enabling you to consume a range of web events without repetitive boiler-plate coding.

Highlights

  • Ease of use through UI portal and one-click install
  • Write functions in any language for Linux or Windows
  • Portable - runs on your own hardware, or any cloud
  • Auto-scales as demand increases

Concept

  • Each container has a watchdog process that hosts a web server allowing a post request to be forwarded to a desired process via STDIN. The response is sent back to the caller via STDOUT.

  • The API Gateway provides an external route into your functions and collects metrics in Prometheus. The gateway will scale functions according to demand by managing Docker Swarm replicas as throughput increases. A UI is baked in allowing you to invoke functions in your browser and create new ones as needed.

Stack

Closing Keynote at Dockercon 2017

Functions as a Service or FaaS was a winner in the Cool Hacks contest for Dockercon 2017.

If you'd like to find the functions I used in the demos head over to the faas-dockercon repository.

Background story

This is my original blog post on FaaS from Janurary: Functions as a Service blog post

TestDrive

A one-line script is provided to help you get started quickly. You can test-drive FaaS with a set of sample functions as defined in the provided docker-compose.yml file.

Use your own laptop or the free community-run Docker playground: play-with-docker.com.

Begin the TestDrive

Here is a screenshot of the API gateway portal - designed for ease of use.

Portal

Community

Package existing code as functions

Roadmap and contributing

Ongoing development/screenshots:

FaaS is still expanding and growing, check out the developments around:

Minimum requirements:

  • Docker 1.13 (to support Docker Stacks)
  • At least a single host in Docker Swarm Mode. (run docker swarm init)

Additional content

Would you prefer a video overview?

Dockercon closing keynote - Cool Hacks demos with Alexa/Github - April 19th 2017

Watch on YouTube

FaaS tour of features including an Alexa Skill - April 9th 2017

Watch on YouTube

FaaS deep dive - 11th Jan 2017

See how to deploy FaaS onto play-with-docker.com and Docker Swarm in 1-2 minutes. See the sample functions in action and watch the graphs in Prometheus as we ramp up the amount of requests.

Prometheus metrics are built-in

Prometheus is built into FaaS and the sample stack, so you can check throughput for each function individually with a rate function in the UI at port 9090 on your Swarm manager.

If you are new to Prometheus, you can start learning about metrics and monitoring on my blog:

Monitor your applications with Prometheus

Prometheus UI

You can also link this to a Grafana dashboard and see auto-scaling live in action:

Sample dashboard JSON file available here