/java-buildpack

Cloud Foundry buildpack for running Java applications

Primary LanguageRubyApache License 2.0Apache-2.0

Cloud Foundry Java Buildpack

Build Status Dependency Status Code Climate

The java-buildpack is a Cloud Foundry buildpack for running Java applications. It is designed to run most Java applications with no additional configuration, but supports configuration of the standard components, and extension to add custom components.

Usage

To use this buildpack specify the URI of the repository when pushing an application to Cloud Foundry:

cf push --buildpack https://github.com/cloudfoundry/java-buildpack

or if using the gcf tool:

gcf push -b https://github.com/cloudfoundry/java-buildpack

Configuration and Extension

The buildpack supports configuration and extension through the use of Git repository forking. The easiest way to accomplish this is to use GitHub's forking functionality to create a copy of this repository. Make the required configuration and extension changes in the copy of the repository. Then specify the URL of the new repository when pushing Cloud Foundry applications. If the modifications are generally applicable to the Cloud Foundry community, please submit a pull request with the changes.

To learn how to configure various properties of the buildpack, follow the "Configuration" links below. More information on extending the buildpack is available here.

Additional Documentation

Running Tests

To run the tests, do the following:

bundle install
bundle exec rake

Installing Cloud Foundry on Vagrant is useful for privately testing new features.

Contributing

Pull requests are welcome; see the contributor guidelines for details.

License

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