Awesome

Cloud Foundry Java Buildpack System Tests

The purpose of this repository is to exercise the Cloud Foundry Java Buildpack together with its dependencies to ensure that the whole works together correctly.

The tests are JUnit tests in a Maven build which push the Java Test Applications to Cloud Foundry.

The Cloud Foundry Java Client is used to drive the Cloud Foundry Cloud Controller REST API.

Running Tests

The project depends on Java 8. You must also have cloned built the Java Test Applications in a repository that is a peer to this one. To run the tests, run the following:

$ ./mvnw clean test

Configuration

The tests are extremely configurable allowing fine-grained control over what applications are tested.

Application Types:

DISTZIP
EJB
GROOVY
JAVAMAIN
RATPACK
SPRINGBOOTCLI
SPRINGBOOTCLIJAR
WEB
WEBSERVLET2

General Configuration

The following configuration elements are required and define where the tests will run.

Environment Variable	Value
`TEST_BUILDPACK`	The buildpack to use when staging test applications
`TEST_HOST`	The host of the Cloud Foundry being tested on
`TEST_ORGANIZATION`	The organization to test in
`TEST_PASSWORD`	The password of the user
`TEST_SKIPSSLVALIDATION`	Whether to skip SSL validation against the Cloud Foundry
`TEST_SPACE`	The space to test in
`TEST_USERNAME`	The name of the user

Test Configuration

The following configuration elements define what tests will run.

Environment Variable	Value
`TEST_<APPLICATION>`	Whether the health tests for a particular application are enabled

Application Configuration

The following configuration elements define details about the test applications.

Environment Variable	Value
`APPLICATIONS_ROOT`	The path to the built `java-test-applications` repository
`APPLICATIONS_<APPLICATION>_ENABLED`	Whether the application is pushed to Cloud Foundry
`APPLICATIONS_<APPLICATION>_MEMORY`	The amount of memory allocated for the application, overriding the value in the `manifest.yml`
`APPLICATIONS_<APPLICATION>_PREFIX`	The application name prefix for the application

Contributing

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

License

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