Go projelerini derleme ve test etme

Makale
04/04/2024

Azure DevOps Services

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

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

Azure Pipelines'ta yeni misiniz? Öyleyse, diğer bölümlere geçmeden önce bu bölümü denemenizi öneririz.

GitHub'da aşağıdaki deponun çatalını oluşturun:

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

Azure Pipelines'da oturum açın. Oturum açtığınızda tarayıcınız Azure https://dev.azure.com/my-organization-name DevOps panonuzu görüntüler.

Tarayıcıda dev.azure.com gidin ve oturum açın.
Kuruluşunuzu seçin.
Kuruluştaki ilk projeyi oluşturuyorsanız Yeni proje'yi veya Proje oluştur'u seçerek yeni bir proje oluşturun.
Bir Proje adı girin.
Projenizin Görünürlüğünü seçin.
Oluştur'u belirleyin.

Tarayıcıda Azure DevOps Sunucunuza gidin.
Koleksiyonunuzu seçin.
Koleksiyonda ilk projeyi oluşturuyorsanız Yeni proje'yi veya Proje oluştur'u seçerek yeni bir proje oluşturun.
Bir Proje adı girin.
Projenizin Görünürlüğünü seçin.
Oluştur'u belirleyin.

İşlem hattını oluşturma

Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.
İşlem Hatları'na gidin ve ardından yeni işlem hattı veya İlk işlem hattınızı oluşturuyorsanız işlem hattı oluştur'u seçin.
İlk olarak kaynak kodunuzun konumu olarak GitHub'ı seçerek sihirbazın adımlarını uygulayın.
Oturum açmak için GitHub'a yönlendirilebilirsiniz. Öyleyse GitHub kimlik bilgilerinizi girin.
Depo listesini gördüğünüzde deponuzu seçin.
Azure Pipelines uygulamasını yüklemek için GitHub'a yönlendirilebilirsiniz. Öyleyse Onayla ve yükle'yi seçin.

Yapılandır sekmesi görüntülendiğinde Git'i seçin. Yeni işlem hattınız görüntülenir ve azure-pipelines.yml YAML dosyası yapılandırılmaya hazır olur. İşlem hattınızı özelleştirmenin yaygın yollarından bazılarını öğrenmek için aşağıdaki bölümlere bakın.

Derleme ortamı

Kendi altyapınızı ayarlamadan Go projelerinizi oluşturmak için Azure Pipelines'ı kullanabilirsiniz. Derlemelerinizi çalıştırmak için Linux, macOS veya Windows aracılarını kullanabilirsiniz.

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

pool:
  vmImage: 'ubuntu-latest'

Go'nun modern sürümleri Microsoft tarafından barındırılan aracılara önceden yüklenir. Önceden yüklenmiş Go'nun tam sürümleri için Bkz. Azure Pipelines'da Microsoft tarafından barındırılan aracılar.

Go 1.11'den itibaren artık bir ortam tanımlamanız, çalışma $GOPATH alanı düzeni ayarlamanız veya modülü kullanmanız dep gerekmez. Bağımlılık yönetimi artık yerleşiktir.

Bu YAML, Go paketlerini ve bağımlılıklarını indirmek için komutunu uygular go get . Ardından, görevle PublishBuildArtifacts@1 yayımlanan içeriği oluşturmak için kullanırgo 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

Go belgelerinde açıklandığı gibi Go çalışma alanı, ortam değişkeninin $GOPATH işaret ettiği bir kök dizinden oluşur. Bu dizinde aşağıdaki standart alt dizinler bulunur:

bin yürütülebilir komutlar içermesi için
pkg derlenmiş paketleri (.a dosyaları) içermesi için
srcGo kaynak dosyalarını (.go, .c, , .g.s) içermesi için

