SqlServerDsc: Initial integration tests for commands

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - SqlServerDsc
   - Added build tasks to generate Wiki documentation for public commands.
+  - Initial integration tests for commands.
 - SqlDatabaseMail
   - Added the parameter `UseDefaultCredentials` to control use of the DatabaseEngine
     service account for SMTP server authentication.

azure-pipelines.yml

@@ -244,9 +244,10 @@ stages:
           - powershell: |
               ./build.ps1 -Tasks test -CodeCoverageThreshold 0 -PesterTag $(TEST_CONFIGURATION) -PesterPath @(
                   # Run the integration tests in a specific group order.
+                  # Group 0
+                  'tests/Integration/Commands/Prerequisites.Integration.Tests.ps1'
                   # Group 1
                   'tests/Integration/Commands/Install-SqlDscServer.Integration.Tests.ps1'
-                  # Group 2
                   #'tests/Integration/Commands/Install-SqlDscReportingServices.Integration.Tests.ps1'
               )
             name: test

source/Public/Save-SqlDscSqlServerMedia.ps1

@@ -0,0 +1,141 @@
+<#
+    .SYNOPSIS
+        Downloads SQL Server media from a provided URL and saves the downloaded
+        media file to the specified file path
+
+    .DESCRIPTION
+        The Save-SqlDscSqlServerMedia function downloads SQL Server media from a
+        provided URL and saves the downloaded media file to the specified file path.
+
+        If the URL ends with ".exe", it is treated as an executable that downloads
+        an ISO. If it doesn't, it is treated as a direct link to an ISO.
+
+        The function also prints the SHA1 hash of the downloaded file.
+
+    .PARAMETER MediaUrl
+        The URL of the SQL Server media to download.
+
+    .PARAMETER DestinationPath
+        The file path where the downloaded media file should be saved.
+
+    .PARAMETER FileName
+        The file name of the downloaded media file. Defaults to media.iso if not
+        provided.
+
+    .PARAMETER Quiet
+        Disables verbose progress output during the download process.
+
+    .EXAMPLE
+        Save-SqlServerMedia -MediaUrl 'https://download.microsoft.com/download/c/c/9/cc9c6797-383c-4b24-8920-dc057c1de9d3/SQL2022-SSEI-Dev.exe' -DestinationPath 'C:\path\to\destination'
+
+        This downloads the SQL Server 2022 media and saves it to the specified destination path.
+
+    .EXAMPLE
+        Save-SqlServerMedia -MediaUrl 'https://download.microsoft.com/download/d/a/2/da259851-b941-459d-989c-54a18a5d44dd/SQL2019-SSEI-Dev.exe' -DestinationPath 'C:\path\to\destination'
+
+        This downloads the SQL Server 2019 media and saves it to the specified destination path.
+
+    .EXAMPLE
+        Save-SqlServerMedia -MediaUrl 'https://download.microsoft.com/download/E/F/2/EF23C21D-7860-4F05-88CE-39AA114B014B/SQLServer2017-x64-ENU.iso' -DestinationPath 'C:\path\to\destination'
+
+        This downloads the SQL Server 2017 media and saves it to the specified destination path.
+
+    .EXAMPLE
+        Save-SqlServerMedia -MediaUrl 'https://download.microsoft.com/download/9/0/7/907AD35F-9F9C-43A5-9789-52470555DB90/ENU/SQLServer2016SP1-FullSlipstream-x64-ENU.iso' -DestinationPath 'C:\path\to\destination'
+
+        This downloads the SQL Server 2016 media and saves it to the specified destination path.
+#>
+function Save-SqlDscSqlServerMedia
+{
+    [CmdletBinding()]
+    [OutputType([System.IO.FileInfo])]
+    param
+    (
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $MediaUrl,
+
+        [Parameter(Mandatory = $true)]
+        [System.IO.FileInfo]
+        [ValidateScript({Test-Path $_ -PathType 'Container'})]
+        $DestinationPath,
+
+        [Parameter()]
+        [System.String]
+        $FileName = 'media.iso',
+
+        [Parameter()]
+        [System.Management.Automation.SwitchParameter]
+        $Quiet
+    )
+
+    # if ($Quiet.IsPresent)
+    # {
+    #     # By switching to 'SilentlyContinue' should theoretically increase the download speed.
+    #     $previousProgressPreference = $ProgressPreference
+    #     $ProgressPreference = 'SilentlyContinue'
+    # }
+
+    $destinationFilePath = Join-Path -Path $DestinationPath -ChildPath $FileName
+
+    Write-Verbose -Message "Downloading SQL Server media to '$destinationFilePath'"
+
+    Write-Verbose -Message "Start downloading the SQL Server media at $(Get-Date -Format 'yyyy-MM-dd hh:mm:ss')"
+
+    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+
+    if ($MediaUrl -match '\.exe$')
+    {
+        # Change the file extension of the destination file path to .exe
+        $destinationExecutableFilePath = [System.IO.Path]::ChangeExtension($destinationFilePath, 'exe')
+
+        # Download the executable that will be used to download the ISO media.
+        Invoke-WebRequest -Uri $MediaUrl -OutFile $destinationExecutableFilePath | Out-Null
+
+        Write-Verbose -Message 'Provided URL was an executable file. Using executable to download the media file.'
+
+        $executableArguments = @()
+
+        if ($Quiet.IsPresent)
+        {
+            Write-Verbose -Message 'Quiet mode enabled.'
+
+            $executableArguments += @(
+                '/Quiet'            )
+        }
+
+        if ($VerbosePreference -eq 'SilentlyContinue')
+        {
+            $executableArguments += @(
+                '/HideProgressBar'
+            )
+        }
+
+        $executableArguments += @(
+            '/ENU',
+            '/Action=Download',
+            '/Language=en-US',
+            '/MediaType=ISO',
+            "/MediaPath=$destinationFilePath"
+        )
+
+        $startProcessArgumentList = $executableArguments -join ' '
+
+        # Download ISO media using the downloaded executable.
+        Start-Process -FilePath $destinationFilePath -ArgumentList $startProcessArgumentList -Wait
+    }
+    else
+    {
+        # Direct ISO download
+        Invoke-WebRequest -Uri $MediaUrl -OutFile $destinationFilePath
+    }
+
+    # if ($Quiet.IsPresent)
+    # {
+    #     $ProgressPreference = $previousProgressPreference
+    # }
+
+    Write-Verbose -Message "Finished downloading the SQL Server media iso at $(Get-Date -Format 'yyyy-MM-dd hh:mm:ss')" -Verbose
+
+    return (Get-Item -Path $destinationFilePath)
+}

