No VCPKG_INSTALLATION_ROOT; find vcpkg.exe

Author: florelis

azure-pipelines.yml

@@ -83,12 +83,10 @@ jobs:
       feedsToUse: 'config'
       nugetConfigPath: '$(nugetConfig)'
 
-  - task: CmdLine@2
-    displayName: Enable Vcpkg Install
+  - task: PowerShell@2
+    displayName: Find and Integrate Vcpkg
     inputs:
-      script: |
-        $(VCPKG_INSTALLATION_ROOT)\vcpkg.exe integrate install
-      workingDirectory: '$(VCPKG_INSTALLATION_ROOT)'
+      filePath: 'templates\Find-AndIntegrate-Vcpkg.ps1'
 
   - task: VSBuild@1
     displayName: Build Fuzzing Artifacts
@@ -99,14 +97,6 @@ jobs:
       msbuildArgs: '/bl:$(artifactsDir)\msbuild.binlog'
       maximumCpuCount: true
 
-  - task: CopyFiles@2
-    displayName: Copy vcpkg logs
-    inputs:
-      SourceFolder: $(VCPKG_INSTALLATION_ROOT)\buildtrees
-      Contents: '**\*.log'
-      TargetFolder: '$(artifactsDir)\vcpkgLogs'
-    condition: succeededOrFailed()
-
   - task: CopyFiles@2
     displayName: Copy Fuzzing Artifacts for Publishing
     inputs:

templates/Find-AndIntegrate-Vcpkg.ps1

@@ -0,0 +1,38 @@
+$ErrorActionPreference = 'Stop'
+
+Write-Host 'PATH entries:'
+$env:PATH -split ';' | ForEach-Object { Write-Host $_ }
+
+$pathMatches = @(Get-Command vcpkg.exe -CommandType Application -All -ErrorAction SilentlyContinue |
+    Select-Object -ExpandProperty Source)
+Write-Host 'vcpkg.exe matches on PATH:'
+$pathMatches | ForEach-Object { Write-Host $_ }
+
+$diskMatches = @()
+$searchRoots = Get-PSDrive -PSProvider FileSystem |
+    Where-Object { $_.Root -match '^[A-Za-z]:\\$' -and -not $_.DisplayRoot } |
+    Select-Object -ExpandProperty Root -Unique
+
+foreach ($root in $searchRoots)
+{
+    Write-Host "Searching $root for vcpkg.exe (inaccessible directories are skipped)..."
+    $diskMatches += @(Get-ChildItem -LiteralPath $root -Filter vcpkg.exe -File -Recurse -ErrorAction SilentlyContinue |
+        Select-Object -ExpandProperty FullName)
+}
+
+$candidates = @($pathMatches + ($diskMatches | Sort-Object) | Select-Object -Unique)
+Write-Host 'All discovered vcpkg.exe paths (PATH matches first):'
+$candidates | ForEach-Object { Write-Host $_ }
+
+if ($candidates.Count -eq 0)
+{
+    throw 'No vcpkg.exe found on PATH or local drives.'
+}
+
+$vcpkg = $candidates[0]
+Write-Host "Running: `"$vcpkg`" integrate install"
+& $vcpkg integrate install
+if ($LASTEXITCODE -ne 0)
+{
+    throw "vcpkg integrate install failed with exit code $LASTEXITCODE."
+}

templates/README.md

@@ -53,12 +53,9 @@ Paths that belong to the agent or to the build output are deliberately **not** r
 they do not move with the subtree:
 
 - `$(Build.ArtifactStagingDirectory)`, `$(Pipeline.Workspace)`
-- `$(Agent.TempDirectory)`, `$(VCPKG_INSTALLATION_ROOT)`
+- `$(Agent.TempDirectory)`
 - `$(buildOutDir)`, `$(buildOutDirAnyCpu)`, `$(artifactsDir)`, `$(packageLayoutDir)`
 
-`$(VCPKG_INSTALLATION_ROOT)` is the exception worth calling out: it is correctly *not* rooted, but a
-consumer may not use the installation it points at. See `useAgentVcpkg` below.
-
 Nested template references need no help. Azure Pipelines resolves a `- template:` reference inside a
 template file relative to *that file*, so the job templates find their siblings at any depth. Only
 the entry point has to know where the subtree lives.
@@ -84,8 +81,7 @@ is neither a parameter nor a path in this directory.
 **Pipeline variables.** None. `jobs-build.yml` sets what it needs at job scope — `solution`, so it
 can be rooted, and `EnableDetectorVcpkg`, so Component Governance detects the vcpkg dependencies.
 
-**A Windows agent** with Visual Studio 2022 and vcpkg, exposing `VCPKG_INSTALLATION_ROOT`. The
-Microsoft-hosted `windows-2025` image qualifies. **The `Test` and `BuildPowerShellModule` jobs need
+**A Windows agent** with Visual Studio 2022 and vcpkg. **The `Test` and `BuildPowerShellModule` jobs need
 more than the `Build` job does — see "Agent requirements" below.**
 
 **Outbound network access.** The test jobs reach several public endpoints, which is worth checking
@@ -194,24 +190,6 @@ does not even build.
       /p:UseProdCLSIDs=false
 ```
 
