Go-projecten bouwen en testen

Vanaf Go 1.11 hoeft u geen omgevingsvariabele $GOPATH meer te definiëren, een werkruimte-indeling in te stellen of de module dep te gebruiken. Afhankelijkheidsbeheer is nu ingebouwd met Go-modules.

Met deze YAML wordt de go get-opdracht geïmplementeerd om Go-pakketten en hun afhankelijkheden te downloaden. Vervolgens gebruikt het go build om de inhoud te genereren die door de PublishBuildArtifacts@1 taak wordt gepubliceerd.

trigger: 
 - main

pool:
   vmImage: 'ubuntu-latest'

steps: 
- task: GoTool@0
  inputs:
    version: '1.22'  # Use a currently supported Go version
- task: Go@0
  inputs:
    command: 'get'
    arguments: '-d'
    workingDirectory: '$(System.DefaultWorkingDirectory)'
- task: Go@0
  inputs:
    command: 'build'
    workingDirectory: '$(System.DefaultWorkingDirectory)'
- task: CopyFiles@2
  inputs:
    TargetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
     artifactName: drop

Zoals de Go-documentatie beschrijft, bestaat een Go-werkruimte uit een hoofdmap waarnaar de $GOPATH omgevingsvariabele wijst. Dit $GOPATH is een Go-specifieke omgevingsvariabele die aangeeft waar de Go-compiler broncode en afhankelijkheden moet vinden. Binnen die map zijn de volgende standaardsubmappen:

• bin uitvoerbare opdrachten bevatten
• pkg om gecompileerde pakketten te bevatten (.a bestanden)
• src om Go-bronbestanden te bevatten (.go, .c, .g, .s)

Wanneer een Build van Azure Pipelines code ophaalt uit een externe opslagplaats, wordt de code in de standaardwerkmap van de build opgeslagen. Als u de verwachte structuur van een Go-werkruimte wilt vergelijken, voegt u het volgende codefragment toe aan uw azure-pipelines.yml-bestand. Dit script wordt uitgevoerd in bash op Linux- en macOS-agents, maar u moet dit voor Windows wijzigen.

variables:
  GOBIN:  '$(GOPATH)/bin' # Go binaries path
  GOPATH: '$(system.defaultWorkingDirectory)/gopath' # Go workspace path
  modulePath: '$(GOPATH)/src/github.com/$(build.repository.name)' # Path to the module's code

steps:
- script: |
    mkdir -p '$(GOBIN)'
    mkdir -p '$(GOPATH)/pkg'
    mkdir -p '$(modulePath)'
    shopt -s extglob
    shopt -s dotglob
    mv !(gopath) '$(modulePath)'
    echo '##vso[task.prependpath]$(GOBIN)'
  displayName: 'Set up the Go workspace'

- script: |
    go version
    go get -v -t -d ./...
    if [ -f Gopkg.toml ]; then
        curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
        dep ensure
    fi
    go build -v .
  workingDirectory: '$(modulePath)'
  displayName: 'Get dependencies, then build'

Als uw code zich niet op GitHub bevindt, wijzigt u het gebruik van modulePath variabele van github.com in een geschikte waarde voor uw module.

Met dit fragment worden de volgende acties uitgevoerd:

1. Hiermee stelt $GOROOT u de versie van Go in die u wilt gebruiken.
2. Hiermee stelt u andere bekende Go-omgevingsvariabelen in op de juiste waarden.
3. Maakt een Go-werkruimte aan in een submap met de naam gopath, met onderliggende mappen bin, pkgen src.
4. Hiermee verplaatst u code die de build ophaalt uit de externe opslagplaats naar de werkruimtemap src .
5. Hiermee voegt u de versie van Go en de werkruimte bin map toe aan het pad.

Afhankelijkheden installeren

Gebruik go get

Gebruik go get om de broncode voor een Go-project te downloaden of om een hulpprogramma te installeren in de Go-werkruimte. Voeg het volgende fragment toe aan uw azure-pipelines.yml bestand:

- script: go get -v -t -d ./...
  workingDirectory: '$(modulePath)'
  displayName: 'go get dependencies'

Gebruik dep ensure

Gebruik dep ensure dit als uw verouderde project nog steeds dep gebruikt om afhankelijkheden te downloaden die in uw code zijn geïmporteerd. Met de dep ensure opdracht worden geïmporteerde opslagplaatsen gekloond naar de leveranciermap van uw project. De Gopkg.lock- en Gopkg.toml-bestanden garanderen dat iedereen die aan het project werkt, dezelfde versie van afhankelijkheden gebruikt als uw build. Voeg het volgende fragment toe aan uw azure-pipelines.yml bestand.

- script: |
    if [ -f Gopkg.toml ]; then
        curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
        dep ensure
    fi
  workingDirectory: '$(modulePath)'
  displayName: 'Download dep and run `dep ensure`'