Skip to content

Commit

Permalink
doc: update table of build environments and list the OS too
Browse files Browse the repository at this point in the history
Signed-off-by: Stewart X Addison <sxa@redhat.com>
  • Loading branch information
sxa committed Aug 11, 2023
1 parent 38e845b commit b144715
Showing 1 changed file with 32 additions and 25 deletions.
57 changes: 32 additions & 25 deletions FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,25 +35,38 @@ There is also some documentation in [CHANGELOG.md](CHANGELOG.md)
- The upstream OpenJDK build requirements are at [Supported Build Platforms](https://wiki.openjdk.java.net/display/Build/Supported+Build+Platforms)
- The Temurin levels we build on are in [Minimum-OS-levels](https://github.com/adoptium/temurin-build/wiki/%5BWIP%5D-Minimum-OS-levels) although anything with comparable equivalent or later C libraries should work OK (in particular we have built on most current Linux distros without issues)

In terms of compilers, these are what we currently use for each release:

| Version | OS | Compiler |
|---------|---------|----------|
| JDK8/11 | Linux | GCC 7.5 |
| JDK17/18| Linux | GCC 10.3 |
| JDK19+ | Linux | GCC 11.2 |
| All | Alpine | GCC 10.3.1 |
| JDK8 | Solaris | Sun Studio 12.3 |
| JDK8 | Windows | VS2017 (19) (Win64) or VS2013 (12) (Win32 and J9) |
| JDK11+ | Windows | VS2019 (10) (Win64) or VS2017 (19) (Win32) |
| JDK8 | AIX | xlC/C++ 13.1.3 |
| JDK11+ | AIX | xlC/C++ 16.1.0 |
| JDK8 | macOS | GCC 4.2.1 (LLVM 2336.11.00 |
| JDK11 | macOS | clang-700.1.81 |
| JDK13+ | macOS | clang-900.0.39.2 |

All machines at Temurin are set up using the ansible playbooks from the
[infrastructure](https://github.com/adoptopenjdk/openjdk-infrastructure) repository.
In terms of OSs and compilers, these are what we currently use for each Temurin release:

JDK | Platform | Build env | Compiler | Other info
--- | --- | --- | --- | ---
8,11,17 | Linux/x64 | CentOS 6 | GCC [1] | glibc 2.12
20+ | Linux/x64 | CentOS 7 | GCC [1] | glibc 2.17
All | Linux/arm32 | Ubuntu 16.04 | GCC [1] | glibc 2.23
All | Linux/s390x | RHEL 7 | GCC [1] | glibc 2.17
All | Linux (others) | CentOS 7 | GCC [1] | glibc 2.17
8 | Windows/x64 | Server 2012 | VS2017 - CL 19.16.27038 |
11,17 | Windows/x64 | Server 2012 | VS2019 - CL 19.27.29111 |
20+ | Windows/x64 | Server 2022 | VS2019 - CL 19.29.30146 |
All | Macos/x64 | 10.14 (18.7.0) | clang-1001.0.46.4 |
All | Macos/aarch64 | 11 (20.1.0) | clang-1200.0.32.29 | There is no build for JDK8
All | Alpine/x64 | 3.15.6 | GCC 10.3.1 | Default compiler Alpine 10.3.1_git20211027
All | Alpine/aarch64 | 3.15.4 | GCC 10.3.1 | Default compiler Alpine 10.3.1_git20211027
8 | AIX | 7.2 (7200-02) | xlc 13.1.3 (13.01.0003.0007) |
11+ | AIX | 7.2 (7200-02) | xlc 16.1.0 (16.01.0000.0011) |
8 | Solaris (Both) | 10 1/13 | Studio 12.3 (C 5.12) |

[1] - Linux gcc levels are 7.5 for JDK8 and 11, 10.3.0 for JDK17 and 11.2.0 for
JDK20+. At present these are all built from us from the
[upstream GCC sources](https://gcc.gnu.org/releases.html)
on our machines as a one off and stored in https://ci.adoptium.net/userContent/gcc/
where they are consumed [by our playbooks](https://github.com/adoptium/infrastructure/blob/master/ansible/playbooks/AdoptOpenJDK_Unix_Playbook/roles/gcc_11/tasks/main.yml)

All of our machines used for building Temurin are set up using the ansible
playbooks from the
[infrastructure](https://github.com/adoptopenjdk/openjdk-infrastructure)
repository.

Runtime platforms are in our [supported platforms page](https://adoptium.net/supported_platforms.html).

## How do I change the parameters, such as configure flags, for a Jenkins build

Expand Down Expand Up @@ -106,12 +119,6 @@ They are also run as part of the Jenkins build pipelines (see the [runSmokeTests

To run them on the command-line, one can follow the same general instructions for running any AQA test on the command-line, with the additional step of exporting variables to indicate where to find test material (VENDOR_TEST_REPOS, VENDOR_TEST_BRANCHES, VENDOR_TEST_DIRS). See: [SmokeTesting.md](https://github.com/adoptium/temurin-build/blob/master/SmokeTesting.md)

## Which OS levels do we build on?

The operating systems/distributions which we build or are documented in the
[temurin-build wiki](https://github.com/adoptium/temurin-build/wiki/%5BWIP%5D-Minimum-OS-levels).
Runtime platforms are in our [supported platforms page](https://adoptium.net/supported_platforms.html).

## How to add a new build pipeline param and associated job configuration?

[This PR](https://github.com/adoptium/temurin-build/pull/2416) demonstrates changes required to add a new build pipeline param and the associated version/platform job configurations for setting the value when needed (note, the `pipelines/` dir has since been moved to our [jenkins repository](https://github.com/adoptium/ci-jenkins-pipelines)).
Expand Down

0 comments on commit b144715

Please sign in to comment.