# run-aqa

**Repository Path**: mirrors_AdoptOpenJDK/run-aqa

## Basic Information

- **Project Name**: run-aqa
- **Description**: Repository for the Github Action that enables the running of the Adoptium Quality Assurance (AQA) tests
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RunAQA tests

An action to run [AQA tests](https://github.com/adoptium/aqa-tests) with specific JDK on specific platform

## Usage

See [action.yml](https://github.com/adoptium/run-aqa/blob/master/action.yml)

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

```yaml
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](https://github.com/actions/setup-java)

```yaml
- 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](https://github.com/AdoptOpenJDK/install-jdk) using JDKs are downloaded from AdoptOpenJDK

```yaml
- 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

```yaml
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](https://github.com/actions/upload-artifact) to upload test outputs if there are test failures

```yaml
- 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`]
  - upstream: JDK built by build-jdk Github action
  - install-jdk: JDK installed by [AdoptOpenJDK/install-jdk](https://github.com/AdoptOpenJDK/install-jdk) | [actions/setup-java](https://github.com/actions/setup-java)
  - github-hosted : pre-installed JDK on github-hosted runner

### 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