Implement builders to build Go from source code

builders/build-go.ps1

@@ -0,0 +1,71 @@
+using module "./builders/win-go-builder.psm1"
+using module "./builders/nix-go-builder.psm1"
+
+<#
+.SYNOPSIS
+Generate Go artifact.
+
+.DESCRIPTION
+Main script that creates instance of GoBuilder and builds of Go using specified parameters.
+
+.PARAMETER Version
+Required parameter. The version with which Go will be built.
+
+.PARAMETER Architecture
+Optional parameter. The architecture with which Go will be built. Using x64 by default.
+
+.PARAMETER Platform
+Required parameter. The platform for which Go will be built.
+
+#>
+
+param(
+    [Parameter (Mandatory=$true)][version] $Version,
+    [Parameter (Mandatory=$true)][string] $Platform,
+    [string] $Architecture = "x64"
+)
+
+Import-Module (Join-Path $PSScriptRoot "../helpers" | Join-Path -ChildPath "nix-helpers.psm1") -DisableNameChecking
+Import-Module (Join-Path $PSScriptRoot "../helpers" | Join-Path -ChildPath "win-helpers.psm1") -DisableNameChecking
+
+function Get-GoBuilder {
+    <#
+    .SYNOPSIS
+    Wrapper for class constructor to simplify importing GoBuilder.
+
+    .DESCRIPTION
+    Create instance of GoBuilder with specified parameters.
+
+    .PARAMETER Version
+    The version with which Go will be built.
+
+    .PARAMETER Platform
+    The platform for which Go will be built.
+
+    .PARAMETER Architecture
+    The architecture with which Go will be built.
+
+    #>
+
+    param (
+        [version] $Version,
+        [string] $Architecture,
+        [string] $Platform
+    )
+
+    $Platform = $Platform.ToLower()  
+    if ($Platform -match 'win32') {
+        $builder = [WinGoBuilder]::New($Version, $Platform, $Architecture)
+    } elseif (($Platform -match 'linux') -or ($Platform -match 'darwin')) {
+        $builder = [NixGoBuilder]::New($Version, $Platform, $Architecture)
+    } else {
+        Write-Host "##vso[task.logissue type=error;] Invalid platform: $Platform"
+        exit 1
+    }
+
+    return $builder
+}
+
+### Create Go builder instance, and build artifact
+$Builder = Get-GoBuilder -Version $Version -Platform $Platform -Architecture $Architecture
+$Builder.Build()

builders/go-builder.psm1

