It seems that I’m a little behind on what has changed in Azure DevOps Server recently. While helping my team migrate our existing build servers to some new infrastructure, we encountered a problem when trying to download the agent binaries.
When trying to download the agent binaries (available through Collection Settings –> Agent pools –> Default pool –> Agents –> New agent), it failed with a 404.
The URL used was:
Now if you are unlike me, you have probably followed up all Azure DevOps related announcement so you didn’t miss this announcement mentioning:
The current content delivery network (CDN) provider Edgio, used by Azure DevOps is retiring. We’re urgently transitioning to a solution served by Akamai and Azure Front Door CDNs to maintain the responsiveness of our services.
Whoops! I certainly missed that one…
The new URL is this:
https://download.agent.dev.azure.com/agent/3.238.0/vsts-agent-win-x64-3.238.0.zip
The recommended way to fix this problem is by applying the correct patch depending on your Azure DevOps server version:
- Azure DevOps Server 2022.2: Azure DevOps Server 2022.2 Patch 5
- Azure DevOps Server 2020.1.2: Azure DevOps Server 2020.1.2 Patch 16
- Azure DevOps Server 2019.1.2: Azure DevOps Server 2019.1.2 Patch 11
Remark: For Azure DevOps Server 2022.2 a Patch 6 is already available but there are some issues mentioned about this patch version, so it is best to stick to Patch 5 for the moment.
More information
Deploy an Azure Pipelines agent on Windows - Azure Pipelines | Microsoft Learn
CDN Domain URL change for Agents in Pipelines - Azure DevOps Blog