🚀 Refactor CI Pipeline (#362)

* 🚀 Refactor pipeline yml

* ♻️ 🚀 Remove PSake

Refactored pipeline to handle steps on its own, so we can drop PSake.

Also moved the build module steps to their own job so it's not tied
to one of the test run jobs and is clearly marked in pipeline runs

* 🚀 Skip whole changelog stage

If the changelog stage doesn't need to run, skip it entirely so it
displays in the Azure UI as being skipped.

* 🚀 Move gallery publish to separate job

Author: vexx32

Build/Build-Module.ps1

@@ -0,0 +1,38 @@
+# Grab nuget bits, set build variables, start build.
+Get-PackageProvider -Name NuGet -ForceBootstrap > $null
+
+Set-BuildEnvironment
+
+$Lines = '-' * 70
+
+Write-Host $Lines
+Write-Host "STATUS: Generating External Help and Building Module"
+Write-Host $Lines
+
+# Load the module, read the exported functions, update the psd1 FunctionsToExport
+Set-ModuleFunction
+
+# Bump the module version if we didn't already
+try {
+    [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+
+    $GalleryVersion = Get-NextNugetPackageVersion -Name $env:BHProjectName -ErrorAction Stop
+    $GithubVersion = Get-Metadata -Path $env:BHPSModuleManifest -PropertyName ModuleVersion -ErrorAction Stop
+
+    if ($GalleryVersion -ge $GithubVersion) {
+        Update-Metadata -Path $env:BHPSModuleManifest -PropertyName ModuleVersion -Value $GalleryVersion -ErrorAction Stop
+    }
+}
+catch {
+    Write-Host "Failed to update version for '$env:BHProjectName': $_."
+    Write-Host "Continuing with existing version."
+}
+
+# Build external help files from Platyps MD files
+New-ExternalHelp -Path "$env:PROJECTROOT/docs/" -OutputPath "$env:PROJECTROOT/PSKoans/en-us"
+
+$BuiltModuleFolder = "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/Module/"
+Write-Host "##vso[task.setvariable variable=BuiltModuleFolder]$BuiltModuleFolder"
+
+New-Item -Path $BuiltModuleFolder -ItemType Directory
+Copy-Item -Path "$env:PROJECTROOT/PSKoans" -Destination $BuiltModuleFolder -Recurse -PassThru

Build/Build.ps1

@@ -0,0 +1,14 @@
+Get-PackageProvider -Name NuGet -ForceBootstrap > $null
+
+Set-BuildEnvironment
+
+$ProjectRoot = Resolve-Path -Path "$PSScriptRoot/.."
+Write-Host "##vso[task.setvariable variable=ProjectRoot]$ProjectRoot"
+
+$Lines = '-' * 70
+
+Write-Host $Lines
+Write-Host "Repository Branch: $env:BUILD_SOURCEBRANCHNAME ($env:BUILD_SOURCEBRANCH)"
+Write-Host "Build System Details:"
+Get-Item 'Env:BH*' | Out-String | Write-Host
+Write-Host $Lines

Build/Initialize-Environment.ps1

@@ -0,0 +1,47 @@
+$Lines = '-' * 70
+$PSVersion = $PSVersionTable.PSVersion
+
+Write-Host $Lines
+Write-Host "STATUS: Testing with PowerShell v$($PSVersionTable.PSVersion)"
+Write-Host $Lines
+
+# Import the module and add temporary entry to PSModulePath for build/test purposes
+$env:PSModulePath = @(
+    $env:PROJECTROOT
+    $env:PSModulePath
+) -join [IO.Path]::PathSeparator
+
+Import-Module 'PSKoans'
+
+$Timestamp = Get-Date -Format "yyyyMMdd-hhmmss"
+$TestFile = "PS${PSVersion}_${TimeStamp}_PSKoans.TestResults.xml"
+$CodeCoverageFile = "PS${PSVersion}_${TimeStamp}_PSKoans.CodeCoverage.xml"
+
+$ModuleFolders = @(
+    Get-Item -Path "$env:PROJECTROOT/PSKoans"
+    Get-ChildItem -Path "$env:PROJECTROOT/PSKoans" -Directory -Recurse |
+        Where-Object { 'Koans' -notin $_.Parent.Name, $_.Parent.Parent.Name }
+).FullName -join ';'
+
+# Tell Azure where the test results & code coverage files will be
+Write-Host "##vso[task.setvariable variable=TestResults]$TestFile"
+Write-Host "##vso[task.setvariable variable=CodeCoverageFile]$CodeCoverageFile"
+Write-Host "##vso[task.setvariable variable=SourceFolders]$ModuleFolders"
+
+# Gather test results. Store them in a variable and file
+$PesterParams = @{
+    Path                   = "$env:PROJECTROOT/Tests"
+    PassThru               = $true
+    OutputFormat           = 'NUnitXml'
+    OutputFile             = "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/$TestFile"
+    Show                   = "Header", "Failed", "Summary"
+    CodeCoverage           = (Get-ChildItem -Recurse -Path "$env:PROJECTROOT/PSKoans" -Filter '*.ps*1' -Exclude '*.Koans.ps1').FullName
+    CodeCoverageOutputFile = "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/$CodeCoverageFile"
+}
+$TestResults = Invoke-Pester @PesterParams
+
+# If tests failed, write errors and exit
+if ($TestResults.FailedCount -gt 0) {
+    Write-Error "Failed $($TestResults.FailedCount) tests; build failed!"
+    exit $TestResults.FailedCount
+}