Skip to content

Commit 62d5e5c

Browse files
Update SB's CI distro coverage guidelines (#4516)
* Update SB's CI distro coverage guidelines * Apply suggestions from code review Co-authored-by: Ella Hathaway <[email protected]> --------- Co-authored-by: Ella Hathaway <[email protected]>
1 parent 6a3caba commit 62d5e5c

File tree

1 file changed

+13
-19
lines changed

1 file changed

+13
-19
lines changed

Documentation/ci-platform-coverage-guidelines.md

Lines changed: 13 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,12 @@ supported version of this library.
1515
1. Only test [distros that are officially supported by .NET](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md#net-supported-os-policy).
1616
Community supported distros will not be covered.
1717

18-
**Note:** There will be conflicts within these guidelines. When they occur, it is an indication
19-
that multiple legs will be needed. For example, Ubuntu is based on Debian. However, .NET is included
20-
in Ubuntu's repositories by default but not Debian's (at the time of writing). As such, it is best
21-
to include legs for both Ubuntu and Debian.
22-
2318
## Distro Versions
2419

25-
When selecting which distro versions to test the .NET version in development, it is important to take into account which distro versions will be in support at the time of the .NET release. Don't worry about testing .NET on distro versions that will be or nearing EOL on the .NET release day.
26-
27-
1. Latest LTS version. If the distro doesn't have an LTS notion, then test latest.
28-
1. Oldest version that will be in-support for the lifetime of the .NET release.
20+
1. Prefer testing latest LTS version. If LTS is unsupported, use the latest version instead.
21+
1. Drop distro versions that will be or are nearing EOL on the .NET release day.
22+
1. Stop updating the test matrix in the last 6 months of support for a .NET version as new distro
23+
versions are released.
2924

3025
## Architectures
3126

@@ -35,13 +30,12 @@ When selecting which distro versions to test the .NET version in development, it
3530
## Permutations
3631

3732
It is not the intent to test every permutation of distro family, distro version, and architecture.
38-
Rather, smart decisions should be made to utilize resources. For example, test the oldest LTS version
39-
of Debian on amd64 and the latest LTS version of Ubuntu on arm64.
40-
41-
1. CentOS Stream
42-
1. Newest in support version
43-
1. Oldest in support version (for the lifetime of .NET)
44-
1. Fedora - Newest in support version
45-
1. Debian - Oldest LTS version (for the lifetime of .NET)
46-
1. Ubuntu - Newest LTS version (arm64)
47-
1. Alpine - Newest in support version
33+
Rather, smart decisions should be made to best utilize resources.
34+
35+
The following distro versions will be included in the [CI matrix](https://github.com/dotnet/sdk/blob/main/eng/pipelines/templates/stages/vmr-build.yml):
36+
37+
1. CentOS Stream - Latest version (amd64)
38+
1. Fedora - Latest version (amd64)
39+
1. Ubuntu - Latest LTS version at the time of the release (amd64/arm64)
40+
1. Alpine - Latest and previous versions (amd64)
41+
1. AlmaLinux - Oldest version (targets lowest glibc version) (amd64)

0 commit comments

Comments
 (0)