cloudfoundry / go-buildpack

Cloud Foundry buildpack for the Go Language
http://docs.cloudfoundry.org/buildpacks/
Apache License 2.0
82 stars 119 forks source link
v2b

Cloud Foundry Go(Lang) Buildpack

CF Slack Join us on Slack

A Cloud Foundry buildpack for Go(lang) based apps.

Buildpack User Documentation

Official buildpack documentation can be found at go buildpack docs.

Building the Buildpack

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

./scripts/package.sh --stack [cflinuxfs3 | cflinuxfs4] --version <version>

You can then find the built artifact in ./build/buildpack.zip.

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]

Testing

Buildpacks use the Switchblade framework for running integration tests.

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

  1. Run unit tests

    ./scripts/unit.sh
  2. Run integration tests

    ./scripts/integration.sh --github-token <token> --platform <cf|docker>

More information can be found on the switchblade repo.

Contributing

Find our guidelines here.

Help and Support

Join the #buildpacks channel in our Slack community if you need any further assistance.

Reporting Issues

Please fill out the issue template fully if you'd like to start an issue for the buildpack.

Acknowledgements

Inspired by the Heroku buildpack.