https://github.com/adoptium/run-aqa
Repository for the Github Action that enables the running of the Adoptium Quality Assurance (AQA) tests
https://github.com/adoptium/run-aqa
adoptopenjdk aqa-tests
Last synced: 3 months ago
JSON representation
Repository for the Github Action that enables the running of the Adoptium Quality Assurance (AQA) tests
- Host: GitHub
- URL: https://github.com/adoptium/run-aqa
- Owner: adoptium
- License: mit
- Created: 2020-03-06T03:32:58.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-16T06:47:16.000Z (10 months ago)
- Last Synced: 2024-12-16T07:38:37.779Z (10 months ago)
- Topics: adoptopenjdk, aqa-tests
- Language: TypeScript
- Size: 753 KB
- Stars: 3
- Watchers: 15
- Forks: 27
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
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 (`` 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