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

The total amount of memory available is specified when the application is pushed. See Memory for information on how this determines the memory available to a Java application.

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

• 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 Options (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

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.