-## `useAgentVcpkg`
-
-Defaults to `true`, matching the Microsoft-hosted images, where `VCPKG_INSTALLATION_ROOT` points at
-a real vcpkg installation that this pipeline integrates and builds the native dependencies with.
-
-Set it to `false` when the consuming repository supplies vcpkg some other way — for example through
-an MSBuild SDK that restores the ports itself. `VCPKG_INSTALLATION_ROOT` may well still be defined in
-that case, since the agent image sets it, but nothing builds there. Two steps then become
-meaningless and are dropped together:
-
-- *Enable Vcpkg Install*, which integrates an installation the build does not use.
-- *Copy vcpkg logs*, which reads `$(VCPKG_INSTALLATION_ROOT)\buildtrees` — a directory that will not
-  exist, failing the job after a successful build.
-
-Dropping the log collection loses no real diagnostics: `Build Solution` writes an MSBuild binary log
-to `$(artifactsDir)\msbuild.binlog`, which is published with the rest of the build artifacts and
-records the vcpkg invocation and its output.
-
 ## `releaseTagJob`
 
 `jobs-build.yml` stamps a build version obtained from a separate job. That job is named by the

templates/jobs-build.yml

@@ -24,13 +24,6 @@ parameters:
 - name: additionalMSBuildArgs
   type: string
   default: ''
-# Whether the agent's own vcpkg installation, at VCPKG_INSTALLATION_ROOT, is what builds the native
-# dependencies. Set to false when a consuming repository supplies vcpkg by other means, such as an
-# MSBuild SDK; the integrate step and the port log collection below are then both meaningless,
-# because that variable points at an installation this build never uses.
-- name: useAgentVcpkg
-  type: boolean
-  default: true
 # Agent pool for this job. Leave empty to inherit the pipeline's pool, which is what a pipeline
 # with a single suitable pool wants. See the "Agent requirements" section of README.md.
 - name: pool
@@ -126,13 +119,10 @@ jobs:
       feedsToUse: 'config'
       nugetConfigPath: '$(nugetConfig)'
 
-  - ${{ if parameters.useAgentVcpkg }}:
-    - task: CmdLine@2
-      displayName: Enable Vcpkg Install
-      inputs:
-        script: |
-          $(VCPKG_INSTALLATION_ROOT)\vcpkg.exe integrate install
-        workingDirectory: '$(VCPKG_INSTALLATION_ROOT)'
+  - task: PowerShell@2
+    displayName: Find and Integrate Vcpkg
+    inputs:
+      filePath: '${{ parameters.sourceRoot }}\templates\Find-AndIntegrate-Vcpkg.ps1'
 
   - ${{ if ne(parameters.releaseTagJob, '') }}:
     - task: PowerShell@2
@@ -180,15 +170,6 @@ jobs:
                          ${{ parameters.additionalMSBuildArgs }}'
       maximumCpuCount: true
 
-  - ${{ if parameters.useAgentVcpkg }}:
-    - task: CopyFiles@2
-      displayName: Copy vcpkg logs
-      inputs:
-        SourceFolder: $(VCPKG_INSTALLATION_ROOT)\buildtrees
-        Contents: '**\*.log'
-        TargetFolder: '$(artifactsDir)\vcpkgLogs'
-      condition: succeededOrFailed()
-
   - task: CopyFiles@2
     displayName: 'Copy specific build artifacts'
     inputs: