Add Azure Linux 4 to libraries Helix extra-platforms (linux_x64)

[richlander]

Note

This PR description was AI/Copilot-generated.

Adds Azure Linux 4 to the libraries Helix extra-platforms queue set for linux_x64 (CoreCLR inner-loop) in eng/pipelines/libraries/helix-queues-setup.yml.

Change

File	Distro	Slot	Action
eng/pipelines/libraries/helix-queues-setup.yml	AzureLinux 4.0	extra-platforms linux_x64	Added

Queue entry:

(AzureLinux.4.0.Amd64.Open)AzureLinux.3.Amd64.Open@mcr.microsoft.com/dotnet-buildtools/prereqs:azurelinux-4.0-helix-amd64@sha256:00d7174904a88fcc7ed07b7a4af7154a3268b9b1f92aee85102c3808e98e8431

Host queue is AzureLinux.3.Amd64.Open, matching all other container-backed entries in the same section (Debian 13, Fedora 44, openSUSE 16.0).

Image availability

The exact tag azurelinux-4.0-helix-amd64 is present in image-info.dotnet-dotnet-buildtools-prereqs-docker-main.json. Digest pinned in the queue string above.

Scope

helix-platforms.yml is intentionally not updated — those values are reserved for GA releases, and Azure Linux 4 has not yet GA'd. This change only adds opt-in coverage via the extra-platforms pipeline.

CI

This change only affects the extra-platforms (isExtraPlatformsBuild) path. After this PR is opened, run:

/azp run runtime-extra-platforms

References

• OS onboarding guide
• .NET OS Support Tracking

[richlander]

/azp run runtime-extra-platforms

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-infrastructure-libraries
See info in area-owners.md if you want to be subscribed.

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[Copilot]

Pull request overview

This PR expands the libraries Helix queue configuration for the linux_x64 CoreCLR inner-loop path by adding an Azure Linux 4.0 container-backed queue to the extra-platforms set, increasing opt-in OS coverage without changing the general/GA platform sets.

Changes:

• Add a new extra-platforms Helix queue entry for AzureLinux.4.0.Amd64.Open using the azurelinux-4.0-helix-amd64 prereqs container image (digest-pinned).
• Keep the host queue consistent with the existing container-backed extra-platforms entries (AzureLinux.3.Amd64.Open).
• Scope the change to the isExtraPlatformsBuild && testScope != outerloop CoreCLR path only.

[vcsjones]

Test System.Security.Cryptography.Tests.ChaCha20Poly1305IsSupportedTests.CheckIsSupported has failed.

I can open a pull request to fix this.

[richlander]

Thanks @vcsjones. I cannot get crypto-related failures past your eyes easily! Much appreciated.

[vcsjones]

@richlander The ChaCha20Poly1305 test failure fix is merged in #127618

The other test failure is QUIC related. This test is failing.

runtime/src/libraries/System.Net.Quic/tests/FunctionalTests/MsQuicPlatformDetectionTests.cs

Lines 63 to 66 in c77572b

	public void SupportedLinuxPlatforms_IsSupportedIsTrue()
	{
	_output.WriteLine($"Running on {PlatformDetection.GetDistroVersionString()}");
	Assert.True(QuicListener.IsSupported);

It's testing that QUIC is supported on the underlying platform. It seems that the AZL4 image doesn't have a working version of MsQuic available, or for some other reason was not able to load. cc @dotnet/ncl

[richlander]

/azp run runtime-extra-platforms

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[github-actions]

🤖 Copilot Code Review — PR #127613

Note

This review was generated by GitHub Copilot.

Holistic Assessment

Motivation: Adding Azure Linux 4.0 to the extra-platforms Helix queue is a straightforward infrastructure improvement that expands CI test coverage to an upcoming distro.

Approach: A single-line addition to the established queue configuration file, following the exact same pattern as all other container-based Helix queue entries. This is the correct and minimal approach.

Summary: ✅ LGTM. The change is well-scoped, follows the established format, is placed in the correct conditional section (isExtraPlatformsBuild / inner-loop only), and introduces no risk to existing CI behavior.

---

Detailed Findings

✅ Format & Placement — Correct

The new entry at line 64 uses the standard (LogicalName)HostQueue@image@sha256:digest pattern matching all other entries in this file. It is placed inside the isExtraPlatformsBuild + non-outerloop conditional, appropriate for initial coverage validation. The host queue (AzureLinux.3.Amd64.Open) is the same host used by all other container-based entries in this section.

✅ Image Pin — Immutable SHA256

The image reference is pinned to a specific SHA256 digest rather than a mutable tag, ensuring reproducible builds.

✅ Scope — Minimal and focused

Single-file, single-line change with a clear purpose. No unrelated modifications. No new public API surface detected.

Generated by Code Review for issue #127613 · ◷

[vcsjones]

Ah, okay, it is known that libmsquic is not available dotnet/dotnet-buildtools-prereqs-docker#1646

[richlander]

@wfurt @ahmedilyasms what's the best pattern here? Disable the test for Azure Linux 4 or build libmsquic in the helix image?

[wfurt]

@wfurt @ahmedilyasms what's the best pattern here? Disable the test for Azure Linux 4 or build libmsquic in the helix image?

yes, I think so. I did ping MsQuic team about this and submitted PR for Ubuntu 26 but it may take some time to get it actually out.