Go-projecten bouwen en testen

Azure DevOps Services

Gebruik een pijplijn om uw Go-projecten automatisch te bouwen en te testen.

Uw eerste pijplijn maken

Nieuw bij Azure Pipelines? Zo ja, dan raden we u aan deze sectie te proberen voordat u verdergaat met andere secties.

Fork het volgende repository op GitHub:

https://github.com/MicrosoftDocs/pipelines-go

Aanmelden bij Azure Pipelines

Meld u aan bij Azure Pipelines. Nadat u zich hebt aangemeld, gaat uw browser naar https://dev.azure.com/my-organization-name en geeft u uw Azure DevOps-dashboard weer.

1. Ga in een browser naar dev.azure.com en meld u aan.
2. Selecteer uw organisatie.
3. Maak een nieuw project door Nieuw project of Project maken te selecteren als u het eerste project in de organisatie maakt.
4. Voer een projectnaam in.
5. Selecteer de zichtbaarheid voor uw project.
6. Klik op Creëren.

1. Ga in een browser naar uw Azure DevOps-server.
2. Selecteer uw verzameling.
3. Maak een nieuw project door Nieuw project of Project maken te selecteren als u het eerste project in de verzameling maakt.
4. Voer een projectnaam in.
5. Selecteer de zichtbaarheid voor uw project.
6. Klik op Creëren.

De pijplijn maken

1. Meld u aan bij uw Azure DevOps-organisatie en ga naar uw project.

2. Ga naar Pijplijnen en selecteer vervolgens Nieuwe pijplijn of Pijplijn maken als u uw eerste pijplijn maakt.

3. Voer de stappen van de wizard uit door eerst GitHub te selecteren als de locatie van uw broncode.

4. U wordt mogelijk omgeleid naar GitHub om u aan te melden. Voer in dat geval uw GitHub-referenties in.

5. Wanneer u de lijst met opslagplaatsen ziet, selecteert u de opslagplaats.

6. U wordt mogelijk omgeleid naar GitHub om de Azure Pipelines-app te installeren. Als dat het zo is, selecteert u Goedkeuren en installeren.

Wanneer het tabblad configureren wordt weergegeven, selecteert u Go-. De nieuwe pijplijn wordt weergegeven, met het azure-pipelines.yml YAML-bestand dat klaar is om te worden geconfigureerd. Zie de volgende secties voor meer informatie over een aantal veelgebruikte manieren om uw pijplijn aan te passen.

Omgeving bouwen

U kunt Azure Pipelines gebruiken om uw Go-projecten te bouwen zonder een eigen infrastructuur in te stellen. U kunt Linux-, macOS- of Windows-agents gebruiken om uw builds uit te voeren.

Werk het volgende fragment in het azure-pipelines.yml-bestand bij om de juiste afbeelding te selecteren.

pool:
  vmImage: 'ubuntu-latest'

Moderne versies van Go zijn vooraf geïnstalleerd op door Microsoft beheerde agents. Raadpleeg door Microsoft gehoste agents in Azure Pipelinesvoor de exacte versies van vooraf geïnstalleerde Go.

Go instellen

Go 1.11+

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

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

trigger: 
 - main

pool:
   vmImage: 'ubuntu-latest'

steps: 
- task: GoTool@0
  inputs:
    version: '1.13.5'
- 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

Go < 1.11

Zoals de Go-documentatie beschrijft, bestaat een Go-werkruimte uit een hoofdmap waarnaar de $GOPATH omgevingsvariabele wijst. 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 moet worden gewijzigd voor Windows.

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.

Dit codefragment voert de volgende acties uit:

1. Hiermee stelt u $GOROOT in op de versie van Go die moet worden gebruikt.
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 is opgehaald uit de externe opslagplaats naar de werkruimte src map
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 als uw project dep gebruikt om afhankelijkheden te downloaden die in uw code zijn geïmporteerd. Bij het uitvoeren van dep ensure worden gekloonde geïmporteerde repositories in de vendor-map van uw project geplaatst. 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.

Notitie

Het volgende script wordt uitgevoerd op Linux- en macOS-agents en kan worden gebruikt voor oudere versies van Go waarvoor een specifieke mapstructuur is vereist. Het script is geschreven voor Unix-shells en kan daardoor niet werken met Windows-agents.

- 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`'

Bouwen

Gebruik go build om uw Go-project te bouwen. Voeg het volgende fragment toe aan uw azure-pipelines.yml bestand:

- task: Go@0
  inputs:
    command: 'build'
    workingDirectory: '$(System.DefaultWorkingDirectory)'

Testen

Gebruik go test om de go-module en de bijbehorende submappen (./...) te testen. Voeg het volgende fragment toe aan uw azure-pipelines.yml bestand:

- task: Go@0
  inputs:
    command: 'test'
    arguments: '-v'
    workingDirectory: '$(System.DefaultWorkingDirectory)'

Wanneer u klaar bent, voert u een nieuw azure-pipelines.yml-bestand door naar uw opslagplaats en werkt u het doorvoerbericht bij. Selecteer Opslaan en uitvoeren.

Als u de pijplijn in actie wilt bekijken, kiest u de build in het gedeelte Taken op uw Azure Pipelines-dashboard.

Omdat uw code een goede overeenkomst leek te zijn voor de sjabloon Go, hebben we uw pijplijn automatisch gemaakt.

U hebt nu een werkende YAML-pijplijn (azure-pipelines.yml) in uw opslagplaats die u kunt aanpassen.

Wanneer u klaar bent om wijzigingen aan te brengen in uw pijplijn, selecteert u deze op de pagina Pijplijnen en het azure-pipelines.yml-bestand bewerken.

Hint

Als u wijzigingen wilt aanbrengen in het YAML-bestand zoals beschreven in dit artikel, selecteert u de pijplijn in pijplijnen pagina en selecteert u vervolgens Bewerken om een editor voor het azure-pipelines.yml-bestand te openen.

Een afbeelding bouwen en uploaden naar het containerregister

Voor uw Go-app kunt u ook een image bouwen en deze naar een containerregister pushen.

Verwante extensies

Go-extensie voor Visual Studio Code (Microsoft)