Go-projektek létrehozása és tesztelése

Azure DevOps Services

Egy folyamat használatával automatikusan létrehozhatja és tesztelheti Go-projektjeit.

Az első folyamat létrehozása

Új az Azure Pipelines? Ha igen, akkor javasoljuk, hogy próbálja ki ezt a szakaszt, mielőtt továbblépne más szakaszokra.

Fork a következő adattár a GitHubon:

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

Bejelentkezés az Azure Pipelinesba

Jelentkezzen be az Azure Pipelinesba. A bejelentkezés után a böngésző megtekinti https://dev.azure.com/my-organization-name és megjeleníti az Azure DevOps-irányítópultot.

1. Egy böngészőben nyissa meg a dev.azure.com , és jelentkezzen be.
2. Válassza ki a szervezetet.
3. Hozzon létre egy új projektet az Új projekt vagy a Projekt létrehozása lehetőség kiválasztásával, ha az első projektet hozza létre a szervezetben.
4. Adjon meg egy projektnevet.
5. Válassza ki a projekt láthatóságát .
6. Válassza a Létrehozás lehetőséget.

1. Egy böngészőben nyissa meg az Azure DevOps Servert.
2. Válassza ki a gyűjteményt.
3. Új projekt létrehozásához válassza az Új projekt vagy a Projekt létrehozása lehetőséget, ha az első projektet hozza létre a gyűjteményben.
4. Adjon meg egy projektnevet.
5. Válassza ki a projekt láthatóságát .
6. Válassza a Létrehozás lehetőséget.

A folyamat létrehozása

1. Jelentkezzen be az Azure DevOps-szervezetbe, és nyissa meg a projektet.

2. Lépjen a Folyamatok elemre, majd válassza az Új folyamat vagy a Folyamat létrehozása lehetőséget az első folyamat létrehozásakor.

3. Végezze el a varázsló lépéseit úgy, hogy először a GitHubot választja a forráskód helyeként.

4. Előfordulhat, hogy a rendszer átirányítja a GitHubra a bejelentkezéshez. Ha igen, adja meg a GitHub hitelesítő adatait.

5. Amikor megjelenik az adattárak listája, válassza ki az adattárat.

6. Előfordulhat, hogy a Rendszer átirányítja a GitHubra az Azure Pipelines alkalmazás telepítéséhez. Ha igen, válassza a Jóváhagyás > telepítés lehetőséget.

Amikor megjelenik a Konfigurálás lap, válassza az Ugrás lehetőséget. Megjelenik az új folyamat, és a azure-pipelines.yml YAML-fájl konfigurálható. Az alábbi szakaszokban megismerheti a folyamat testreszabásának leggyakoribb módjait.

Környezet létrehozása

Az Azure Pipelines használatával saját infrastruktúra beállítása nélkül hozhatja létre Go-projektjeit. Linux, macOS vagy Windows-ügynökök használatával futtathatja a buildeket.

Frissítse az alábbi kódrészletet a fájlban a azure-pipelines.yml megfelelő kép kiválasztásához.

pool:
  vmImage: 'ubuntu-latest'

A Go modern verziói előre telepítve vannak a Microsoft által üzemeltetett ügynökökre. Az előre telepített Go pontos verzióiért tekintse meg a Microsoft által üzemeltetett ügynököket az Azure Pipelinesban.

Az Ugrás beállítása

Go 1.11+

A Go 1.11-től kezdve már nem kell környezetet definiálnia $GOPATH , munkaterület-elrendezést beállítania vagy a modult használnia dep . A függőségkezelés már be van építve.

Ez a YAML implementálja a go get Go-csomagok és függőségeik letöltésére szolgáló parancsot. Ezután a feladattal PublishBuildArtifacts@1 közzétett tartalom létrehozásához használjago build.

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

Ugrás < 1.11

A Go dokumentációja szerint a Go-munkaterületek egy gyökérkönyvtárból állnak, amelyre a $GOPATH környezeti változók rámutatnak. A könyvtáron belül a következő standard alkönyvtárak találhatók:

