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 de volgende opslagplaats 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. Selecteer Maken.

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. Selecteer Maken.

Maak de pijplijn

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, waarbij het azure-pipelines.yml YAML-bestand gereed 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 gehoste agents. Raadpleeg voor de exacte versies van vooraf geïnstalleerde Go de door Microsoft gehoste agents in Azure Pipelines.

Go instellen

Go 1.11+

Vanaf Go 1.11 hoeft u geen omgeving meer te definiëren $GOPATH , 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 de bijbehorende afhankelijkheden te downloaden. Vervolgens wordt de go build inhoud gegenereerd die met PublishBuildArtifacts@1 de taak is gepubliceerd.

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 in de Go-documentatie wordt beschreven, bestaat een Go-werkruimte uit een hoofdmap waarnaar de $GOPATH omgevingsvariabele verwijst. Binnen die map zijn de volgende standaardsubmappen:

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

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 github.com de modulePath variabele in een geschikte waarde voor uw module.

Dit codefragment voert de volgende acties uit:

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

Afhankelijkheden installeren

Go get gebruiken

Gebruik go get deze opdracht 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 deze optie als uw project gebruikmaakt van dep om afhankelijkheden te downloaden die in uw code zijn geïmporteerd. Het uitvoeren van dep ensure klonen geïmporteerde opslagplaatsen in de leveranciermap van uw project. Het Gopkg.lock en Gopkg.toml de 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`'

Compilatie

Gebruik go build dit 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 dit om uw 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, selecteert u de build in de optie Taken op uw Azure Pipelines-dashboard.

Omdat uw code een goede overeenkomst leek te zijn voor de Go-sjabloon , 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 bewerkt u het azure-pipelines.yml bestand.

Tip

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

Een installatiekopieën bouwen en pushen naar het containerregister

Voor uw Go-app kunt u ook een installatiekopieën bouwen en naar een containerregister pushen.

Verwante extensies

Go-extensie voor Visual Studio Code (Microsoft)