Azure Pipeline中Cosmos DB Emulator启动过慢问题及优化咨询

我们在Azure DevOps Pipeline执行集成测试时，用以下PowerShell任务在dotnet test前启动Cosmos DB Emulator：

- task: PowerShell@2
  displayName: "Starting Cosmos Emulator for Integration Tests"
  inputs:
    targetType: "inline"
    workingDirectory: $(Pipeline.Workspace)
    script: |
      Write-Host "Starting CosmosDB Emulator"                
      Import-Module "$env:ProgramFiles\Azure Cosmos DB Emulator\PSModules\Microsoft.Azure.CosmosDB.Emulator"
      $startEmulatorCmd = "Start-CosmosDbEmulator -NoFirewall -NoUI -Timeout 900"
      Invoke-Expression -Command $startEmulatorCmd

注：我们使用windows-latest镜像。

Cosmos DB Emulator启动时长不稳定，有时约2分钟（可接受），有时约4分钟超时，因此我将超时时间设为15分钟，但仍偶发超时。

现咨询以下问题：

1. 是否有更可靠的集成测试运行Cosmos DB Emulator的方式？
2. 是否应切换至自托管代理以提升性能？
3. 当前情况还有其他解决办法吗？

问题1：更可靠的启动方式 #

• 改用官方任务替代手动脚本：Azure DevOps提供官方的AzureCosmosDBEmulator@2任务，内置了完善的健康检查和重试逻辑，比手动调用PowerShell模块稳定性更高。示例配置：

  - task: AzureCosmosDBEmulator@2
    displayName: 'Start Cosmos DB Emulator'
    inputs:
      enableApi: 'SQL'
      port: 8081
      noUI: true
      noFirewall: true
      timeout: 15
  

• 添加启动后健康检查：如果坚持使用现有脚本，启动后循环调用Emulator的健康检查端点（如http://localhost:8081/_explorer/emulator.pem），直到返回成功再执行测试，避免Emulator未完全就绪就跑测试的隐性问题。示例脚本片段：

  do {
      $healthCheck = try { Invoke-RestMethod -Uri "http://localhost:8081/_explorer/emulator.pem" -ErrorAction Stop } catch { $false }
      Start-Sleep -Seconds 10
  } while (-not $healthCheck)
  

• 禁用非必要组件：启动时添加-DisableRateLimiting参数减少资源消耗；若仅用到SQL API，无需启用MongoDB、Gremlin等其他API，进一步降低启动负载。

问题2：是否切换自托管代理 #

如果测试对稳定性要求高，切换自托管代理是值得考虑的方案：

• 微软托管的windows-latest代理是共享资源，虚拟机的CPU、内存波动大，这是启动时长不稳定的核心原因之一。自托管代理使用专属硬件资源，可配置更高的CPU和内存，启动速度会更稳定。
• 但自托管代理需要自行维护（更新系统、Emulator版本、处理硬件故障），若团队无运维资源，需权衡维护成本。

问题3：其他解决办法 #

• 预初始化并缓存镜像：使用自托管代理时，可预先启动一次Emulator完成初始化，或使用预装Emulator并完成首次初始化的自定义Windows镜像，Emulator首次启动需初始化大量数据，后续启动速度会显著提升。
• 调整测试并行度：若集成测试并行运行，减少并行测试数量，避免同时占用过多资源导致Emulator启动变慢。
• 升级Emulator版本：旧版本Emulator可能存在启动性能问题，定期更新至最新版本，微软会持续优化启动速度和稳定性。
• 选用更高配置的托管代理：使用微软托管代理时，可指定更高配置的虚拟机（如windows-2022-large），比默认的windows-latest拥有更多资源，能提升启动速度的稳定性。

内容的提问来源于stack exchange，提问作者Fabian Bigler