Test-SqlDscRSAccessible: command to verify accessibility sites

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Added public command `Test-SqlDscRSAccessible` to verify that SQL Server
+  Reporting Services or Power BI Report Server web sites are accessible.
+  Supports both CIM configuration input (with dynamic `-Site` parameter) and
+  explicit URIs. Includes retry logic and optional detailed output with HTTP
+  status codes.
+- Added post-initialization integration tests for RS commands
+  (`Post.Initialization.RS.Integration.Tests.ps1`) to verify that SSRS and
+  PBIRS sites are fully accessible after `Initialize-SqlDscRS` runs.
 - Added public command `Request-SqlDscRSDatabaseScript` to generate T-SQL scripts
   for creating report server databases. Wraps the `GenerateDatabaseCreationScript`
   CIM method and supports configuring database name, language (LCID), and
@@ -189,6 +197,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   by calling the `InitializeReportServer` CIM method. Used to complete initial
   configuration after database and URL setup
   ([issue #2014](https://github.com/dsccommunity/SqlServerDsc/issues/2014)).
+- Added public command `Request-SqlDscRSDatabaseUpgradeScript` to generate a
+  T-SQL script for upgrading the report server database schema. Wraps the
+  `GenerateDatabaseUpgradeScript` CIM method.
 
 ### Changed
 

azure-pipelines.yml

@@ -69,9 +69,11 @@ stages:
               publishLocation: 'pipeline'
               parallel: true
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Quality_Test_and_Unit_Test
     displayName: 'Quality Test and Unit Test'
     dependsOn: Build
+    condition: false
     jobs:
       - job: Determine_DSC_Resource_Test_Requirements
         displayName: 'Determine DSC Resource Test Requirements'
@@ -235,9 +237,11 @@ stages:
               bash <(curl -s https://codecov.io/bash) -f "./$(buildFolderName)/$(testResultFolderName)/JaCoCo_coverage.xml" -F unit
             displayName: 'Publish Code Coverage to Codecov.io'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Commands_SqlServer
     displayName: 'Integration Test Commands - SQL Server'
     dependsOn: Quality_Test_and_Unit_Test
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Commands'
@@ -404,9 +408,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration Commands ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Commands_SqlServer_PreparedImage
     displayName: 'Integration Test Commands - SQL Server (Prepared Image)'
     dependsOn: Quality_Test_and_Unit_Test
+    condition: false
     jobs:
       - job: Test_Integration_PreparedImage
         displayName: 'Commands - Prepared Image'
@@ -481,7 +487,8 @@ stages:
 
   - stage: Integration_Test_Commands_ReportingServices
     displayName: 'Integration Test Commands - Reporting Services'
-    dependsOn: Integration_Test_Commands_SqlServer
+    # TEMPORARILY CHANGED FOR DEBUGGING - was: dependsOn: Integration_Test_Commands_SqlServer
+    dependsOn: Build
     jobs:
       - job: Test_Integration
         displayName: 'Commands'
@@ -557,6 +564,8 @@ stages:
                   'tests/Integration/Commands/Test-SqlDscRSInitialized.Integration.Tests.ps1'
                   # Group 4
                   'tests/Integration/Commands/Initialize-SqlDscRS.Integration.Tests.ps1'
+                  # Group 5 - Post-initialization validation
+                  'tests/Integration/Commands/Post.Initialization.RS.Integration.Tests.ps1'
                   # Group 8
                   'tests/Integration/Commands/Repair-SqlDscReportingService.Integration.Tests.ps1'
                   # Group 9
@@ -574,7 +583,8 @@ stages:
 
   - stage: Integration_Test_Commands_BIReportServer
     displayName: 'Integration Test Commands - BI Report Server'
-    dependsOn: Integration_Test_Commands_SqlServer
+    # TEMPORARILY CHANGED FOR DEBUGGING - was: dependsOn: Integration_Test_Commands_SqlServer
+    dependsOn: Build
     jobs:
       - job: Test_Integration
         displayName: 'Commands'
@@ -640,6 +650,8 @@ stages:
                   'tests/Integration/Commands/Test-SqlDscRSInitialized.Integration.Tests.ps1'
                   # Group 4
                   'tests/Integration/Commands/Initialize-SqlDscRS.Integration.Tests.ps1'
+                  # Group 5 - Post-initialization validation
+                  'tests/Integration/Commands/Post.Initialization.RS.Integration.Tests.ps1'
                   # Group 8
                   'tests/Integration/Commands/Repair-SqlDscPowerBIReportServer.Integration.Tests.ps1'
                   # Group 9
@@ -655,14 +667,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration Commands ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Resources_SqlServer
     displayName: 'Integration Test Resources - SQL Server'
     dependsOn: Quality_Test_and_Unit_Test
-    condition: |
-      and(
-        succeeded(),
-        eq(lower(dependencies.Quality_Test_and_Unit_Test.outputs['Determine_DSC_Resource_Test_Requirements.determineDscResourceTests.ShouldRunDscResourceIntegrationTests']), 'true')
-      )
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Integration'
@@ -753,14 +762,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration Resources ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Resources_SqlServer_dbatools
     displayName: 'Integration Test Resources - SQL Server (dbatools)'
     dependsOn: Integration_Test_Resources_SqlServer
-    condition: |
-      and(
-        succeeded(),
-        eq(lower(dependencies.Quality_Test_and_Unit_Test.outputs['Determine_DSC_Resource_Test_Requirements.determineDscResourceTests.ShouldRunDscResourceIntegrationTests']), 'true')
-      )
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Integration'
@@ -848,14 +854,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration (dbatools) ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Resources_ReportingServices
     displayName: 'Integration Test Resources - Reporting Services'
     dependsOn: Integration_Test_Resources_SqlServer
-    condition: |
-      and(
-        succeeded(),
-        eq(lower(dependencies.Quality_Test_and_Unit_Test.outputs['Determine_DSC_Resource_Test_Requirements.determineDscResourceTests.ShouldRunDscResourceIntegrationTests']), 'true')
-      )
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Integration'
@@ -924,14 +927,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration RS ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Resources_PowerBIReportServer
     displayName: 'Integration Test Resources - Power BI Report Server'
     dependsOn: Quality_Test_and_Unit_Test
-    condition: |
-      and(
-        succeeded(),
-        eq(lower(dependencies.Quality_Test_and_Unit_Test.outputs['Determine_DSC_Resource_Test_Requirements.determineDscResourceTests.ShouldRunDscResourceIntegrationTests']), 'true')
-      )
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Integration'
@@ -991,14 +991,11 @@ stages:
               testResultsFiles: '$(buildFolderName)/$(testResultFolderName)/NUnit*.xml'
               testRunTitle: 'Integration RS ($(TEST_CONFIGURATION) / $(JOB_VMIMAGE))'
 
+  # TEMPORARILY DISABLED FOR DEBUGGING RS INTEGRATION TESTS
   - stage: Integration_Test_Resources_ReportingServices_dbatools
     displayName: 'Integration Test Resources - Reporting Services (dbatools)'
     dependsOn: Integration_Test_Resources_SqlServer
-    condition: |
-      and(
-        succeeded(),
-        eq(lower(dependencies.Quality_Test_and_Unit_Test.outputs['Determine_DSC_Resource_Test_Requirements.determineDscResourceTests.ShouldRunDscResourceIntegrationTests']), 'true')
-      )
+    condition: false
     jobs:
       - job: Test_Integration
         displayName: 'Integration'

source/Public/Add-SqlDscRSUrlReservation.ps1

@@ -86,7 +86,6 @@
 #>
 function Add-SqlDscRSUrlReservation
 {
-    # cSpell: ignore PBIRS
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the examples use pipeline input the rule cannot validate.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
     [OutputType([System.Object])]

source/Public/Disable-SqlDscRsSecureConnection.ps1

@@ -69,7 +69,6 @@
 #>
 function Disable-SqlDscRsSecureConnection
 {
-    # cSpell: ignore PBIRS
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the examples use pipeline input the rule cannot validate.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
     [Alias('Disable-SqlDscRSTls')]

source/Public/Enable-SqlDscRsSecureConnection.ps1

@@ -73,7 +73,6 @@
 #>
 function Enable-SqlDscRsSecureConnection
 {
-    # cSpell: ignore PBIRS
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the examples use pipeline input the rule cannot validate.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
     [Alias('Enable-SqlDscRSTls')]

source/Public/Remove-SqlDscRSUrlReservation.ps1

@@ -86,7 +86,6 @@
 #>
 function Remove-SqlDscRSUrlReservation
 {
-    # cSpell: ignore PBIRS
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the examples use pipeline input the rule cannot validate.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
     [OutputType([System.Object])]

source/Public/Set-SqlDscRSUrlReservation.ps1

@@ -84,7 +84,6 @@
 #>
 function Set-SqlDscRSUrlReservation
 {
-    # cSpell: ignore PBIRS
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the examples use pipeline input the rule cannot validate.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
     [OutputType([System.Object])]