Adoptium Testing

Guide to the Test Jobs at Adoptium

For nightly and release builds, there are test jobs running as part of the Adoptium continuous delivery pipelines. There is a blog post and brief presentation that explains what testing we run and how they fit into the overall delivery pipeline. As the world of testing at Adoptium is evolving and improving quickly, some documentation may fall behind the march of progress. Please let us know and help us keep it up-to-date, and ask questions at the Adoptium testing Slack channel!

Test 'Inventory'

The directory structure in this aqa-tests repository is meant to reflect the different types of test we run (and pull from lots of other locations). The diagrams below show the test make target for each of the types, along with in-plan, upcoming additions (denoted by dotted line grey boxes). The provided links jump to test jobs in Jenkins (ci.adoptium.net).

graph TD
    A[openjdk-tests] -->B[make _perf]
    A[openjdk-tests] -->C[make _openjdk]
    A[openjdk-tests] -->D[make _system]
    A[openjdk-tests] -->E[make _functional]
    A[openjdk-tests] -->F[make _jck]
    A[openjdk-tests] -->G[make _external]
    B[make _perf] -->|perf|H[performance]
    H[performance] -->|_sanity.perf|I[.....]
    H[performance] -->|_extended.perf|J[..]
    C[make _openjdk] -->|openjdk|K[openjdk]
    D[make _system] -->|system|L[system]
    E[make _functional] -->|functional|M[functional]
    F[make _jck] -->|jck|N[jck]
    G[make _external] -->|external|O[external]
    O[external] -->|_sanity.external|P[...]
    O[external] -->|_extended.external|Q[....] 
    

---

openjdk tests - OpenJDK regression tests

Tests from OpenJDK

---

system tests - System and load tests

Tests from the adoptium/aqa-systemtest repo

---

external tests - 3rd party application tests

Test suites from a variety of applications, along with microprofile TCKs, run in Docker containers

graph TD
 A[openjdk-tests] -->|make _external| B[external]
    B --> C[derby]
    B --> D[elasticsearch]
    B --> E[example]
    B --> F[jenkins]
    B --> G[kafka]
    B --> H[lucene-solr]
    B -->|_sanity.external|I[scala]
    B --> J[tomcat]
    B --> K[wildfly]
    B --> L[openliberty]
    B --> M[geode]
    B --> N[hbase]
    B --> O[akka]
    B --> P[logstash]
    B --> Q[openliberty-mp-tck]
    B -->|_extended.external|R[payara-mp-tck]
    B --> S[thorntail-mp-tck]
   

---

perf tests - Performance benchmark suites

Performance benchmark tests (both full suites and microbenches) from different open-source projects such as Acme-Air and adoptium/bumblebench

graph TD
 A[openjdk-tests] -->|make _perf| B[performance]
    B -->|_sanity.perf| C[bbench]
    B --> D[idle_micro]
    B --> E[odm]
    B -->|_extended.perf| F[liberty_dt]
    B --> G[acme_air]

---

functional tests - Unit and functional tests

Functional tests not originating from the openjdk regression suite, that include locale/language tests and a subset of implementation agnostic tests from the openj9 project.

---

jck tests - Compliance tests

TCK tests (under the OpenJDK Community TCK License Agreement), in compliance with the license agreement. While this test material is currently not run at the Adoptium project (see the support statement for details), those with their own OCTLA agreements may use the Adoptium test automation infrastructure to execute their TCK test material in their own private Jenkins servers.

---

Guide to Running the Tests Yourself

For more details on how to run the same tests that we run at Adoptium on your laptop or in your build farm, please consult our User Guide (work in progress).

What is our motivation?

We want:

• better, more flexible tests, with the ability to apply certain types of testing to different builds
• a common way to easily add, edit, group, include, exclude and execute tests on adoptium builds
• the latitude to use a variety of tests that use many different test frameworks
• test results to have a common look & feel for easier viewing and comparison

There are a great number of tests available to test a JVM, starting with the OpenJDK regression tests. In addition to running the OpenJDK regression tests, we will increase the amount of testing and coverage by pulling in other open tests. These new tests are not necessarily written using the jtreg format.

Why the need for other testing? The OpenJDK regression tests are a great start, but eventually you may want to be able to test how performant is your code, and whether some 3rd party applications still work. We will begin to incorporate more types of testing, including:

• additional API and functional tests
• stress/load tests
• system level tests such as 3rd party application tests
• performance tests
• TCK tests

The test infrastructure in this repository allows us to lightly yoke a great variety of tests together to be applied to testing the adoptium binaries. By using an intentionally thin wrapper around a varied set of tests, we can more easily run all types of tests via make targets and as stages in our Jenkins CI pipeline builds.

How can you help?

You can:

• browse through the aqa-tests issues list, select one, add a comment to claim it and ask questions
• browse through the aqa-systemtest issues or stf issues, claim one with a comment and dig right in
• triage live test jobs at ci.adoptium.net, check out the triage doc for guidance
  • if you would like to regularly triage test jobs, you can optionally 'sign up for duty' via the triage rotas
• ask questions in the #testing channel