Enhance appveyor.yml and build scripts

This commit makes a temporary change to the Build.ps1 script which needs to be
reverted once the build is successful.

Author: ThomasBarnekow

Build.ps1

@@ -99,10 +99,6 @@ CheckLastExitCode
 dotnet build -c Release
 CheckLastExitCode
 
-.\start-cosmos-db-emulator.ps1
-getcontent .\nohup.out
-CheckLastExitCode
-
 # RunInspectCode
 # RunCleanupCode
 

appveyor.yml

@@ -35,6 +35,7 @@ for:
     - image: Visual Studio 2019
   services:
   - postgresql13
+  - docker
   # REF: https://github.com/docascode/docfx-seed/blob/master/appveyor.yml
   before_build:
     - pwsh: |
@@ -48,6 +49,34 @@ for:
         if ($lastexitcode -ne 0) {
             throw "docfx install failed with exit code $lastexitcode."
         }
+    - sh: |
+        # Pull Azure Cosmos Emulator Docker image
+        echo "Pulling Azure Cosmos Emulator Docker image for Linux ..."
+        ./pull-docker-azure-cosmos-emulator-linux.sh
+
+        # Start Azure Cosmos Emulator container
+        echo "Running Azure Cosmos Emulator Docker container ..."
+        nohup ./run-docker-azure-cosmos-emulator-linux.sh &
+
+        # Wait for Docker container being started in the background
+        echo "Waiting 60 seconds before trying to download Azure Cosmos Emulator SSL certificate ..."
+        sleep 60
+
+        # Print the background process output to see whether there are any errors
+        if [ -f "./nohup.out" ]; then
+            echo "--- BEGIN CONTENTS OF NOHUP.OUT ---"
+            cat ./nohup.out
+            echo "--- END CONTENTS OF NOHUP.OUT ---"
+        fi
+
+        # Install SSL certificate to be able to access the emulator
+        echo "Installing Azure Cosmos Emulator SSL certificate ..."
+        sudo ./install-azure-cosmos-emulator-linux-certificates.sh
+    - pwsh: |
+        # Start Azure Cosmos Emulator on Windows
+        if ($isWindows) {
+            .\start-cosmos-db-emulator.ps1
+        }
   after_build:
     - pwsh: |
         CD ./docs

install-azure-cosmos-emulator-linux-certificates.sh

@@ -27,4 +27,5 @@ then
   sudo update-ca-certificates
 else
   echo "Could not download CA certificate!"
+  false
 fi

pull-docker-azure-cosmos-emulator-linux.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+# Pull the azure-cosmos-emulator Docker image for Linux from the registry.
+docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator

run-docker-azure-cosmos-emulator-linux.sh

@@ -4,9 +4,6 @@
 # This step is required when Direct mode setting is configured using Cosmos DB SDKs.
 ipaddr="`ifconfig | grep "inet " | grep -Fv 127.0.0.1 | awk '{print $2}' | head -n 1`"
 
-# Pull the azure-cosmos-emulator Docker image for Linux from the registry.
-docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator
-
 # Run the image, creating a container called "azure-cosmos-emulator-linux".
 docker run \
   -p 8081:8081 \

start-cosmos-db-emulator.ps1

@@ -2,32 +2,38 @@
 
 function StartCosmosDbEmulator {
     if ($PSVersionTable.Platform -eq "Unix") {
-        StartCosmosDbEmulatorDockerContainer
+        StartCosmosDbEmulatorOnLinux
     }
     else {
-        StartCosmosDbEmulatorForWindows
+        StartCosmosDbEmulatorOnWindows
     }
 }
 
-function StartCosmosDbEmulatorDockerContainer {
-    Write-Host "Starting Cosmos DB Emulator Docker container ..."
-    Start-Process nohup 'bash ./run-docker-azure-cosmos-emulator-linux.sh'
+function StartCosmosDbEmulatorOnLinux {
+    Remove-Item .\nohup.*
 
-    Write-Host "Waiting for Cosmos DB Emulator Docker container to start up ..."
-    Start-Sleep -Seconds 30
-    WaitUntilCosmosSqlApiEndpointIsReady
+    Write-Host "Running Azure Cosmos Emulator Docker container ..."
+    Start-Process nohup './run-docker-azure-cosmos-emulator-linux.sh'
+    Start-Sleep -Seconds 1
+
+    Write-Host "Waiting 60 seconds before trying to download Azure Cosmos Emulator SSL certificate ..."
+    Start-Sleep -Seconds 60
+
+    Write-Host "--- BEGIN CONTENTS OF NOHUP.OUT ---"
+    Get-Content .\nohup.out
+    Write-Host "--- END CONTENTS OF NOHUP.OUT ---"
 
-    Write-Host "Installing Cosmos DB Emulator certificates ..."
-    Start-Sleep -Seconds 30
-    Start-Process nohup 'bash ./install-azure-cosmos-emulator-linux-certificates.sh'
+    Write-Host "Installing Azure Cosmos Emulator SSL certificate ..."
+    Start-Process bash './install-azure-cosmos-emulator-linux-certificates.sh' -Wait
+    Write-Host "Installed Azure Cosmos Emulator SSL certificate."
 }
 
-function StartCosmosDbEmulatorForWindows {
+function StartCosmosDbEmulatorOnWindows {
     Write-Host "Starting Cosmos DB Emulator for Windows ..."
     Start-Process -FilePath "C:\Program Files\Azure Cosmos DB Emulator\Microsoft.Azure.Cosmos.Emulator.exe" -ArgumentList "/DisableRateLimiting /NoUI /NoExplorer"
 
-    Write-Host "Waiting for Cosmos DB Emulator for Windows to start up ..."
-    Start-Sleep -Seconds 10
+    Write-Host "Waiting for Azure Cosmos Emulator for Windows to start up ..."
+    Start-Sleep -Seconds 20
     WaitUntilCosmosSqlApiEndpointIsReady
 }
 
@@ -45,6 +51,7 @@ function WaitUntilCosmosSqlApiEndpointIsReady {
         catch {
             $client.Close()
             if($attempt -eq $max) {
+                Write-Host "Cosmos SQL API endpoint is not listening. Aborting connection."
                 throw "Cosmos SQL API endpoint is not listening. Aborting connection."
             } else {
                 [int]$sleepTime = 5 * (++$attempt)