node-function-buildpack

README

node-function-buildpack

The Node Function Buildpack is a Cloud Native Buildpack V3 that provides the riff Node Function Invoker to functions.

This buildpack is designed to work in collaboration with other buildpacks, which are tailored to support (and know how to build / run) languages supported by riff.

In Plain English

In a nutshell, when combined with the other buildpacks present in the riff builder what this means (and especially when dealing with the riff CLI which takes care of the creation of the riff.toml file for you):

• The presence of a package.json file and/or the fact that the --artifact flag points to a .js file will result in
  1. the npm installation of the function if applicable
  2. the execution as a node function thanks to the node invoker
• Ambiguity in the detection process will result in a build failure
• The presence of the --invoker flag will entirely bypass the detection mechanism and force a given language/invoker

Detailed Buildpack Behavior

Detection Phase

Detection passes if

• There is at least 1 .js file in the project that matches the "main" value in package.json

Build Phase

If a node function has been detected

• Contributes the riff Node Invoker to a launch layer, set as the main node entry point with FUNCTION_URI = <artifact> set as an environment variable. Note that artifact is set via the invoker, when it does a require() in the current directory (the function), which in turn expects that it contains a valid package.json file with its "main" entry point set (see detection phase).

The function behavior is exposed via standard buildpack process types:

• Contributes web process
• Contributes function process

How to Build

You can build the buildpack by running

make

This will package (with pre-downloaded cache layers) the buildpack in the artifactory/heroku/node-function/latest directory. That can be used as a uri in a functions-builder.toml file of a builder (see https://github.com/heroku/pack-images)

License

This buildpack is released under version 2.0 of the Apache License.