Go projelerini derleme ve test etme

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 depoyu forklayın:

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

Azure Pipelines'da oturum açma

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

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

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

İşlem hattını oluştur

1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

2. İş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.

3. İlk olarak kaynak kodunuzun konumu olarak GitHub'ı seçerek sihirbazın adımlarını uygulayın.

4. Oturum açmak için GitHub'a yönlendirilebilirsiniz. Öyleyse GitHub kimlik bilgilerinizi girin.

5. Depo listesini gördüğünüzde deponuzu seçin.

6. 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'yı ayarlama

Go 1.11+

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 . Daha sonra go build kullanarak PublishBuildArtifacts@1 görevi ile yayımlanan içeriği oluşturur.

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

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
• src, Go kaynak dosyalarını (.go, .c, .g, .s) içermek 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:

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

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

'go get'i kullan

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 ensure kullanın

Projeniz kodunuzda içeri aktarılan bağımlılıkları indirmek için dep kullanıyorsa kullanın dep ensure . dep ensure klonlarını projenizin satıcı dizinine içeri aktarılan depoları çalıştırarak çalıştırır. 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.

Uyarı

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

İnşa et

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

Sınav

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 Jobs seçeneğinde derlemeyi seçin.

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 hattınızı seçin ve ardından Dosyayı düzenleyinazure-pipelines.yml.

Tavsiye

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.

Görüntü oluştur ve kapsayıcı kayıt defterine gönder

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

İlgili uzantılar

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