@@ -0,0 +1,110 @@
+class GoBuilder {
+    <#
+    .SYNOPSIS
+    Base Go builder class.
+
+    .DESCRIPTION
+    Base Go builder class that contains general builder methods.
+
+    .PARAMETER Version
+    The version of Go that should be built.
+
+    .PARAMETER Platform
+    The platform of Go that should be built.
+
+    .PARAMETER Architecture
+    The architecture with which Go should be built.
+
+    .PARAMETER TempFolderLocation
+    The location of temporary files that will be used during Go package generation. Using system BUILD_STAGINGDIRECTORY variable value.
+
+    .PARAMETER ArtifactLocation
+    The location of generated Go artifact. Using system environment BUILD_BINARIESDIRECTORY variable value.
+
+    .PARAMETER InstallationTemplatesLocation
+    The location of installation script template. Using "installers" folder from current repository.
+
+    #>
+
+    [version] $Version
+    [string] $Platform
+    [string] $Architecture
+    [string] $TempFolderLocation
+    [string] $WorkFolderLocation
+    [string] $ArtifactFolderLocation
+    [string] $InstallationTemplatesLocation
+
+    GoBuilder ([version] $version, [string] $platform, [string] $architecture) {
+        $this.Version = $version
+        $this.Platform = $platform
+        $this.Architecture = $architecture
+
+        $this.TempFolderLocation = [IO.Path]::GetTempPath()
+        $this.WorkFolderLocation = $env:BUILD_BINARIESDIRECTORY
+        $this.ArtifactFolderLocation = $env:BUILD_STAGINGDIRECTORY
+        
+
+        $this.InstallationTemplatesLocation = Join-Path -Path $PSScriptRoot -ChildPath "../installers"
+    }
+
+    [uri] GetBinariesUri() {
+        <#
+        .SYNOPSIS
+        Get base Go URI and return complete URI for Go installation executable.
+        #>
+
+        $arch = ($this.Architecture -eq "x64") ? "amd64" : $this.Architecture
+        $goPlatform = ($this.Platform -Match "win32") ? "windows" : $this.Platform
+        $ArchiveType = ($this.Platform -Match "win32") ? "zip" : "tar.gz"
+        If ($this.Version.Build -eq "0") {
+            $goVersion = "go$($this.Version.ToString(2))"
+        } else {
+            $goVersion = "go$($this.Version.ToString(3))"
+        }
+
+        $filename = "$goVersion.$goPlatform-$arch.$ArchiveType"
+
+        return "https://storage.googleapis.com/golang/$filename"
+    }
+
+    [string] Download() {
+        <#
+        .SYNOPSIS
+        Download Go binaries into artifact location.
+        #>
+
+        $binariesUri = $this.GetBinariesUri()
+        $targetFilename = [IO.Path]::GetFileName($binariesUri)
+        $targetFilepath = Join-Path -Path $this.TempFolderLocation -ChildPath $targetFilename
+
+        Write-Debug "Download binaries from $binariesUri to $targetFilepath"
+        try {
+            (New-Object System.Net.WebClient).DownloadFile($binariesUri, $targetFilepath)
+        } catch {
+            Write-Host "Error during downloading file from '$binariesUri'"
+            exit 1
+        }
+
+        Write-Debug "Done; Binaries location: $targetFilepath"
+        return $targetFilepath
+    }
+
+    [void] Build() {
+        <#
+        .SYNOPSIS
+        Generates Go artifact from downloaded binaries.
+        #>
+
+        Write-Host "Download Go $($this.Version) [$($this.Architecture)] executable..."
+        $binariesArchivePath = $this.Download()
+
+        Write-Host "Unpack binaries to target directory"
+        $this.ExtractBinaries($binariesArchivePath)
+
+        Write-Host "Create installation script..."
+        $this.CreateInstallationScript()
+
+        Write-Host "Archive artifact"
+        $this.ArchiveArtifact()
+    }
+}

builders/nix-go-builder.psm1

@@ -0,0 +1,57 @@
+using module "./builders/go-builder.psm1"
+
+class NixGoBuilder : GoBuilder {
+    <#
+    .SYNOPSIS
+    Ubuntu Go builder class.
+
+    .DESCRIPTION
+    Contains methods that required to build Ubuntu Go artifact from sources. Inherited from base NixGoBuilder.
+
+    .PARAMETER platform
+    The full name of platform for which Go should be built.
+
+    .PARAMETER version
+    The version of Go that should be built.
+
+    #>
+
+    [string] $InstallationTemplateName
+    [string] $InstallationScriptName
+    [string] $OutputArtifactName
+
+    NixGoBuilder(
+        [version] $version,
+        [string] $platform,
+        [string] $architecture
+    ) : Base($version, $platform, $architecture) {
+        $this.InstallationTemplateName = "nix-setup-template.sh"
+        $this.InstallationScriptName = "setup.sh"
+        $this.OutputArtifactName = "go-$Version-$Platform-$Architecture.tar.gz"
+    }
+
+    [void] ExtractBinaries($archivePath) {
+        Extract-TarArchive -ArchivePath $archivePath -OutputDirectory $this.WorkFolderLocation
+    }
+
+    [void] CreateInstallationScript() {
+        <#
+        .SYNOPSIS
+        Create Go artifact installation script based on template specified in InstallationTemplateName property.
+        #>
+
+        $installationScriptLocation = New-Item -Path $this.WorkFolderLocation -Name $this.InstallationScriptName -ItemType File
+        $installationTemplateLocation = Join-Path -Path $this.InstallationTemplatesLocation -ChildPath $this.InstallationTemplateName
+
+        $installationTemplateContent = Get-Content -Path $installationTemplateLocation -Raw
+        $installationTemplateContent = $installationTemplateContent -f $this.Version.ToString(3)
+        $installationTemplateContent | Out-File -FilePath $installationScriptLocation
+
+        Write-Debug "Done; Installation script location: $installationScriptLocation)"
+    }
+
+    [void] ArchiveArtifact() {
+        $OutputPath = Join-Path $this.ArtifactFolderLocation $this.OutputArtifactName
+        Create-TarArchive -SourceFolder $this.WorkFolderLocation -ArchivePath $OutputPath
+    }
+}

