Support installation of sqlcmd

Author: andyundso

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: Continuous Integration
+
+on:
+  pull_request:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Tests
+    strategy:
+      matrix:
+        os:
+          # ignore ARM64 flavours
+          - macos-12-large
+          - macos-13-large
+          - macos-14-large
+          - ubuntu-20.04
+          - ubuntu-22.04
+          - ubuntu-24.04
+          - windows-2019
+          - windows-2022
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      # cloning into "root" does not work when trying to call the action from itself
+      # inspired by Microsoft: https://github.com/microsoft/action-python/blob/c8ec939994d7ed2ec77b7bbe59ed5f5b72fb5607/.github/workflows/test.yml#L21
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          path: action
+          clean: true
+
+      - name: Run Action
+        uses: ./action
+        with:
+          components: sqlcmd
+
+      - name: Run tests
+        run: |
+          action/test.ps1
+        shell: pwsh

action.yml

@@ -0,0 +1,19 @@
+name: "Setup MSSQL"
+branding:
+  icon: "database"
+  color: "yellow"
+description: "Installs an MSSQL server and client"
+inputs:
+  components:
+    description: "The components to install"
+    required: true
+runs:
+  using: "composite"
+  steps:
+    - shell: pwsh
+      run: |
+        $params = @{
+            Components = ("${{ inputs.components }}" -split ",").Trim()
+        }
+
+        ${{ github.action_path }}/install.ps1 @params

install.ps1

@@ -0,0 +1,33 @@
+param (
+    [ValidateSet("sqlcmd")]
+    [string[]]$Components
+)
+
+if ("sqlcmd" -in $Components) {
+    if ($IsMacOS) {
+        Write-Output "Installing sqlcmd tools"
+        brew install sqlcmd
+    }
+
+    if ($IsLinux) {
+        $osRelease = Get-Content -Path "/etc/os-release" | Out-String
+        $osRelease -match 'VERSION_ID="(\d+\.\d+)"'
+        $version = $matches[1]
+
+        Write-Debug $version
+
+        if ($version -eq "24.04") {
+            # for maintenance reasons, sqlcmd has been removed from the runner image
+            # but a dedicated build is also not yet available, so we are using the Ubuntu 22.04 build
+            Write-Output "Installing sqlcmd tools"
+
+            $DownloadPath = "/tmp/sqlcmd.deb"
+            Invoke-WebRequest "https://packages.microsoft.com/ubuntu/22.04/prod/pool/main/s/sqlcmd/sqlcmd_1.5.0-1_jammy_all.deb" -OutFile $DownloadPath
+            & dpkg -i $DownloadPath
+            Remove-Item $DownloadPath
+        }
+    }
+
+    # Linux and Windows runner already contain sqlclient tools
+    Write-Output "sqlclient tools are installed"
+}

test.ps1

@@ -0,0 +1,6 @@
+if (Get-Command sqlcmd -ErrorAction SilentlyContinue) {
+    Write-Output "sqlcmd command exists."
+} else {
+    Write-Output "sqlcmd command does not exist."
+    exit 1
+}