tests/Integration/Commands/Prerequisites.Integration.Tests.ps1

@@ -0,0 +1,92 @@
+[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', '', Justification = 'Suppressing this rule because Script Analyzer does not understand Pester syntax.')]
+param ()
+
+BeforeDiscovery {
+    try
+    {
+        if (-not (Get-Module -Name 'DscResource.Test'))
+        {
+            # Assumes dependencies has been resolved, so if this module is not available, run 'noop' task.
+            if (-not (Get-Module -Name 'DscResource.Test' -ListAvailable))
+            {
+                # Redirect all streams to $null, except the error stream (stream 2)
+                & "$PSScriptRoot/../../build.ps1" -Tasks 'noop' 2>&1 4>&1 5>&1 6>&1 > $null
+            }
+
+            # If the dependencies has not been resolved, this will throw an error.
+            Import-Module -Name 'DscResource.Test' -Force -ErrorAction 'Stop'
+        }
+    }
+    catch [System.IO.FileNotFoundException]
+    {
+        throw 'DscResource.Test module dependency not found. Please run ".\build.ps1 -ResolveDependency -Tasks build" first.'
+    }
+}
+
+Describe 'Prerequisites' -Tag @('Integration_SQL2016', 'Integration_SQL2017', 'Integration_SQL2019', 'Integration_SQL2022') {
+    Context 'Create required local Windows users' {
+        BeforeAll {
+            $password = ConvertTo-SecureString -String 'P@ssw0rd1' -AsPlainText -Force
+        }
+
+        It 'Creates SqlInstall user' {
+            $user = New-LocalUser -Name 'SqlInstall' -Password $password -FullName 'SQL Install User' -Description 'User for SQL installation.'
+
+            $user.Name | Should -Be 'SqlInstall'
+            (Get-LocalUser -Name 'SqlInstall').Name | Should -Be 'SqlInstall'
+        }
+
+        It 'Creates SqlAdmin user' {
+            $user = New-LocalUser -Name 'SqlAdmin' -Password $password -FullName 'SQL Admin User' -Description 'User for SQL administration.'
+
+            $user.Name | Should -Be 'SqlAdmin'
+            (Get-LocalUser -Name 'SqlAdmin').Name | Should -Be 'SqlAdmin'
+        }
+    }
+
+    Context 'Create required local Windows service accounts' {
+        BeforeAll {
+            $password = ConvertTo-SecureString -String 'yig-C^Equ3' -AsPlainText -Force
+        }
+
+        It 'Creates svc-SqlPrimary user' {
+            $user = New-LocalUser -Name 'svc-SqlPrimary' -Password $password2 -FullName 'svc-SqlPrimary' -Description 'Runs the SQL Server service.'
+
+            $user.Name | Should -Be 'svc-SqlPrimary'
+            (Get-LocalUser -Name 'svc-SqlPrimary').Name | Should -Be 'svc-SqlPrimary'
+        }
+
+        It 'Creates svc-SqlAgentPri user' {
+            $user = New-LocalUser -Name 'svc-SqlAgentPri' -Password $password2 -FullName 'svc-SqlAgentPri' -Description 'Runs the SQL Server Agent service.'
+
+            $user.Name | Should -Be 'svc-SqlAgentPri'
+            (Get-LocalUser -Name 'svc-SqlAgentPri').Name | Should -Be 'svc-SqlAgentPri'
+        }
+
+        It 'Creates svc-SqlSecondary user' {
+            $user = New-LocalUser -Name 'svc-SqlSecondary' -Password $password2 -FullName 'svc-SqlSecondary' -Description 'Runs the SQL Server service on the second node.'
+
+            $user.Name | Should -Be 'svc-SqlSecondary'
+            (Get-LocalUser -Name 'svc-SqlSecondary').Name | Should -Be 'svc-SqlSecondary'
+        }
+
+        It 'Creates svc-SqlAgentSec user' {
+            $user = New-LocalUser -Name 'svc-SqlAgentSec' -Password $password2 -FullName 'svc-SqlAgentSec' -Description 'Runs the SQL Server Agent service on the second node.'
+
+            $user.Name | Should -Be 'svc-SqlAgentSec'
+            (Get-LocalUser -Name 'svc-SqlAgentSec').Name | Should -Be 'svc-SqlAgentSec'
+        }
+    }
+
+    Context 'Add local Windows users to local groups' {
+        It 'Adds SqlInstall to local administrator group' {
+            # Add user to local administrator group
+            Add-LocalGroupMember -Group 'Administrators' -Member 'SqlInstall'
+
+            # Verify if user is part of local administrator group
+            $adminGroup = Get-LocalGroup -Name 'Administrators'
+            $adminGroupMembers = Get-LocalGroupMember -Group $adminGroup
+            $adminGroupMembers.Name | Should -Contain 'SqlInstall'
+        }
+    }
+}

tests/Integration/Commands/README.md

@@ -72,12 +72,12 @@ The following local users are created and can be used by integration tests.
 <!-- markdownlint-disable MD013 -->
 User | Password | Permission | Description
 --- | --- | --- | ---
-.\SqlInstall | P@ssw0rd1 | Local Windows administrator. Administrator of Database Engine instance DSCSQLTEST\*. | Runs Setup for the default instance.
-.\SqlAdmin | P@ssw0rd1 | Administrator of all SQL Server instances. |
-.\svc-SqlPrimary | yig-C^Equ3 | Local user. | Runs the SQL Server Agent service.
-.\svc-SqlAgentPri | yig-C^Equ3 | Local user. | Runs the SQL Server Agent service.
-.\svc-SqlSecondary | yig-C^Equ3 | Local user. | Used by other tests, but created here.
-.\svc-SqlAgentSec | yig-C^Equ3 | Local user. | Used by other tests.
+.\SqlInstall | P@ssw0rd1 | Local Windows administrator and sysadmin | Runs Setup for all instances.
+.\SqlAdmin | P@ssw0rd1 | Local Windows user and sysadmin | Administrator of all SQL Server instances.
+.\svc-SqlPrimary | yig-C^Equ3 | Local Windows user. | Runs the SQL Server service.
+.\svc-SqlAgentPri | yig-C^Equ3 | Local Windows user. | Runs the SQL Server Agent service.
+.\svc-SqlSecondary | yig-C^Equ3 | Local Windows user. | Runs the SQL Server service in multi node scenarios.
+.\svc-SqlAgentSec | yig-C^Equ3 | Local Windows user. | Runs the SQL Server Agent service in multi node scenarios.
 
 Login | Password | Permission | Description
 --- | --- | --- | ---