Skip to content

Commit

Permalink
add README, test.properties files (#2538)
Browse files Browse the repository at this point in the history
* add README, test.properties files

* fix for minor issues

* add describtion, change the layout

* fix for the minor issues in readme
  • Loading branch information
mara-ber authored Apr 28, 2021
1 parent 88f21ff commit a5ab2cd
Show file tree
Hide file tree
Showing 3 changed files with 35 additions and 51 deletions.
22 changes: 22 additions & 0 deletions external/jacoco/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
## External Jacoco Tests

Jacoco tests are part of the external third-party application tests that help verify that the Adoptium binaries are good, by running a variety of Java applications inside of Docker containers. AdoptOpenJDK/openjdk-tests/Issue #172 lists the applications that we have initially targeted to best exercise the AdoptOpenJDK binaries. For each application, we choose to run a selection of their functional tests.
Jacoco test material is pulled from the [Jacoco repository](https://github.com/jacoco/jacoco).

## Running External Jacoco tests locally
To run any AQA tests locally, you follow the same pattern:

0. Ensure your test machine is set up with [test prereqs](https://github.com/AdoptOpenJDK/openjdk-tests/blob/master/doc/Prerequisites.md). For external tests, you do need Docker installed.
1. Download/unpack the SDK that you want to test to your test machine
1. `export TEST_JDK_HOME=</pathToWhereYouInstalledSDK>`
1. `git clone https://github.com/AdoptOpenJDK/openjdk-tests.git`
1. `cd openjdk-tests`
1. `./get.sh`
1. `cd TKG`
1. export required environment variables, BUILD_LIST and EXTRA_DOCKER_ARGS (`export BUILD_LIST=external/jacoco> and <export EXTRA_DOCKER_ARGS="-v $TEST_JDK_HOME:/opt/java/openjdk"`)
1. `make compile` (This fetches test material and compiles it, based on build.xml files in the test directories)
1.`make _jacoco_test` (When you defined BUILD_LIST to point to a directory in openjdk-tests/external, then this is a testCaseName from the playlist.xml file within the directory you chose).

When [running these from the command-line](https://github.com/AdoptOpenJDK/openjdk-tests/blob/master/doc/userGuide.md#local-testing-via-make-targets-on-the-commandline), these tests are grouped under a make target called 'external', so 'make external' would run the entire set of tests found in the openjdk-tests/external directory. This is unadvisable! Limit what you compile and run, BUILD_LIST=external/`<someSubDirectory>`, and TARGET=`<testCaseNameFromSubdirPlaylist>`

These tests run regularly and results can be found in [TRSS Third Party Application view](https://trss.adoptopenjdk.net/ThirdPartyAppView).
51 changes: 0 additions & 51 deletions external/jacoco/dockerfile/Dockerfile

This file was deleted.

13 changes: 13 additions & 0 deletions external/jacoco/test.properties
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
github_url="https://github.com/jacoco/jacoco.git"
script="jacoco-test.sh"
test_results="testResults"
tag_version="master"
environment_variable="MODE=\"java\""
debian_packages="git maven"
debianslim_packages="${debian_packages}"
ubuntu_packages="${debian_packages}"
alpine_packages="git maven"
centos_packages="git maven"
clefos_packages="${centos_packages}"
ubi_packages="git maven"
ubi_minimal_packages="${ubi_packages}"

0 comments on commit a5ab2cd

Please sign in to comment.