Passing on a clean machine

Author: stuartpa

AgentMode/.github/copilot-instructions.md

@@ -81,9 +81,11 @@ NOTES:
 
 **Action:**
 - Ensure a container runtime (e.g. docker or podman) is running by running `./.github/tsql/install/is-container-runtime-running.ps1`
+  - If a container runtime is not running, ensure the user does not proceed until a container runtime is installed and running.
 - Ensure `sqlcmd` is installed by running `./.github/tsql/install/ensure-sqlcmd-installed.ps1`
 - Ensure `Build.Sql.Templates` is installed by running `./.github/tsql/install/ensure-build-sql-templates-installed.ps1`
 - Ensure `SqlPackage` is installed by running `./.github/tsql/install/ensure-sqlpackage-installed.ps1`
+  - NOTE: If the following message is returned after installing `SqlPackage`: `Since you just installed the .NET SDK, you will need to reopen the Command Prompt window before running the tool you installed.`, run `exit` in the terminal window, so another terminal window will be created for the next command.
 
 ### Step 2: Create a Local SQL Server Instance
 

AgentMode/.github/tsql/install/is-container-runtime-running.ps1

@@ -1,25 +1,46 @@
 # A powershell script for Windows to check if any desktop container runtime is available and running
 
+function Write-ContainerRuntimeInstructions {
+    Write-Host "To install a container runtime, please visit the following links:"
+    Write-Host "- Docker Desktop: https://www.docker.com/products/docker-desktop"
+    Write-Host "- Podman Desktop: https://podman-desktop.io/"
+    Write-Host "Please install one of these runtimes and try again."
+}
+
 # Check if Docker Desktop is running
+$dockerAvailable = $false
+$dockerRunning = $false
 if (Get-Command "docker" -ErrorAction SilentlyContinue) {
-    $dockerStatus = & docker info --format '{{.ServerVersion}}'
+    $dockerAvailable = $true
+    $dockerStatus = & docker info --format '{{.ServerVersion}}' 2>$null
     if ($dockerStatus) {
         Write-Host "Docker Desktop is running."
         exit 0
     } else {
         Write-Host "Docker Desktop is not running."
-        exit 1
     }
 }
 
 # Check if Podman Desktop is running
+$podmanAvailable = $false
+$podmanRunning = $false
 if (Get-Command "podman" -ErrorAction SilentlyContinue) {
-    $podmanStatus = & podman info --format '{{.ServerVersion}}'
+    $podmanAvailable = $true
+    $podmanStatus = & podman info --format '{{.ServerVersion}}' 2>$null
     if ($podmanStatus) {
         Write-Host "Podman Desktop is running."
         exit 0
     } else {
         Write-Host "Podman Desktop is not running."
-        exit 1
     }
 }
+
+if (-not $dockerAvailable -and -not $podmanAvailable) {
+    Write-Error "The `docker` and `podman` commands are not available"
+    Write-ContainerRuntimeInstructions
+    exit 1
+}
+
+Write-Error "No container runtime is running."
+Write-ContainerRuntimeInstructions
+exit 1