Sestavování a testování projektů Go

Služby Azure DevOps

Pomocí kanálu můžete automaticky sestavovat a testovat projekty Go.

Vytvoření prvního kanálu

Začínáte se službou Azure Pipelines? Pokud ano, doporučujeme vyzkoušet tento oddíl před přechodem na jiné oddíly.

Fork následující úložiště na GitHubu:

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

Přihlášení ke službě Azure Pipelines

Přihlaste se ke službě Azure Pipelines. Po přihlášení přejde váš prohlížeč na https://dev.azure.com/my-organization-name řídicí panel Azure DevOps a zobrazí ho.

1. V prohlížeči přejděte na dev.azure.com a přihlaste se.
2. Vyberte svoji organizaci.
3. Pokud vytváříte první projekt v organizaci, vytvořte nový projekt výběrem možnosti Nový projekt nebo Vytvořit projekt .
4. Zadejte název projektu.
5. Vyberte viditelnost projektu.
6. Vyberte Vytvořit.

1. V prohlížeči přejděte na Azure DevOps Server.
2. Vyberte kolekci.
3. Vytvořte nový projekt výběrem možnosti Nový projekt nebo Vytvořit projekt , pokud vytváříte první projekt v kolekci.
4. Zadejte název projektu.
5. Vyberte viditelnost projektu.
6. Vyberte Vytvořit.

Vytvoření kanálu

1. Přihlaste se ke své organizaci Azure DevOps a přejděte do svého projektu.

2. Přejděte na Kanály a pak vyberte Nový kanál nebo Vytvořit kanál , pokud vytváříte první kanál.

3. Kroky průvodce proveďte tak, že nejprve vyberete GitHub jako umístění zdrojového kódu.

4. Můžete být přesměrováni na GitHub kvůli přihlášení. Pokud ano, zadejte svoje přihlašovací údaje GitHubu.

5. Až se zobrazí seznam úložišť, vyberte úložiště.

6. K instalaci aplikace Azure Pipelines můžete být přesměrováni na GitHub. Pokud ano, vyberte Schválit a nainstalovat.

Jakmile se zobrazí karta Konfigurovat, vyberte Přejít. Zobrazí se nový kanál se souborem azure-pipelines.yml YAML připraveným ke konfiguraci. V následujících částech najdete některé z nejběžnějších způsobů přizpůsobení kanálu.

Sestavení prostředí

Azure Pipelines můžete použít k sestavení projektů Go bez nastavení vlastní infrastruktury. Ke spouštění sestavení můžete použít agenty pro Linux, macOS nebo Windows.

Aktualizujte azure-pipelines.yml následující fragment kódu v souboru, abyste vybrali příslušný obrázek.

pool:
  vmImage: 'ubuntu-latest'

Moderní verze Go jsou předinstalované na agentech hostovaných Microsoftem. Přesné verze předinstalovaného jazyka Go najdete v agentech hostovaných Microsoftem v Azure Pipelines.

Nastavení Go

Přejít na 1.11 nebo novější

Od Verze Go 1.11 už nemusíte definovat $GOPATH prostředí, nastavit rozložení pracovního prostoru nebo použít dep modul. Správa závislostí je teď integrovaná.

Tento YAML implementuje go get příkaz ke stažení balíčků Go a jejich závislostí. Potom použije go build k vygenerování obsahu publikovaného s PublishBuildArtifacts@1 úkolem.

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

Jak popisuje dokumentace k Go, pracovní prostor Go se skládá z kořenového adresáře, na který $GOPATH odkazuje proměnná prostředí. V tomto adresáři jsou následující standardní podadresáře:

• bin obsahovat spustitelné příkazy
• pkg obsahovat kompilované balíčky (.a soubory)
• src obsahovat zdrojové soubory Jazyka Go (.go, .c, .g, .s)

Když sestavení Azure Pipelines načte kód ze vzdáleného úložiště, umístí kód do výchozího pracovního adresáře sestavení. Pokud chcete odpovídat očekávané struktuře pracovního prostoru Go, přidejte do azure-pipelines.yml souboru následující fragment kódu. Tento skript běží v Bash v linuxových a macOS agentech, ale musí být upraven pro 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'

Pokud váš kód není na GitHubu, změňte modulePath použití github.com proměnné na odpovídající hodnotu pro váš modul.

Tento fragment kódu provede následující akce:

1. Nastaví $GOROOT verzi Jazyka Go, která se má použít.
2. Nastaví další dobře známé proměnné prostředí Go na správné hodnoty.
3. Vytvoří pracovní prostor Go v podadresáři s názvem gopath podřízenými adresáři bin, pkga src.
4. Přesune kód načtený ze vzdáleného úložiště do adresáře pracovního prostoru src .
5. Přidá do cesty verzi Jazyka Go a adresář pracovního prostoru bin .

Instalace závislostí

Použití funkce Go Get

Slouží go get ke stažení zdrojového kódu projektu Go nebo k instalaci nástroje do pracovního prostoru Go. Do souboru přidejte následující fragment kódu azure-pipelines.yml :

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

Ujistěte se, že používáte dep.

Použijte dep ensure , pokud váš projekt používá dep ke stažení závislostí importovaných do kódu. Spuštění dep ensure klonů importovaných úložišť do adresáře dodavatele projektu Jeho Gopkg.lock soubory Gopkg.toml a její záruky, že všichni pracující na projektu používají stejnou verzi závislostí jako váš build. Do souboru přidejte následující fragment kódu azure-pipelines.yml .

Poznámka:

Následující skript běží na agentech Linuxu a macOS a dá se použít pro starší verze Go, které vyžadují konkrétní strukturu složek. Skript je napsaný pro prostředí Unix a v důsledku toho nemůže pracovat s agenty systému Windows.

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

Sestavit

Slouží go build k sestavení projektu Go. Do souboru přidejte následující fragment kódu azure-pipelines.yml :

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

Test

Slouží go test k otestování modulu Go a jeho podadresářů (./...). Do souboru přidejte následující fragment kódu azure-pipelines.yml :

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

Až budete připraveni, potvrďte do úložiště nový soubor azure-pipelines.yml a aktualizujte zprávu potvrzení. Zvolte Uložit a Spustit.

Pokud chcete sledovat kanál v akci, vyberte build v možnosti Úlohy na řídicím panelu Azure Pipelines.

Vzhledem k tomu, že se zdá, že váš kód odpovídá šabloně Go , automaticky jsme vytvořili váš kanál.

Teď máte v úložišti funkční kanál YAML,azure-pipelines.yml který je připravený k přizpůsobení.

Až budete chtít kanál změnit, vyberte ho na stránce Pipelines a pak upravteazure-pipelines.yml soubor.

Tip

Pokud chcete provést změny v souboru YAML, jak je popsáno v tomto článku, vyberte kanál na stránce Pipelines a pak výběrem možnosti Upravit otevřete editor souboru azure-pipelines.yml .

Sestavení image a nasdílení změn do registru kontejneru

Pro aplikaci Go můžete také vytvořit image a odeslat ji do registru kontejneru.

Související rozšíření

Rozšíření Go pro Visual Studio Code (Microsoft)