Azure Pipelines derlemesi uzak bir depodan kod getirildiğinde, kodu derlemenin varsayılan çalışma dizinine yerleştirir. Go çalışma alanının beklenen yapısıyla eşleşmesi için dosyanıza azure-pipelines.yml aşağıdaki kod parçacığını ekleyin. Bu betik Linux ve macOS aracılarında Bash'te çalışır, ancak Windows için değiştirilmesi gerekir.

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'da değilse değişkenin modulePath kullanımını github.com modülünüz için uygun bir değerle değiştirin.

Bu kod parçacığı aşağıdaki eylemleri gerçekleştirir:

Kullanılması gereken Go sürümüne ayarlar $GOROOT .
Diğer iyi bilinen Go ortam değişkenlerini uygun değerlerine ayarlar.
, ve srcalt dizinleriyle pkgbinadlı gopath bir alt dizinde Go çalışma alanı oluşturur.
Uzak depodan getirilen kodu çalışma alanı src dizinine taşır
Go sürümünü ve çalışma alanı bin dizinini yola ekler.

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

Git al'ı kullanma

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

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

dep emin olun seçeneğini kullanın

Projeniz kodunuzda içeri aktarılan bağımlılıkları indirmek için dep kullanıyorsa kullanın dep ensure . Kopyaların projenizin satıcı dizinine içeri aktarılmış depoları çalıştırma dep ensure . Gopkg.toml Ve Gopkg.lock dosyaları, proje üzerinde çalışan herkesin derlemenizle aynı bağımlılık sürümünü kullanmasını garanti eder. Aşağıdaki kod parçacığını dosyanıza azure-pipelines.yml ekleyin.

Not

Aşağıdaki betik Linux ve macOS aracılarında çalışır ve go'nun belirli bir klasör yapısı gerektiren eski sürümleri için kullanılabilir. Betik Unix kabukları için yazılır ve sonuç olarak Windows aracılarıyla ç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`'

Oluşturma

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

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

Test etme

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

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

Hazır olduğunuzda deponuza yeni bir azure-pipelines.yml dosyası işleyin ve işleme iletisini güncelleştirin. Kaydet ve çalıştır'ı seçin.

İşlem hattınızı iş başında izlemek istiyorsanız Azure Pipelines panonuzdaki İşler seçeneğinde derlemeyi seçin. Azure Pipelines İşleri seçeneği belirlendiğinde işlem hattı derlemesi çalışırken.

Kodunuz Go şablonuna uygun göründüğünden işlem hattınızı otomatik olarak oluşturduk.

Artık deponuzda özelleştirmeniz için hazır çalışan bir YAML işlem hattı (azure-pipelines.yml) var!

İşlem hattınızda değişiklik yapmaya hazır olduğunuzda İşlem Hatları sayfasından seçin ve ardından Dosyayı düzenleyinazure-pipelines.yml.

İpucu

YAML dosyasında bu makalede açıklandığı gibi değişiklik yapmak için İşlem Hatları sayfasında işlem hattını seçin ve ardından Düzenle'yi seçerek dosya için azure-pipelines.yml bir düzenleyici açın. Daha fazla seçenek seçili ve Düzenle vurgulanmış şekilde panodan Azure Pipeline'ın nasıl düzenlendiğini gösteren ekran görüntüsü.

Görüntü oluşturma ve kapsayıcı kayıt defterine gönderme

Go uygulamanız için bir görüntü derleyebilir ve bunu bir kapsayıcı kayıt defterine gönderebilirsiniz.

Visual Studio Code için go uzantısı (Microsoft)

Aracılığıyla paylaş

Go projelerini derleme ve test etme

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

İşlem hattını oluşturma

Derleme ortamı

Go'yı ayarlama

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

Git al'ı kullanma

dep emin olun seçeneğini kullanın

Oluşturma

Test etme

Görüntü oluşturma ve kapsayıcı kayıt defterine gönderme

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Go projelerini derleme ve test etme

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

Azure Pipelines'da oturum açma

İşlem hattını oluşturma

Derleme ortamı

Go'yı ayarlama

Oluşturma

Test etme

Görüntü oluşturma ve kapsayıcı kayıt defterine gönderme

İlgili uzantılar

Geri Bildirim

Ek kaynaklar