• bin végrehajtható parancsok
• pkg lefordított csomagok (.a fájlok)
• srcGo-forrásfájlok (.go, .c, .g) .s

Amikor egy Azure Pipelines-build lekéri a kódot egy távoli adattárból, a kódot a build alapértelmezett munkakönyvtárába helyezi. A Go-munkaterület várt szerkezetének megfelelően adja hozzá a következő kódrészletet a azure-pipelines.yml fájlhoz. Ez a szkript Bash-ben fut Linuxon és macOS-ügynökökön, de Windows esetén módosítani kell.

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'

Ha a kód nem a GitHubon található, módosítsa a modulePath változó használatát github.com a modul megfelelő értékére.

Ez a kódrészlet a következő műveleteket hajtja végre:

1. Beállítja $GOROOT a használni kívánt Go-verziót.
2. Az egyéb jól ismert Go környezeti változókat a megfelelő értékekre állítja.
3. Létrehoz egy Go-munkaterületet egy gyermekkönyvtárakkal srcpkgbinés .gopath
4. A távoli adattárból lekért kód áthelyezése a munkaterület src könyvtárába
5. Hozzáadja a Go verziót és a munkaterület bin könyvtárát az elérési úthoz.

Függőségek telepítése

Használat – lekérés

A Go-projekt forráskódjának letöltésére vagy egy eszköz Go-munkaterületre való telepítésére használható go get . Adja hozzá a következő kódrészletet a azure-pipelines.yml fájlhoz:

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

A dep használata

Akkor használja dep ensure , ha a projekt dep használatával tölti le a kódba importált függőségeket. Klónok importált adattárainak futtatása dep ensure a projekt szállítói könyvtárába. A fájlok és Gopkg.toml a Gopkg.lock fájlok garantálják, hogy a projekten dolgozó összes felhasználó ugyanazt a függőségi verziót használja, mint a build. Adja hozzá a következő kódrészletet a azure-pipelines.yml fájlhoz.

Feljegyzés

Az alábbi szkript linuxos és macOS-ügynökökön fut, és a Go régebbi verzióihoz használható, amelyek egy adott mappastruktúrát igényelnek. A szkript Unix-rendszerhéjakhoz van megírva, ezért nem használható Windows-ügynökökkel.

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

Build

A Go-projekt létrehozásához használható go build . Adja hozzá a következő kódrészletet a azure-pipelines.yml fájlhoz:

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

Teszt

A go modul és alkönyvtárainak (./...) tesztelésére használhatógo test. Adja hozzá a következő kódrészletet a azure-pipelines.yml fájlhoz:

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

Amikor elkészült, véglegesítsen egy új azure-pipelines.yml fájlt az adattárban, és frissítse a véglegesítési üzenetet. Válassza a Mentés és futtatás lehetőséget.

Ha működés közben szeretné megtekinteni a folyamatot, válassza ki a buildet az Azure Pipelines-irányítópult Feladatok lehetőségében.

Mivel a kód jónak tűnt a Go-sablonhoz , automatikusan létrehoztuk a folyamatot.

Most már rendelkezik egy működő YAML-folyamat (azure-pipelines.yml) az adattárban, amely készen áll a testreszabásra!

Ha készen áll a folyamat módosítására, jelölje ki azt a Folyamatok lapon, majd szerkessze a azure-pipelines.yml fájlt.

Tipp.

Ha módosítani szeretné a YAML-fájlt a cikkben leírtak szerint, jelölje ki a folyamatot a Folyamatok lapon, majd a Szerkesztés gombra kattintva nyissa meg a fájl szerkesztőjének azure-pipelines.yml megnyitását.

Rendszerkép létrehozása és leküldés a tárolóregisztrációs adatbázisba

A Go-alkalmazáshoz létrehozhat egy lemezképet, és leküldheti azt egy tárolóregisztrációs adatbázisba.

Kapcsolódó bővítmények

Go-bővítmény a Visual Studio Code-hoz (Microsoft)