Skip to content

Commit 6057e04

Browse files
authored
Add oneDPL public CI state and requirements. (#225)
1 parent 08fa6e1 commit 6057e04

File tree

1 file changed

+46
-7
lines changed

1 file changed

+46
-7
lines changed

project-infrastructure/project-ci-documentation.md

Lines changed: 46 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -78,23 +78,62 @@ Representative: Timmie Smith
7878

7979
Support contact for CI:
8080

81+
| Maintainers |
82+
| ------------------------- |
83+
| Dan Hoeflinger @danhoeflinger |
84+
| Dmitriy Sobolev @dmitriy-sobolev |
85+
| Timmie Smith @timmiesmith |
86+
8187
*Existing public CI*
8288

83-
| Owner | Type | OS | Number | Active? | How to access logs |
84-
| --- | --- | --- | --- | --- | --- |
85-
| ? | ? | ? | ? | ? | ? |
89+
The current CI infrastructure is setup for per-commit testing. It is run automatically on PRs in the oneDPL repository
90+
when a new commit is made to the source branch of the PR.
91+
92+
| Owner | Type | OS | How to access logs |
93+
| --- | --- | --- | --- |
94+
| GitHub | CPU x86 | Ubuntu | Via CI Testing Workflow view |
95+
| GitHub | CPU x86 | Windows | Via CI Testing Workflow view |
96+
| GitHub | AArch64 | Mac OS | Via CI Testing Workflow view |
8697

8798
*Required Public CI Infrastruture Needed To Confidently Accept Contributions*
8899

89100
| Instruction set architecture | Hardware Vendor | Processor Type | Operating System |
90101
| --- | --- | --- | --- |
91102
| x86 | Intel | CPU | Ubuntu |
92103
| AArch64 | Arm | CPU | Ubuntu |
104+
| Xe, Xe2, Xe3 | Intel | GPU | Ubuntu, Windows |
105+
| | NVIDIA | GPU | Ubuntu, Windows |
106+
| | AMD | GPU | Ubuntu, Windows |
107+
108+
There are no special paths for particular architectures for AMD and NVIDIA GPUs in oneDPL at this point. It is
109+
sufficient for correctness to run functional testing on one GPU from a vendor. More information on the supported
110+
platforms can be found in the links below.
111+
* NVIDIA: https://developer.codeplay.com/products/oneapi/nvidia/latest/guides/get-started-guide-nvidia#supported-platforms
112+
* AMD: https://developer.codeplay.com/products/oneapi/amd/latest/guides/get-started-guide-amd#supported-platforms
113+
114+
oneDPL testing must cover all C++ standard execution policies as well as oneDPL device policies.
115+
116+
* CPU: ``seq``, ``unseq``, ``par_unseq``, ``device_policy``
117+
* GPU: ``device_policy``
118+
119+
Testing on CPU platforms must exercise ``par`` and ``par_unseq`` execution policies with OpenMP and oneTBB to cover all
120+
of the oneDPL backends.
121+
122+
Minimum Software Versions:
123+
| Software | Windows | Linux | MacOS (Arm CPU testing) |
124+
| --- | --- | --- | --- |
125+
| OpenMP | any | any | any |
126+
| oneTBB | 2022.0 | 2022.0 | 2022.0 |
127+
| CMake | 3.20 | 3.11 | 3.11 |
128+
| git | any | any | any |
129+
| python | any | any | any |
130+
| DPC++ Compiler | 2024.2 | 2024.2 | - |
131+
| clang++ compiler | 16 | 16 | 16 |
132+
| GCC compiler | 10 | 10 | 10 |
133+
| ninja | any | any | any |
134+
| Microsoft Visual Studio* | 2022 | - | - |
135+
| Intel General-Purpose GPU driver (for Intel HW testing) | 2423.32 (Rolling) and 2350.61 (LTS) | 2423.32 (Rolling) and 2350.61 (LTS) | - |
93136

94-
Software Versions:
95-
* CMake
96-
* glibc
97-
* ...
98137

99138
oneDAL
100139
------

0 commit comments

Comments
 (0)