Skip to content

Repository for the Github Action that enables the running of the Adoptium Quality Assurance (AQA) tests

License

Notifications You must be signed in to change notification settings

adoptium/run-aqa

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

RunAQA tests

An action to run AQA tests with specific JDK on specific platform

Usage

See action.yml

Default upstream action build JDK: run openjdk test _jdk_math against upstream action build JDK

steps:
- uses: actions/checkout@v3
 - name: Build Openj9 JDK
   id: buildOpenj9
   uses: eclipse/build-openj9@v1
   with:
     version: '8'
- name: AQA
  uses: adoptium/run-aqa@v2
  env:
     TEST_JDK_HOME: ${{ steps.buildOpenj9.outputs.BuildOpenJ9JDK }}
  with: 
    build_list: 'openjdk'
    target: '_jdk_math'

You can also:

  • run functional, external, system, perf tests
  • run different level target

Customized JDK

run openjdk test _jdk_math against customized JDK, jdk setup by actions/setup-java

- uses: actions/setup-java@v3
  with:
    java-version: '11' # The JDK version to make available on the path.
- name: AQA
  uses: adoptium/run-aqa@v2
  with: 
    version: '11'
    jdksource: 'customized'
    build_list: 'openjdk'
    target: '_jdk_math'

run openjdk test _jdk_math against customized JDK, jdk installed by AdoptOpenJDK/install-jdk using JDKs are downloaded from AdoptOpenJDK

- uses: AdoptOpenJDK/install-jdk@v1
  with:
    version: '11'
    targets: 'JDK_11'
    impl: 'openj9'
- name: AQA
  uses: adoptium/run-aqa@v2
  with: 
    version: '11'
    jdksource: 'customized'
    build_list: 'openjdk'
    target: '_jdk_math'

Github-hosted JDK: run openjdk test _jdk_math against installed JDK on Github-hosted virtual machine

steps:
- uses: actions/checkout@v3
- name: AQA
  uses: adoptium/run-aqa@v2
  with: 
    version: '11'
    jdksource: 'github-hosted'
    build_list: 'openjdk'
    target: '_jdk_math'

Work with upload-artifact to upload test outputs if there are test failures

- uses: actions/upload-artifact@v4
  if: failure()
  with:
    name: test_output
    path: ./**/test_output_*/

Configuration:

Parameter Default Required
jdksource upstream
customizedSdkUrl
sdkdir
version
build_list openjdk
target _jdk_math
custom_target
aqa-testsRepo
aqa-systemtestRepo
openj9_repo
tkg_Repo
vendor_testRepos
vendor_testBranches
vendor_testDirs
vendor_testShas

jdksource

The source of test against JDK. Default is upstream. Supported value are [upstream, install-jdk, github-hosted]

version

The Java version that tests are running against (Supported values are: 8, 9, 10, 11, 12, 13, ...) By default, this action will run against upstream jdk build action installed JDK. Specifying this parameter is required when jdksource is not upstream.

build_list

Test category. Default to openjdk. Supported values are [openjdk, functional, system, perf, external]

target

Specific test target name (<testCaseName> as defined in a playlist.xml) or different test level under build_list. Defaults to _jdk_math for build_list=openjdk

custom_target

Set customized testcase when any custom target is selected(e.g. jdk_custom, langtools_custom, etc) , path to the test class to execute

aqa-testsRepo

aqa-tests git repo, that holds the definitions for the AQA test suite. Parameter can be set to use developer's personal repo.

tkg_Repo

TKG git repo, the underlying framework for the AQA test suite. Parameter can be set to use developer's personal repo.

customizedSdkUrl

When jdksource is nightly or customized, set url for customized sdk

sdkdir

When jdksource is nightly or customized, set preferred directory to store sdk

aqa-systemtestRepo:

Personal aqa-systemtest Repo. For example, octocat/aqa-systemtest:test

openj9_repo:

Set to openj9 Repo

vendor_testRepos

Comma-separated list of vendor repositories

vendor_testBranches

Comma-separated list of vendor branches

vendor_testDirs

Comma-separated list of vendor directories

vendor_testShas

Comma-separated list of vendor SHAs