system-pre-steps.yml evaluated to an empty steps: [], so it did not inject an executable step; the Agent.Version -gtVersion 5.279.0 demand is being generated elsewhere during server-side job preparation, and there is no documented pipeline-YAML mechanism for cancelling that generated demand.
What the log establishes
- The GUID
[GUID]is the built-incheckoutoperation. Decorators evaluate tasks after keywords have been resolved to GUIDs.^1^ -
steps: []proves only that this decorator invocation added no steps. It does not identify which server component added the version demand. - Azure DevOps can generate a minimum-agent demand for advanced checkout, but the documented conditions are multiple checkout steps, checkout not being first, or checking out something other than
selfornone. Yourcheckout: nonedoes not meet those documented conditions.^2^ - Azure DevOps Server 2022.2 normally corresponds to agent
3.238.0. Version 5.x support for Server 2020 and later depends on corresponding server updates. Therefore, a demand above5.279.0on Server 2022.2 is not something to resolve by blindly installing a 5.x agent.^3^
Adding this cannot override the generated requirement:
demands:
- Agent.Name -equals '[name]'
- Agent.Version -equals 4.275.0
It merely requires the agent to satisfy both Agent.Version = 4.275.0 and Agent.Version > 5.279.0, which is impossible. Demands are used to select agents whose reported capabilities meet the job requirements.^4^
Least-disruptive server-side checks
These actions require a project-collection or Azure DevOps Server administrator.
- Record the exact Server 2022.2 patch level.
- Check the installed Azure DevOps Server build/version, not only “2022.2.”
- Compare it with the Server 2022 Update 2 release notes. Patch 12 is the latest listed servicing patch as of August 11, 2026.^5^
- If behind, schedule the supported cumulative servicing update and rerun the minimal pipeline.
Agent.Version -gtVersion 5.279.0. - Inventory collection-installed extensions before changing anything.
- Open the Azure DevOps Server collection gallery:
http://{server}:8080/tfs/_gallery/manage - Identify private extensions and inspect their manifests for a contribution with:
{ "type": "ms.azure-pipelines.pipeline-decorator" } - Pipeline decorators can inject steps across all pipelines in a collection, and only private extensions can contribute decorators.^6^
- Open the Azure DevOps Server collection gallery:
- Only if such an extension exists, isolate it safely.
- Prefer a non-production collection.
- Remove or disable one candidate at a time, then rerun the minimal pipeline.
- For Azure DevOps Server, use the extension’s … menu and select Remove.^7^
- Restore it if the demand remains.
This is source isolation, not an assertion that a private extension caused the demand. system-pre-steps.yml may also be an internal server-provided template.
If 5.x is genuinely required
Do not attempt agent 5.x on the current host unless its exact OS version supports .NET 10. Microsoft documents SLES 15.7 and 16.0 as supported for 5.x; earlier SLES versions may require migration. The 5.x runtime is self-contained, so separately installing .NET 10 does not make an unsupported OS supported.^3^
The supported route is:
- Provision a .NET 10-supported OS.
- Confirm that the installed Azure DevOps Server servicing level supports the required agent generation.
- Register the replacement agent in the pool.
- Verify Agent pools → pool → agent → Capabilities →
Agent.Version. - Retire the old agent only after a test pipeline succeeds.
Escalation
If the demand remains on a fully serviced Server 2022.2 instance with no private pipeline decorators, open a Microsoft support case. Include:
- Exact server build and patch level.
- Minimal YAML.
- Complete Job preparation parameters and final runtime YAML.
- Agent capability export showing
Agent.Version. - Installed-extension inventory.
- Confirmation that
checkout: nonestill producesAgent.Version -gtVersion 5.279.0.
That combination demonstrates a reproducible server-generated demand inconsistent with the documented Server 2022.2 agent generation and removes the repository YAML and private decorators as likely sources.
References