riff Builder

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

Relation to the projectriff/*-function-buildpack Repositories

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 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/builder. 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/java-function-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, other riff function buildpacks will be added to collaborate with other buildpacks (e.g. python), while this repository’s builder.toml file will enhance its group(s) to reference e.g. the generic python buildpack.

Building

Prerequisites

To build the projectriff/builder builder you’ll need

• Go 1.13+

• a running local docker daemon

• the pack command line tool (for local function builds)

Creating the Builder

Then, building the builder is as simple as

# clone to a directory that is not under GOPATH
git clone https://github.com/projectriff/builder
cd builder
make

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/builder --no-pull -p . your-org/my-function

You should get something similar to

2018/10/17 12:11:51 Selected run image 'packs/run' from stack 'io.buildpacks.stacks.bionic'
*** DETECTING:
2018/10/17 10:11:53 Group: Cloud Foundry OpenJDK Buildpack: pass | Cloud Foundry Build System Buildpack: pass | riff Buildpack: pass
*** ANALYZING: Reading information from previous image for possible re-use
*** BUILDING:
-----> Cloud Foundry OpenJDK Buildpack 1.0.0-BUILD-SNAPSHOT
-----> OpenJDK JDK 1.8.181: Reusing cached dependency
-----> OpenJDK JRE 1.8.181: Contributing to launch
       Downloading from https://java-buildpack.cloudfoundry.org/openjdk/bionic/x86_64/openjdk-1.8.0_181.tar.gz
[...]
---> Running in 68e4eef095c7
---> f36967212b6c
---> f36967212b6c
Successfully built f36967212b6c
Successfully tagged your-org/my-function