builders/win-go-builder.psm1

@@ -0,0 +1,64 @@
+using module "./builders/go-builder.psm1"
+
+class WinGoBuilder : GoBuilder {
+    <#
+    .SYNOPSIS
+    Ubuntu Go builder class.
+
+    .DESCRIPTION
+    Contains methods that required to build Ubuntu Go artifact from sources. Inherited from base NixGoBuilder.
+
+    .PARAMETER platform
+    The full name of platform for which Go should be built.
+
+    .PARAMETER version
+    The version of Go that should be built.
+
+    #>
+
+    [string] $InstallationTemplateName
+    [string] $InstallationScriptName
+    [string] $OutputArtifactName
+
+    WinGoBuilder(
+        [version] $version,
+        [string] $platform,
+        [string] $architecture
+    ) : Base($version, $platform, $architecture) {
+        $this.InstallationTemplateName = "win-setup-template.ps1"
+        $this.InstallationScriptName = "setup.ps1"
+        $this.OutputArtifactName = "go-$Version-$Platform-$Architecture.zip"
+    }
+
+    [void] ExtractBinaries($archivePath) {
+        $extractTargetDirectory = Join-Path $this.TempFolderLocation "tempExtract"
+        Extract-SevenZipArchive -ArchivePath $archivePath -OutputDirectory $extractTargetDirectory
+        $goOutputPath = Get-Item $extractTargetDirectory\* | Select-Object -First 1 -ExpandProperty Fullname
+        Move-Item -Path $goOutputPath\* -Destination $this.WorkFolderLocation
+    }
+
+    [void] CreateInstallationScript() {
+        <#
+        .SYNOPSIS
+        Create Go artifact installation script based on specified template.
+        #>
+
+        $installationScriptLocation = New-Item -Path $this.WorkFolderLocation -Name $this.InstallationScriptName -ItemType File
+        $installationTemplateLocation = Join-Path -Path $this.InstallationTemplatesLocation -ChildPath $this.InstallationTemplateName
+        $installationTemplateContent = Get-Content -Path $installationTemplateLocation -Raw
+
+        $variablesToReplace = @{
+            "{{__VERSION__}}" = $this.Version;
+            "{{__ARCHITECTURE__}}" = $this.Architecture;
+        }
+
+        $variablesToReplace.keys | ForEach-Object { $installationTemplateContent = $installationTemplateContent.Replace($_, $variablesToReplace[$_]) }
+        $installationTemplateContent | Out-File -FilePath $installationScriptLocation
+        Write-Debug "Done; Installation script location: $installationScriptLocation)"
+    }
+
+    [void] ArchiveArtifact() {
+        $OutputPath = Join-Path $this.ArtifactFolderLocation $this.OutputArtifactName
+        Create-SevenZipArchive -SourceFolder $this.WorkFolderLocation -ArchivePath $OutputPath -ArchiveType "zip"
+    }
+}