Erstellen und Testen von Go-Projekten

Azure DevOps Services

Verwenden Sie eine Pipeline, um Ihre Go-Projekte automatisch zu erstellen und zu testen.

Erstellen Ihrer ersten Pipeline

Neu bei Azure Pipelines? Wenn dies der Fall ist, sollten Sie sich zunächst mit diesem Abschnitt beschäftigen, bevor Sie mit anderen Abschnitten fortfahren.

Verzweigen Sie das folgende Repository auf GitHub:

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

Anmelden bei Azure Pipelines

Melden Sie sich bei Azure Pipelines an. Nach der Anmeldung wechselt Ihr Browser zu https://dev.azure.com/my-organization-name und zeigt Ihr Azure DevOps-Dashboard an.

1. Gehen Sie in einem Browser zu dev.azure.com, und melden Sie sich an.
2. Wählen Sie Ihre Organisation aus.
3. Erstellen Sie ein neues Projekt, indem Sie Neues Projekt oder Projekt erstellen wählen, wenn Sie das erste Projekt in der Organisation erstellen.
4. Geben Sie einen Projektnamen ein.
5. Wählen Sie die Sichtbarkeit für Ihr Projekt.
6. Klicken Sie auf Erstellen.

1. Gehen Sie in einem Browser zu Ihrem Azure DevOps-Server.
2. Wählen Sie Ihre Sammlung.
3. Erstellen Sie ein neues Projekt, indem Sie Neues Projekt oder Projekt erstellen wählen, wenn Sie das erste Projekt in der Sammlung erstellen.
4. Geben Sie einen Projektnamen ein.
5. Wählen Sie die Sichtbarkeit für Ihr Projekt.
6. Klicken Sie auf Erstellen.

Erstellen der Pipeline

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und wechseln Sie zu Ihrem Projekt.

2. Gehen Sie zu Pipelines und wählen Sie dann Neue Pipeline aus oder Pipeline erstellen, wenn Sie Ihre erste Pipeline erstellen.

3. Führen Sie die Schritte des Assistenten aus. Dabei wählen Sie zuerst GitHub als Speicherort Ihres Quellcodes aus.

4. Möglicherweise werden Sie zu GitHub weitergeleitet, um sich anzumelden. Geben Sie in diesem Fall Ihre Anmeldeinformationen für GitHub ein.

5. Wenn die Liste der Repositorys angezeigt wird, wählen Sie Ihr Repository aus.

6. Sie werden möglicherweise zu GitHub weitergeleitet, um die Azure Pipelines-App zu installieren. Wählen Sie in diesem Fall „Approve & Install“ (Genehmigen und installieren) aus.

Wenn die Registerkarte Konfigurieren angezeigt wird, wählen Sie Go aus. Ihre neue Pipeline wird angezeigt, und die YAML-Datei azure-pipelines.yml kann konfiguriert werden. In den folgenden Abschnitten erfahren Sie mehr über die gängigen Möglichkeiten zum Anpassen Ihrer Pipeline.

Buildumgebung

Sie können Azure Pipelines verwenden, um Ihre Go-Projekte zu erstellen, ohne eine eigene Infrastruktur einrichten zu müssen. Sie können Linux-, macOS- oder Windows-Agents verwenden, um Ihre Builds auszuführen.

Aktualisieren Sie das folgende Schnipsel in Ihrer azure-pipelines.yml-Datei, um das entsprechende Image auszuwählen.

pool:
  vmImage: 'ubuntu-latest'

Moderne Versionen von Go sind auf von Microsoft gehosteten Agents vorinstalliert. Die genauen Versionen der vorinstallierten Go-Version finden Sie unter von Microsoft gehosteten Agents in Azure Pipelines.

Einrichten von Go

Go 1.11 und höher

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

Go < 1.11

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.

Hinweis

Das folgende Skript wird auf Linux- und macOS-Agents ausgeführt und kann für ältere Versionen von Go verwendet werden, die eine bestimmte Ordnerstruktur erfordern. Das Skript ist für Unix-Shells geschrieben und kann daher nicht mit Windows-Agents verwendet werden.

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

Entwickeln

Verwenden Sie go build, um Ihr Go-Projekt zu erstellen. Fügen Sie Ihrer Datei azure-pipelines.yml das folgende Codeschnipsel hinzu:

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

Test

Verwenden Sie go test, um Ihr Go-Modul und dessen Unterverzeichnisse (./...) zu testen. Fügen Sie Ihrer Datei azure-pipelines.yml das folgende Codeschnipsel hinzu:

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

Wenn Sie bereit sind, committen Sie eine neue azure-pipelines.yml-Datei in Ihr Repository, und aktualisieren Sie die Commitnachricht. Klicken Sie auf Speichern und ausführen.

Wenn Sie Ihre Pipeline in Aktion beobachten möchten, wählen Sie den Build in der Option Aufträge in Ihrem Azure Pipelines-Dashboard aus.

Da Ihr Code für die Go-Vorlage geeignet schien, wurde Ihre Pipeline automatisch erstellt.

Sie verfügen nun über eine funktionierende YAML-Pipeline (azure-pipelines.yml) in Ihrem Repository, die Sie anpassen können.

Wenn Sie bereit sind, Änderungen an Ihrer Pipeline vorzunehmen, wählen Sie sie auf der Seite Pipelines aus, und bearbeiten Sie dann die azure-pipelines.yml-Datei.

Tipp

Um wie in diesem Artikel beschrieben Änderungen an der YAML-Datei vorzunehmen, wählen Sie die Pipeline auf der Seite Pipelines aus, und wählen Sie dann Bearbeiten aus, um den Editor für die azure-pipelines.yml-Datei zu öffnen.

Erstellen eines Images und Pushen in eine Containerregistrierung

Für Ihre Go-App können Sie auch ein Image erstellen und in eine Containerregistrierung pushen.

Zugehörige Erweiterungen

Go-Erweiterung für Visual Studio Code (Microsoft)