{"id":18666929,"url":"https://github.com/adoptium/run-aqa","last_synced_at":"2025-10-19T17:13:53.905Z","repository":{"id":39968041,"uuid":"245322371","full_name":"adoptium/run-aqa","owner":"adoptium","description":"Repository for the Github Action that enables the running of the Adoptium Quality Assurance (AQA) tests","archived":false,"fork":false,"pushed_at":"2024-12-16T06:47:16.000Z","size":771,"stargazers_count":3,"open_issues_count":24,"forks_count":27,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-12-16T07:38:37.779Z","etag":null,"topics":["adoptopenjdk","aqa-tests"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adoptium.png","metadata":{"funding":{"github":"adoptium","custom":["eclipse.org/donate/adoptium"]},"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-06T03:32:58.000Z","updated_at":"2024-12-16T06:47:19.000Z","dependencies_parsed_at":"2023-01-11T17:21:49.426Z","dependency_job_id":"9d61ef3a-efd1-48df-94de-ae79b7c3d42b","html_url":"https://github.com/adoptium/run-aqa","commit_stats":{"total_commits":178,"total_committers":20,"mean_commits":8.9,"dds":0.6067415730337078,"last_synced_commit":"dd2c77c99ceee255e2c4ea4fde668d93df8aa9ed"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adoptium%2Frun-aqa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adoptium%2Frun-aqa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adoptium%2Frun-aqa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adoptium%2Frun-aqa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adoptium","download_url":"https://codeload.github.com/adoptium/run-aqa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230382859,"owners_count":18216854,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adoptopenjdk","aqa-tests"],"created_at":"2024-11-07T08:34:47.829Z","updated_at":"2025-10-19T17:13:48.860Z","avatar_url":"https://github.com/adoptium.png","language":"TypeScript","funding_links":["https://github.com/sponsors/adoptium","eclipse.org/donate/adoptium"],"categories":[],"sub_categories":[],"readme":"# RunAQA tests\n\nAn action to run [AQA tests](https://github.com/adoptium/aqa-tests) with specific JDK on specific platform\n\n## Usage\n\nSee [action.yml](https://github.com/adoptium/run-aqa/blob/master/action.yml)\n\n## Default upstream action build JDK: run openjdk test _jdk_math against upstream action build JDK\n\n```yaml\nsteps:\n- uses: actions/checkout@v3\n - name: Build Openj9 JDK\n   id: buildOpenj9\n   uses: eclipse/build-openj9@v1\n   with:\n     version: '8'\n- name: AQA\n  uses: adoptium/run-aqa@v2\n  env:\n     TEST_JDK_HOME: ${{ steps.buildOpenj9.outputs.BuildOpenJ9JDK }}\n  with: \n    build_list: 'openjdk'\n    target: '_jdk_math'\n```\nYou can also:\n  - run functional, external, system, perf tests\n  - run different level target\n\n## Customized JDK\n### run openjdk test _jdk_math against customized JDK, jdk setup by [actions/setup-java](https://github.com/actions/setup-java)\n\n```yaml\n- uses: actions/setup-java@v3\n  with:\n    java-version: '11' # The JDK version to make available on the path.\n- name: AQA\n  uses: adoptium/run-aqa@v2\n  with: \n    version: '11'\n    jdksource: 'customized'\n    build_list: 'openjdk'\n    target: '_jdk_math'\n ```\n### 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\n\n```yaml\n- uses: AdoptOpenJDK/install-jdk@v1\n  with:\n    version: '11'\n    targets: 'JDK_11'\n    impl: 'openj9'\n- name: AQA\n  uses: adoptium/run-aqa@v2\n  with: \n    version: '11'\n    jdksource: 'customized'\n    build_list: 'openjdk'\n    target: '_jdk_math'\n ```\n\n## Github-hosted JDK: run openjdk test _jdk_math against installed JDK on Github-hosted virtual machine\n\n```yaml\nsteps:\n- uses: actions/checkout@v3\n- name: AQA\n  uses: adoptium/run-aqa@v2\n  with: \n    version: '11'\n    jdksource: 'github-hosted'\n    build_list: 'openjdk'\n    target: '_jdk_math'\n```\n\n## Work with [upload-artifact](https://github.com/actions/upload-artifact) to upload test outputs if there are test failures\n\n```yaml\n- uses: actions/upload-artifact@v4\n  if: failure()\n  with:\n    name: test_output\n    path: ./**/test_output_*/\n```\n\n## Configuration:\n\n| Parameter | Default | Required |\n| ------ | ------ | ------ |\n| jdksource | upstream | |\n| customizedSdkUrl |  | |\n| sdkdir |  | |\n| version |  | |\n| build_list | openjdk | |\n| target | _jdk_math | |\n| custom_target |  | |\n| aqa-testsRepo |  | |\n| aqa-systemtestRepo |  | |\n| openj9_repo |  | |\n| tkg_Repo |  | |\n| vendor_testRepos |  | |\n| vendor_testBranches|  | |\n| vendor_testDirs  |  | |\n| vendor_testShas|  | |\n\n### jdksource\nThe source of test against JDK. Default is `upstream`. Supported value are [`upstream`, `install-jdk`, `github-hosted`]\n  - upstream: JDK built by build-jdk Github action\n  - install-jdk: JDK installed by [AdoptOpenJDK/install-jdk](https://github.com/AdoptOpenJDK/install-jdk) | [actions/setup-java](https://github.com/actions/setup-java)\n  - github-hosted : pre-installed JDK on github-hosted runner\n\n### version\nThe Java version that tests are running against (Supported values are: 8, 9, 10, 11, 12, 13, ...)\nBy default, this action will run against upstream jdk build action installed JDK. Specifying this parameter is required when jdksource is not `upstream`.\n\n### build_list\nTest category. Default to `openjdk`. Supported values are [`openjdk`, `functional`, `system`, `perf`, `external`]\n\n### target\nSpecific test target name (`\u003ctestCaseName\u003e` as defined in a playlist.xml) or different test level under build_list. Defaults to `_jdk_math` for build_list=openjdk\n\n### custom_target\nSet customized testcase when any custom target is selected(e.g. jdk_custom, langtools_custom, etc) , path to the test class to execute\n\n### aqa-testsRepo\naqa-tests git repo, that holds the definitions for the AQA test suite. Parameter can be set to use developer's personal repo. \n\n### tkg_Repo\nTKG git repo, the underlying framework for the AQA test suite. Parameter can be set to use developer's personal repo.\n\n### customizedSdkUrl\nWhen `jdksource` is nightly or customized, set url for customized sdk\n\n### sdkdir\nWhen `jdksource` is nightly or customized, set preferred directory to store sdk\n\n### aqa-systemtestRepo:\nPersonal aqa-systemtest Repo. For example, octocat/aqa-systemtest:test\n\n### openj9_repo:\nSet to openj9 Repo\n\n### vendor_testRepos\nComma-separated list of vendor repositories\n\n### vendor_testBranches\nComma-separated list of vendor branches\n\n### vendor_testDirs\nComma-separated list of vendor directories\n\n### vendor_testShas\nComma-separated list of vendor SHAs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadoptium%2Frun-aqa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadoptium%2Frun-aqa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadoptium%2Frun-aqa/lists"}