Cloud Foundry Node.js Buildpack

A Cloud Foundry buildpack for Node based apps.

Official buildpack documentation can be found at node buildpack docs.

To build this buildpack, run the following commands from the buildpack's directory:

Source the .envrc file in the buildpack directory.
```
source .envrc
```
To simplify the process in the future, install direnv which will automatically source .envrc when you change directories.

Install buildpack-packager

 go install github.com/cloudfoundry/libbuildpack/packager/buildpack-packager@master

Build the buildpack

buildpack-packager build -stack [STACK] [ --cached=(true|false) ]

Use in Cloud Foundry

Upload the buildpack to your Cloud Foundry and optionally specify it by name

cf create-buildpack [BUILDPACK_NAME] [BUILDPACK_ZIP_FILE_PATH] 1
cf push my_app [-b BUILDPACK_NAME]

Buildpacks use the Cutlass framework for running integration tests.

To test this buildpack, run the following command from the buildpack's directory:

Source the .envrc file in the buildpack directory.
```
source .envrc
```
To simplify the process in the future, install direnv which will automatically source .envrc when you change directories.
Run unit tests
```
./scripts/unit.sh
```
Run integration tests

Buildpacks use the Cutlass framework for running integration tests against Cloud Foundry. Before running the integration tests, you need to login to your Cloud Foundry using the cf cli:
```
cf login -a https://api.your-cf.com -u name@example.com -p pa55woRD
```
Note that your user requires permissions to run cf create-buildpack and cf update-buildpack. To run the integration tests, run the following command from the buildpack's directory:
```
./scripts/integration.sh
```

Find our guidelines here.

Join the #buildpacks channel in our Slack community.

Open an issue on this project.

The project backlog is on Pivotal Tracker.

Inspired by the Heroku buildpack.

cloudfoundry / nodejs-buildpack