Erstellen und Testen von Go-Projekten

Ab Go 1.11 müssen Sie keine $GOPATH-Umgebung mehr definieren, ein Arbeitsbereichslayout einrichten oder das dep-Modul verwenden. Die Abhängigkeitsverwaltung ist jetzt integriert.

Dieser YAML-Code implementiert den Befehl go get zum Herunterladen von Go-Paketen und deren Abhängigkeiten. Anschließend wird go build verwendet, um den Inhalt zu generieren, der mit der PublishBuildArtifacts@1-Aufgabe veröffentlicht wird.

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

Wie in der Go-Dokumentation beschrieben, besteht ein Go-Arbeitsbereich aus einem Stammverzeichnis, auf das die Umgebungsvariable $GOPATH verweist. Innerhalb dieses Verzeichnisses sind die folgenden Standardunterverzeichnisse aufgeführt:

• bin für ausführbare Befehle
• pkg für kompilierte Pakete (.a-Dateien)
• src für Go-Quelldateien (.go, .c, .g, .s)

Wenn ein Azure Pipelines-Build Code aus einem Remoterepository abruft, wird der Code im Standardarbeitsverzeichnis des Builds platziert. Um der erwarteten Struktur eines Go-Arbeitsbereichs zu entsprechen, fügen Sie der azure-pipelines.yml-Datei den folgenden Codeausschnitt hinzu. Dieses Skript wird in Bash auf Linux- und macOS-Agents ausgeführt, muss jedoch für Windows geändert werden.

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'

Wenn sich Ihr Code nicht auf GitHub befindet, ändern Sie die Verwendung von modulePath der github.com-Variablen in einen geeigneten Wert für Ihr Modul.

Dieses Codeschnipsel führt die folgenden Aktionen aus:

1. Legt $GOROOT auf die Version von Go fest, die verwendet werden soll
2. Legt andere bekannte Go-Umgebungsvariablen auf ihre richtigen Werte fest
3. Erstellt einen Go-Arbeitsbereich in einem Unterverzeichnis namens gopath mit den untergeordneten Verzeichnissen bin, pkg und src
4. Verschiebt Code, der aus dem Remoterepository abgerufen wurde, in das Arbeitsbereichsverzeichnis src
5. Fügt die Version von Go und das Arbeitsbereichverzeichnis bin dem Pfad hinzu

Installieren von Abhängigkeiten

Verwenden von go get

Verwenden Sie go get, um den Quellcode für ein Go-Projekt herunterzuladen oder um ein Tool im Go-Arbeitsbereich zu erstellen. Fügen Sie Ihrer Datei azure-pipelines.yml das folgende Codeschnipsel hinzu:

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

Verwenden von dep ensure

Verwenden Sie dep ensure, wenn Ihr Projekt dep zum Herunterladen von Abhängigkeiten verwendet, die in Ihren Code importiert werden. Durch das Ausführen von dep ensure werden importierte Repositorys in das Anbieterverzeichnis Ihres Projekts geklont. Die Dateien Gopkg.lock und Gopkg.toml stellen sicher, dass alle Personen, die an dem Projekt arbeiten, dieselbe Version der Abhängigkeiten wie Ihr Build verwenden. Fügen Sie Ihrer Datei azure-pipelines.yml das folgende Codeschnipsel hinzu.

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