ci(windows): Improve vcpkg integration and error reporting (#15721)

This commit improves the reliability and debuggability of the Windows CMake builds.

- Explicitly pass overlay triplets to vcpkg.
- Add detailed error reporting for vcpkg install failures, including logging problematic packages.
- Enable universe_domain feature for Google Cloud C++.
- Set minimum CMake policy version to 3.5.

Author: jinseopkim0

ci/kokoro/windows/builds/cmake.ps1

@@ -43,9 +43,54 @@ if ($missing.count -ge 1) {
 $project_root = (Get-Item -Path ".\" -Verbose).FullName -replace "\\", "/"
 $vcpkg_root = Install-Vcpkg "${project_root}" ""
 $binary_dir="cmake-out/${BuildName}"
-# Install all dependencies from the vcpkg.json manifest file.
-# This mirrors the behavior of our GHA builds.
-& "${vcpkg_root}/vcpkg.exe" install --triplet "${env:VCPKG_TRIPLET}"
+
+# The VCPKG_ROOT env var is mismatched with the vcpkg we are running,
+# which causes vcpkg to ignore other env vars.
+# We'll unset them both and pass the overlay-triplets path manually.
+Remove-Item env:VCPKG_ROOT -ErrorAction SilentlyContinue
+Remove-Item env:VCPKG_OVERLAY_TRIPLETS -ErrorAction SilentlyContinue
+
+# Define the correct path to our custom triplets.
+$overlay_triplets_path = "${project_root}/ci/kokoro/windows/triplets"
+
+# Install all dependencies, now passing the overlay path on the command line
+& "${vcpkg_root}/vcpkg.exe" install --triplet "${env:VCPKG_TRIPLET}" --overlay-triplets="${overlay_triplets_path}"
+
+# Manually check the exit code. vcpkg might not be throwing a terminating error.
+if ($LastExitCode -ne 0) {
+    Write-Host -ForegroundColor Red "----------------------------------------------------------------"
+    Write-Host -ForegroundColor Red "vcpkg install FAILED with exit code $LastExitCode."
+    Write-Host -ForegroundColor Red "Dumping vcpkg buildtree logs for known failing packages..."
+    Write-Host -ForegroundColor Red "----------------------------------------------------------------"
+
+    # We'll check logs for *all* known problematic packages
+    $problem_packages = @("crc32c", "yaml-cpp")
+
+    foreach ($pkg in $problem_packages) {
+        Write-Host -ForegroundColor Magenta "--- Checking logs for $pkg ---"
+        $log1 = "${vcpkg_root}/buildtrees/${pkg}/config-x64-windows-static-out.log"
+        $log2 = "${vcpkg_root}/buildtrees/${pkg}/config-x64-windows-static-dbg-CMakeCache.txt.log"
+        $log3 = "${vcpkg_root}/buildtrees/${pkg}/config-x64-windows-static-rel-CMakeCache.txt.log"
+
+        foreach ($logFile in @($log1, $log2, $log3)) {
+            if (Test-Path $logFile) {
+                Write-Host -ForegroundColor Red "========= Contents of $logFile ========="
+                Get-Content $logFile
+                Write-Host -ForegroundColor Red "========= End of $logFile ========="
+            } else {
+                Write-Host -ForegroundColor Yellow "Log file not found, skipping: $logFile"
+            }
+        }
+    }
+
+    Write-Host -ForegroundColor Red "----------------------------------------------------------------"
+    Write-Host -ForegroundColor Red "Dumping complete. Forcing build failure."
+    Write-Host -ForegroundColor Red "----------------------------------------------------------------"
+    # Manually fail the build with the exit code from vcpkg
+    exit $LastExitCode
+}
+
+Write-Host -ForegroundColor Green "vcpkg install SUCCEEDED."
 
 $cmake_args=@(
     "-G$env:GENERATOR",
@@ -54,15 +99,23 @@ $cmake_args=@(
     "-DCMAKE_TOOLCHAIN_FILE=`"${vcpkg_root}/scripts/buildsystems/vcpkg.cmake`""
     "-DCMAKE_BUILD_TYPE=${env:CONFIG}",
     "-DVCPKG_TARGET_TRIPLET=${env:VCPKG_TRIPLET}",
+    "-DVCPKG_OVERLAY_TRIPLETS=${project_root}/ci/kokoro/windows/triplets",
     "-DCMAKE_C_COMPILER=cl.exe",
     "-DCMAKE_CXX_COMPILER=cl.exe",
     "-DGOOGLE_CLOUD_CPP_ENABLE_WERROR=ON",
     "-DGOOGLE_CLOUD_CPP_ENABLE_CTYPE_CORD_WORKAROUND=ON",
-    "-DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded$<$<CONFIG:Debug>:Debug>"
+    "-DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded$<$<CONFIG:Debug>:Debug>",
+    "-DGOOGLE_CLOUD_CPP_ENABLE=universe_domain"
 )
 
 # Configure CMake and create the build directory.
 Write-Host -ForegroundColor Yellow "`n$(Get-Date -Format o) Configuring CMake with $cmake_args"
+
+# The VCPKG_ROOT env var is mismatched with the vcpkg we are running,
+# which causes vcpkg to ignore other env vars.
+# Unset the env var just before the cmake call, which also calls vcpkg.
+Remove-Item env:VCPKG_ROOT -ErrorAction SilentlyContinue
+
 cmake $cmake_args
 if ($LastExitCode) {
     Write-Host -ForegroundColor Red "cmake config failed with exit code $LastExitCode"

ci/kokoro/windows/triplets/x64-windows-static.cmake

@@ -4,3 +4,5 @@ set(VCPKG_LIBRARY_LINKAGE static)
 set(VCPKG_VISUAL_STUDIO_PATH
     "C:\\Program Files (x86)\\Microsoft Visual Studio\\$ENV{MSVC_VERSION}\\BuildTools"
 )
+set(VCPKG_CMAKE_CONFIGURE_OPTIONS
+    "${VCPKG_CMAKE_CONFIGURE_OPTIONS};-DCMAKE_POLICY_VERSION_MINIMUM=3.5")