functions/Invoke-DBOPackageCI.ps1
|
function Invoke-DBOPackageCI { <# .SYNOPSIS Prepares the scripts from the source folder to be deployed using DBOps packaging system .DESCRIPTION For a newly defined process, creates a new DBOps package from all the files in the specified folder For existing process, updates the current version of the package by creating a new build from the scripts that were recently added/modified in the specified folder. Compares all the contents of the package with contents of the folder using absolute/relative paths depending on the ability to build a relative path to the script folder. Each build will be assigned with a version using [System.Version] object. Each new build will have an increase in the build number, however, Major/Minor versions will stay the same unless the function is explicitly called with the new -Version .PARAMETER ScriptPath A collection of folders to scan. Accepts Get-Item/Get-ChildItem objects and wildcards. Will recursively add all of the subfolders inside folders. See examples if you want only custom files to be added. During deployment, scripts will be following this deployment order: - Item order provided in the ScriptPath parameter - Files inside each child folder (both folders and files in alphabetical order) - Files inside the root folder (in alphabetical order) Aliases: SourcePath .PARAMETER Path Path to the existing DBOpsPackage. Aliases: Name, FileName, Package .PARAMETER Version A string that is indended to represent the Major/Minor versions of the current package. Optional if the package already exists. Will be used to construct the new build version: specifying '2.4' will result in build '2.4.1' for new packages For existing packages will compare the versions and continue to increase the build number by 1, but only if Major/Minor versions are consistent. Example: Current package version = '2.1.3', Version = '2.1', Output => '2.1.4' Current package version = '2.1.3', Version = '3.0', Output => '3.0.1' .PARAMETER Type Adds only files that were not added to the package yet. The following options are available: * New: add new files based on their source path (can be relative) * Modified: adds files only if they have been modified since they had last been added to the package * Unique: adds unique files to the build based on their hash values. Compares hashes accross the whole package * All: add all files regardless of their previous involvement More than one value can be specified at the same time. Default value: New, and it's strongly recommended to keep it that way! .PARAMETER Confirm Prompts to confirm certain actions .PARAMETER WhatIf Shows what would happen if the command would execute, but does not actually perform the command .EXAMPLE # Will invoke CI build for version 1.0.x of the package MyPackage.zip using scripts from the source folder .\Scripts Invoke-DBOPackageCI -Path MyPackage.zip -ScriptPath .\Scripts -Version 1.0 .NOTES See 'Get-Help New-DBOPackage' for additional info about packages. #> [CmdletBinding(SupportsShouldProcess = $true)] param ( [Parameter(Mandatory = $true, Position = 1)] [Alias('FileName', 'Name', 'Package')] [string]$Path, [Parameter(Mandatory = $true, ValueFromPipeline = $true, Position = 2)] [Alias('SourcePath')] [object[]]$ScriptPath, [Version]$Version, [ValidateSet('New', 'Modified', 'Unique', 'All')] [string[]]$Type = 'New' ) begin { } process { try { $pkg = Get-DBOPackage $Path -ErrorAction Stop $pkgVersion = [Version]$pkg.Version } catch [System.Management.Automation.ItemNotFoundException] { $pkgVersion = [Version]'1.0' $pkg = $null Write-Message -Message "Assuming a new version $pkgVersion for the build" -Level Verbose } catch { Stop-PSFFunction -ErrorRecord $_ -EnableException $true -Message $_.Exception.Message return } if ($Version) { if ($Version.CompareTo([version]::new($pkgVersion.Major, $pkgVersion.Minor)) -ne 0) { Write-Message -Message "Assuming a new version $Version for the build instead of $pkgVersion" -Level Verbose $pkgVersion = $Version } } # Ensure version has three parts if ($pkgVersion.Build -eq -1) { $pkgVersion = [version]::new($pkgVersion.Major, $pkgVersion.Minor, 0) } #Increasing build version $pkgVersion = [Version]::new($pkgVersion.Major, $pkgVersion.Minor, $pkgVersion.Build + 1) Write-Message -Message "Building version $pkgVersion" -Level Verbose if ($pkg) { if ($PSCmdlet.ShouldProcess($pkg, "Adding new build to existing package")) { Add-DBOBuild -Package $pkg -ScriptPath $ScriptPath -Type $Type -Build $pkgVersion.ToString(3) } } else { if ($PSCmdlet.ShouldProcess($Path, "Creating new package")) { New-DBOPackage -Name $Path -ScriptPath $ScriptPath -Build $pkgVersion.ToString(3) } } } end { } } |