PSDeployScripts/Artifactory.ps1
|
<#
.SYNOPSIS Deploys file(s) to an Artifactory endpoint. .DESCRIPTION Deploys files to an Artifactory endpoint and optionally extract the file contents in Artifactory if the source file is an archive (zip, tar, tar.gz, or tgz). .PARAMETER Deployment Deployment to run .PARAMETER Credential The credential with 'deploy' permissions in Artifactory .PARAMETER Repository Specified the artifact repository to deploy in to. Example: 'powershell-scripts' .PARAMETER Path Specifies the Path within artifactory to deploy to Example: 'Test/Scripts' .PARAMETER OrgPath Identifies the artifact's organization Example: 'server_group' .PARAMETER Module Identifies the artifact's module Example: 'my_module' .PARAMETER BaseRev Identifies the base revision part of the artifact version, excluding any integration information. Example: '1.5.10', or in case of an integration revision '1.2-SNAPSHOT' the base revision is '1.2' .PARAMETER FileItegRev Identifies the integration revision part in the artifact's file name, excluding the base revision. Example: In case of an integration revision '1.2-20110202.144533-'" the file integration revision is '20110202.144533-3' .PARAMETER Extension Specify an alternate file extension for the artifact .PARAMETER Checksum Allows to deploy with or without checksums (Default = $true) .PARAMETER DeployArchive Extract archive file (zip, tar, tar.gz, or tgz) once deployed. .PARAMETER Properties Specifies additional key-value pairs to be associated with the artifact. Example: @{generatedOn='2016-04-01'; generatedBy='Joe User'} #> param( [ValidateScript({ $_.PSObject.TypeNames[0] -eq 'PSDeploy.Deployment' })] [psobject[]]$Deployment, [pscredential]$Credential, [Parameter(Mandatory)] [string]$Repository, [string]$Path, [string]$OrgPath, [string]$Module, [string]$BaseRev, [string]$FileItegRev, [string]$Extension, [bool]$Checksum = $true, [bool]$DeployArchive = $false, [hashtable]$Properties ) foreach($Deploy in $Deployment) { Write-Verbose -Message "Starting deployment [$($Deploy.DeploymentName)] to Artifactory" if (Test-Path -Path $Deploy.Source) { $src = Get-Item -Path $Deploy.Source if ($src.PSIsContainer) { throw 'The source is a directory. Please specify an individual file or multiple files to deploy.' } foreach($Target in $Deploy.Targets) { # Get the file extension of the source file if none is specified in the deployment if (!$PSBoundParameters.ContainsKey('Extension')) { $file = Get-Item -Path $Deploy.Source $Extension = $file.Extension.Substring(1) } if ($PSBoundParameters.ContainsKey('Path')) { # Build URL based on hard-coded path $url = "$Target/$Repository/$Path" } else { # Build URL to deploy to $url = "$Target/$Repository/$OrgPath/$Module/$module`-$BaseRev" if ($PSBoundParameters.ContainsKey('FileItegRev')) { $url += "-$FileItegRev`.$Extension" } else { $url += "`.$Extension" } } # If extra properties are specified, append them to the URL as query parameters # These will be presented as additional properties on the artifact in Artifactory if ($PSBoundParameters.ContainsKey('Properties')) { foreach ($prop in $Properties.GetEnumerator()) { $url += ";$($prop.Name)=$($prop.Value)" } } if ($Checksum) { # Calculate hash of source file and set in headers Write-Verbose -Message "Calculating checksums" $md5 = (Get-FileHash -Path $Deploy.Source -Algorithm MD5).Hash.ToLower() $sha1 = (Get-FileHash -Path $Deploy.Source -Algorithm SHA1).Hash.ToLower() $sha256 = (Get-FileHash -Path $Deploy.Source -Algorithm SHA256).Hash.ToLower() Write-Verbose -Message "MD5: $md5" Write-Verbose -Message "SHA1: $sha1" Write-Verbose -Message "SHA256: $sha256" $headers = @{ "X-Checksum-Deploy" = $true "X-Checksum-Md5" = $md5 "X-Checksum-Sha1" = $sha1 "X-Checksum-Sha256" = $sha256 } } # If we are deploying an archive (zip, tar, tar.gz, or tgz) and want to extract the contents in Artifactory if ($DeployArchive) { Write-Verbose -Message 'Deploying artifacts from archive: true' $headers."X-Explode-Archive" = $true } Write-Verbose -Message "Deploying [$($Deploy.Source)] to [$url]" $params = @{ Uri = $url Method = 'Put' Headers = $headers InFile = $Deploy.Source Verbose = $false } if ($PSBoundParameters.ContainsKey('Credential')) { $params.Credential = $Credential } else { $params.UseDefaultCredentials = $true } try { $result = Invoke-RestMethod @params Write-Verbose -Message 'Deploy successful' } catch { throw $_ } } } else { throw "Unable to find [$($Deploy.Source)]" } } |