jchesterpivotal / riff

riff is for functions

riff is for functions

A FaaS for Kubernetes

Installation of the latest release

See Getting Started for how to install riff with a Helm Chart, and how to install the riff CLI.

Developer installation

See Installing the riff development version using Helm to install the latest unreleased builds (git master branch) of riff.

Manual build

This is the best option if you want to modify the riff components.

Prerequisites

You need:

• A working Go environment

• A local 1.7+ Kubernetes cluster

• A docker daemon

To build images with docker in minikube use

eval $(minikube docker-env)

Get the main riff repo and install the CLI

go get github.com/projectriff/riff

Build the riff core components

cd $(go env GOPATH)/src/github.com/projectriff/riff
make dockerize

Deploy Kafka

kubectl apply -f config/kafka

Deploy the riff Custom Resource Definitions

kubectl apply -f config/types

Deploy the riff core components

This deploys the HTTP Gateway, Topic Controller, and Function Controller:

kubectl apply -f config

If your cluster has RBAC enabled, then you also need to create a Role and a RoleBinding:

kubectl apply -f config/rbac

To tear it all down

Once you’re done playing with riff (see samples below), you can destroy everything created above by running

./teardown

Try Some Samples

With riff running try some of the samples.

Contributing to riff

Please refer to the Contributors' Guide.

Maintaining riff

Please refer to the Maintainers' Guide.