Merge pull request #8068 from MicrosoftDocs/users/sdanie/446363

Update to agent v4

Author: prmerger-automator[bot]

docs/pipelines/agents/v3-agent.md

@@ -3,13 +3,17 @@ title: Agent software version 3
 description: Learn how to run pipelines using the version 3 agent software.
 monikerRange: '>= azure-devops-2022'
 ms.topic: conceptual
-ms.date: 06/27/2025
+ms.date: 06/30/2025
 ---
 
 # Agent software version 3
 
 > [!IMPORTANT]
-> Agent software version 3 (using .NET 6) is unsupported for Azure DevOps Services, and the Azure Pipelines team recommends you upgrade to [Agent software version 4](./v4-agent.md) (using .NET 8). If you're running your self-hosted agents on an operating system that isn't supported by .NET 8, you must update your machines to use a newer supported operating system [supported by .NET 8](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#net-8---supported-os-versions). 
+> Agent software version 3 (using .NET 6) is unsupported for Azure DevOps Services, and the Azure Pipelines team recommends you upgrade to [Agent software version 4](./v4-agent.md) (using .NET 8). 
+>
+> To update your self-hosted agents to version 4, see [Upgrade to agent software version 4](./v4-agent.md#upgrade-to-4x-agent-on-supported-operating-systems).
+>
+> If you're running your self-hosted agents on an operating system that isn't supported by .NET 8, you must update your machines to use a newer supported operating system [supported by .NET 8](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#net-8---supported-os-versions). For more information, see [Upgrade to agent software version 4 on unsupported operating systems](./v4-agent.md#upgrade-to-4x-agent-on-unsupported-operating-systems).
 
 The pipelines team is upgrading the agent software from version 2.x (using .NET Core 3.1) to version 3.x (using .NET 6). The new agent version supports new Apple silicon hardware and newer operating systems like Ubuntu 22.04, or Windows on ARM64.
 

docs/pipelines/agents/v4-agent.md

@@ -3,7 +3,7 @@ title: Agent software version 4
 description: Learn how to run pipelines using the version 4 agent software.
 monikerRange: 'azure-devops'
 ms.topic: conceptual
-ms.date: 11/27/2024
+ms.date: 06/30/2025
 ---
 
 # Agent software version 4
@@ -15,6 +15,8 @@ The pipelines team is upgrading the agent software from version 3.x to version 4
 
 If you're running your self-hosted agents on newer operating systems [supported by .NET 8](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#net-8---supported-os-versions), the upgrade to the new agent version is automatic.
 
+To manually initiate the update, see [Update self-hosted agents](./agents.md#to-update-self-hosted-agents).
+
 The following operating systems are supported by the 4.x agent.
 
 > [!NOTE]
@@ -54,7 +56,7 @@ The following operating systems are supported by the 4.x agent.
 
 ## Upgrade to 4.x agent on unsupported operating systems
 
-If you're running your self-hosted agents on an operating system that isn't supported by .NET 8, you must update your machines to use a newer supported operating system [supported by .NET 8](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#net-8---supported-os-versions).
+If you're running your self-hosted agents on an operating system that isn't supported by .NET 8, you must update your machines to use a newer supported operating system [supported by .NET 8](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#net-8---supported-os-versions). After updating, see [Update self-hosted agents](./agents.md#to-update-self-hosted-agents) for instructions on how to update your agents to the 4.x version.
 
 The following list of operating systems were supported for self-hosted 3.x agents, but aren't supported by .NET 8 and can't be used to run version 4.x agents.