# java-buildpack-system-test

**Repository Path**: mirrors_cloudfoundry/java-buildpack-system-test

## Basic Information

- **Project Name**: java-buildpack-system-test
- **Description**: System tests for the Java Buildpack
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloud Foundry Java Buildpack System Tests

The purpose of this repository is to exercise the [Cloud Foundry Java Buildpack][b] 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][a] to Cloud Foundry.

The [Cloud Foundry Java Client][c] 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][a] in a repository that is a peer to this one.  To run the tests, run the following:

```shell
$ ./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][p] are welcome; see the [contributor guidelines][g] for details.

## License
This project is released under version 2.0 of the [Apache License][l].


[a]: https://github.com/cloudfoundry/java-test-applications
[b]: https://github.com/cloudfoundry/java-buildpack
[c]: https://github.com/cloudfoundry/cf-java-client
[g]: CONTRIBUTING.md
[l]: http://www.apache.org/licenses/LICENSE-2.0
[p]: http://help.github.com/send-pull-requests