riff Buildpack Group

This repository hosts the files necessary to create the buildpack builder used when riff builds functions from source with the riff function create <buildpack> <fn-name> command.

Relation to the projectriff/riff-buildpack Repository

In the v3 buildpack ecosystem, a distinction needs to be made between a buildpack and a builder.

The latter is what is actually involved when running riff function create with the java buildpack approach. A builder is the composition of several buildpacks using groups. It takes the form of a docker image. In the case of riff, its official location is projectriff/buildpack. The purpose of this repository is to allow the creation of that builder.

The former, a buildpack, is a more fine grained unit of logic that can be composed and collaborate with other buildpacks. The projectriff/riff-buildpack repository hosts one of them, responsible for applying the riff-specific logic on top of the more general java building logic. As more languages become supported by riff, that buildpack will evolve to collaborate with other buildpacks (e.g. node), while this repository’s builder-riff.toml file will enhance its group(s) to reference e.g. the generic node buildpack.

Building

Prerequisites

To build the projectriff/buildpack builder you’ll need

Go 1.11+
a running local docker daemon
the pack command line tool. At the time of writing, a version built from master is required (to support references to remote buildpacks in builder-riff.toml):
```
git clone https://github.com/buildpack/pack
cd pack
GO111MODULE=on go install ./cmd/pack
```

Creating the Builder

Then, building the builder is as simple as

git clone https://github.com/projectriff/riff-buildpack-group
cd riff-buildpack-group
pack create-builder -b builder-riff.toml projectriff/buildpack

Using the Builder Locally

Lastly, to use the builder created above, just refer to the pack build reference:

cd where-your-function-is
pack build --builder projectriff/buildpack --no-pull -p . your-org/my-function

You should get something similar to