Derleme ve test go projeleri

Makale
11/29/2021
Okumak için 4 dakika

Azure Pipelines

Go projelerinizi otomatik olarak derlemek ve test etmek için bir işlem hattı kullanın.

İlk işlem hattınızı oluşturma

Azure Pipelines yeni misiniz? Bu durumda, diğer bölümlere geçmeden önce bu bölümü denemeniz önerilir.

GitHub bu depoyu çatalla:

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

Azure Pipelinesoturum açın. oturum açtıktan sonra, tarayıcınız öğesine gider https://dev.azure.com/my-organization-name ve Azure DevOps panonuzu görüntüler.

Seçtiğiniz kuruluş içinde bir Projeoluşturun. Kuruluşunuzda bir projeniz yoksa, başlamak için bir proje oluşturun ekranına bakabilirsiniz. aksi takdirde, panonun sağ üst köşesindeki oluştur Project düğmesini seçin.

İşlem hattını oluşturma

Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.
Pipelinesgidin ve yeni işlem hattı' nı seçin.
ilk olarak GitHub kaynak kodunuzun konumu olarak seçerek sihirbazın adımlarını gözden geçir.
oturum açmak için GitHub yönlendiriliyorsunuz. bu durumda GitHub kimlik bilgilerinizi girin.
Depo listesi göründüğünde, deponuzu seçin.
Azure Pipelines uygulamasını yüklemek için GitHub yönlendiriliyorsunuz. Öyleyse, yüklemeyi Onayla' yı seçin.

Yapılandır sekmesi göründüğünde Git' i seçin.

Yeni ardışık düzen belirdiğinde, ne yaptığını görmek için YAML 'ye göz atın. Hazırsanız Kaydet ve Çalıştır' ı seçin.
Deponuza yeni bir Azure-Pipelines. yıml dosyası uygulamanız istenir. İletiden memnun olduktan sonra Kaydet ' i seçin ve yeniden çalıştırın .

İşlem hattınızı eylem bölümünde izlemek isterseniz, yapı işini seçin.

Yalnızca sizin için otomatik olarak oluşturduğumuz bir işlem hattı oluşturup çalıştırdık, çünkü kodunuz Go şablonuyla iyi bir eşleşme olarak göründü.

Artık, deponuzda özelleştirmeniz için hazır bir YAML işlem hattı ( azure-pipelines.yml ) çalışıyor!
işlem hattınızda değişiklik yapmaya hazırsanız, Pipelines sayfasında seçin ve sonra dosyayı düzenleyin .

İşlem hattınızı özelleştirmenin daha yaygın yöntemlerinden bazılarını öğrenmek için aşağıdaki bölümlere bakın.

İpucu

yaml dosyasında bu konuda açıklandığı gibi değişiklikler yapmak için Pipelines sayfasında işlem hattını seçin ve ardından düzenle ' yi seçerek dosya için bir düzenleyiciyi açın .

Yapı ortamı

kendi altyapınızı ayarlamanıza gerek kalmadan Go projelerinizi oluşturmak için Azure Pipelines kullanabilirsiniz. derlemelerinizi çalıştırmak için Linux, macos veya Windows aracılarını kullanabilirsiniz.

azure-pipelines.ymlUygun görüntüyü seçmek için dosyanızdaki aşağıdaki kod parçacığını güncelleştirin.

pool:
  vmImage: 'ubuntu-latest'

Modern bir go sürümü, Microsoft tarafından barındırılan aracılara Azure pipelines ' de önceden yüklenmiştir. Önceden yüklenmiş olan tam go sürümleri için, Microsoft tarafından barındırılan aracılarbölümüne bakın.

Git ayarla

Go 1.11 +
Git 1,11

Go 1,11 ' den başlayarak, artık bir $GOPATH ortam tanımlamanız, bir çalışma alanı düzeni ayarlamanız veya modülünü kullanmanız gerekmez dep . Bağımlılık yönetimi artık yerleşik olarak bulunur.

Bu YAML, go get Go paketlerini ve bunların bağımlılıklarını indirmek için komutunu uygular. Ardından go build görev ile yayınlanan içeriği oluşturmak için kullanır PublishBuildArtifacts@1 .

trigger: 
 - master

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 belgelerinin açıkladığıgibi, bir Go çalışma alanı, ortam değişkeninin işaret ettiği kök dizinden oluşur. Bu dizin içinde standart alt dizinler:

bin yürütülebilir komutları içermesi için
pkg derlenen paketleri ( .a Dosyalar) içerecek şekilde
src Go kaynak dosyalarını ( .go ,,, .c.g.s ) içerecek şekilde

bir Azure Pipelines derlemesi bir uzak depodan kod getirdiğinden, kodu, yapılandırmanın varsayılan çalışma dizinine koyar. Bu, bir Go çalışma alanının beklenen yapısıyla eşleşmiyor. Bunu çözmek için, dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml . Note: Bu betik, Linux ve macOS aracılarında Bash içinde çalışır, ancak Windows için değiştirilmelidir.

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'

kodunuz GitHub değilse, modulePath değişkeninin kullanımını github.com modülünüzün uygun bir değerine değiştirin.

Bu kod parçacığı şunları yapar:

$GOROOTKullanılacak git sürümü olarak ayarlanır.
Diğer iyi bilinen go ortam değişkenlerini uygun değerlerine ayarlar.
gopathAlt dizinler, ve ile adlı bir alt dizinde Go çalışma alanı oluşturur binpkgsrc .
Uzak depodan getirilen kodu çalışma alanının src dizinine kaydırır
Go sürümünü ve çalışma alanı bin dizinini yola ekler.

Bağımlılıkları yükleme

Al

go getGo projesi için kaynak kodunu indirmek veya Go çalışma alanına bir araç yüklemek için kullanın. Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

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

DEP emin olun

dep ensureProjenizde, kodunuzda içeri aktarılan bağımlılıkları indirmek için DEP kullanılıyorsa kullanın. dep ensureKopyaları içeri aktarılan depoları projenizin satıcı dizinine ekleyin. Gopkg.lockVe Gopkg.toml dosyaları, projede çalışan herkesin, sizin derlemenize göre aynı bağımlılıklar sürümünü kullandığını garanti eder. Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml .

Not

Bu betik, Linux ve macOS aracılarında çalışır ve belirli bir klasör yapısını gerektiren eski git sürümleri için kullanılabilir. betik, unıx kabukları için yazılmıştır ve sonuç olarak Windows aracılarıyla birlikte çalışamaz.

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

Derleme

go buildGo projenizi derlemek için kullanın. Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

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

Test etme

go testGo modülünüzü ve alt dizinlerini () sınamak için kullanın ./... . Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

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

Bir görüntü oluşturun ve kapsayıcı kayıt defterine gönderin

Go uygulamanız için bir görüntü oluşturup bir kapsayıcı kayıt defterinegönderebilirsiniz.

Visual Studio Code için uzantıya git (Microsoft)