Cloud Foundry Java Buildpack

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

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.

Additional Documentation

• Design
• Migrating from the Previous Java Buildpack
• Security
• Standard Containers
  • Groovy (Configuration)
  • Java Main Class (Configuration)
  • Play
  • Spring Boot CLI (Configuration)
  • Tomcat (Configuration)
• Standard Frameworks
  • JAVA_OPTS (Configuration)
  • AppDynamics (Configuration)
  • New Relic (Configuration)
  • Play Auto Reconfiguration (Configuration)
  • Play JPA Plugin (Configuration)
  • Spring Auto Reconfiguration (Configuration)
  • Spring Insight (Configuration)
• Standard JREs
  • OpenJDK (Configuration)
• Extending
• Utilities
  • Caches (Configuration)
  • Logging (Configuration)
  • Repositories
  • Other Utiltities
  • Repository Builder
  • Test Applications
  • System Tests

Running Tests

To run the tests, do the following:

bundle install
bundle exec rake

If you want to use the RubyMine debugger, you may need to install additional gems by issuing:

bundle install --gemfile Gemfile.rubymine-debug

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

Contributing

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

License

The Tomcat Builder is released under version 2.0 of the Apache License.