Private/Shared/Get-GithubRelease.ps1
|
#################################### # Get-GithubRelease.ps1 # #################################### # Version: 0.1.0 # Based on Invoke-GitHubReleaseFetcher by Jack Tracey: # Source: https://github.com/jtracey93/PublicScripts/blob/master/GitHub/PowerShell/Invoke-GitHubReleaseFetcher.ps1 <# .SYNOPSIS Checks for the releases of a GitHub repository and downloads the latest release or all releases and pulls it into a specified directory, one for each version. .DESCRIPTION Checks for the releases of a GitHub repository and downloads the latest release or all releases and pulls it into a specified directory, one for each version. .EXAMPLE .NOTES # Release notes 16/03/2023 - V0.1.0: - Initial release. #> function Get-GithubRelease { [CmdletBinding()] param ( [Parameter(Mandatory = $true, Position = 1, HelpMessage = "Please the provide the full URL of the GitHub repository you wish to check for the latest release.")] [string] $githubRepoUrl, [Parameter(Mandatory = $false, Position = 2, HelpMessage = "The release to download. Specify 'latest' to download the latest release. Defaults to the latest release.")] [string] $release = "latest", [Parameter(Mandatory = $true, Position = 3, HelpMessage = "The directory to download the releases to.")] [string] $targetDirectory, [Parameter(Mandatory = $false, Position = 4, HelpMessage = "Whether to just query the API and return the release versions.")] [switch] $queryOnly, [Parameter(Mandatory = $false, HelpMessage = "The source directory location of the modules. Defaults to root")] $moduleSourceFolder = ".", [Parameter(Mandatory = $true, HelpMessage = "The target directory location of the modules.")] $moduleTargetFolder, [Parameter(Mandatory = $false, HelpMessage = "The name of the release artifact in the target release. Defaults to standard release zip.")] $releaseArtifactName = "", [Parameter(Mandatory = $false, HelpMessage = "The GitHub token to use for authentication.")] [string] $githubToken ) $parentDirectory = $targetDirectory $targetPath = Join-Path $targetDirectory $moduleTargetFolder # Get the release tag and data from GitHub $releaseResult = Get-GithubReleaseTag -githubRepoUrl $githubRepoUrl -release $release -githubToken $githubToken $releaseTag = $releaseResult.ReleaseTag $releaseData = $releaseResult.ReleaseData if ($queryOnly) { return $releaseTag } # Check if directory exists Write-Verbose "=====> Checking if directory for releases exists: $targetPath" if (!(Test-Path $targetPath)) { Write-Verbose "Directory does not exist for releases, will now create: $targetPath" New-Item -ItemType Directory -Path $targetPath | Out-String | Write-Verbose } # Check the directory for this release $targetVersionPath = Join-Path $targetPath $releaseTag Write-Verbose "===> Checking if directory for release version exists: $targetVersionPath" if (!(Test-Path $targetVersionPath)) { Write-Verbose "Directory does not exist for release $releaseTag, will now create: $targetVersionPath" New-Item -ItemType Directory -Path $targetVersionPath | Out-String | Write-Verbose } Write-Verbose "===> Checking if any content exists inside of $targetVersionPath" $contentTargetVersionPath = Get-ChildItem -Path $targetVersionPath -Recurse -ErrorAction SilentlyContinue if ($null -eq $contentTargetVersionPath) { Write-Verbose "===> Pulling and extracting release $releaseTag into $targetVersionPath" New-Item -ItemType Directory -Path "$targetVersionPath/tmp" | Out-String | Write-Verbose $targetPathForZip = "$targetVersionPath/tmp/$releaseTag.zip" # Get the artifact url if ($releaseArtifactName -ne "") { $releaseArtifactUrl = $releaseData.assets | Where-Object { $_.name -eq $releaseArtifactName } | Select-Object -ExpandProperty browser_download_url } else { $releaseArtifactUrl = $releaseData.zipball_url } Write-Verbose "===> Downloading the release artifact $releaseArtifactUrl from the GitHub repository $repoOrgPlusRepo" Invoke-WebRequest -Uri $releaseArtifactUrl -OutFile $targetPathForZip -RetryIntervalSec 3 -MaximumRetryCount 100 | Out-String | Write-Verbose if (!(Test-Path $targetPathForZip)) { Write-ToConsoleLog "Failed to download the release $releaseTag from the GitHub repository $repoOrgPlusRepo" -IsError throw } $targetPathForExtractedZip = "$targetVersionPath/tmp/extracted" Expand-Archive -Path $targetPathForZip -DestinationPath $targetPathForExtractedZip | Out-String | Write-Verbose $extractedSubFolder = $targetPathForExtractedZip if ($releaseArtifactName -eq "") { $extractedSubFolder = (Get-ChildItem -Path $targetPathForExtractedZip -Directory).FullName } Write-Verbose "===> Copying all extracted contents into $targetVersionPath from $($extractedSubFolder)/$moduleSourceFolder/*." Copy-Item -Path "$($extractedSubFolder)/$moduleSourceFolder/*" -Destination "$targetVersionPath" -Recurse -Force | Out-String | Write-Verbose Remove-Item -Path "$targetVersionPath/tmp" -Force -Recurse Write-ToConsoleLog "The directory for $targetVersionPath has been created and populated." -IsSuccess } else { Write-ToConsoleLog "The directory for $targetVersionPath already exists and has content in it, so we are not overwriting it." -IsSuccess Write-Verbose "===> Content already exists in $releaseDirectory. Skipping" } # Check and replace the .env file release version if it is Bicep $envFilePath = Join-Path -Path $parentDirectory -ChildPath ".env" if (Test-Path $envFilePath) { Write-Verbose "===> Replacing the .env file release version with $releaseTag" (Get-Content $envFilePath) -replace "UPSTREAM_RELEASE_VERSION=.*", "UPSTREAM_RELEASE_VERSION=$releaseTag" | Set-Content $envFilePath } return $releaseTag } |