Go projelerini derleme ve test etme

Azure DevOps Hizmetleri

Go projelerinizi otomatik olarak derlemek, test etmek ve dağıtmak için Azure Pipelines'ı kullanın. Bu makalede, deponuza her değişiklik gönderişinizde Go kodunuzu derleyen ve test eden bir işlem hattı oluşturma işlemleri gösterilmektedir.

Önkoşullar

• Azure DevOps kuruluşu ve projesi. Ücretsiz bir tane oluşturun.
• GitHub veya Azure Repos deposundaki Go projesi. Projeniz yoksa, bu makalede sağlanan örnek depoyu kullanabilirsiniz.

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

Azure Pipelines'ta yeni misiniz? Diğer bölümlere geçmeden önce bu bölümü deneyin.

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.

İşlem hattını oluştur

1. Azure DevOps projenizde sol gezinti menüsünden İşlem Hatları'nı seçin.

2. Bu işlem hattı projenin ilk işlem hattıysa Yeni işlem hattı veya İşlem hattı oluştur'u seçin.

3. Kodunuz nerede ekranında GitHub'ı seçin.

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

5. Depo seçin ekranında.NET uygulamanızın içinde olduğu depoyu 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üklenmiş olarak bulunur. Ö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

Önemli

Go sürüm desteği: Go projesi artık 1.11'den önceki Go sürümlerini korumaz ve bu sürümler güvenlik güncelleştirmelerini almaz. Microsoft tarafından barındırılan aracılar yalnızca şu anda desteklenen Go sürümlerini içerir. Projeniz Go 1.10 veya önceki bir sürümü kullanıyorsa, yerleşik modül desteği, güvenlik düzeltme ekleri ve performans geliştirmelerinden yararlanmak için Go 1.21 veya sonraki bir sürüme yükseltin. Sürüm desteği ayrıntıları için Go sürüm geçmişine bakın.

Go 1.11+

Go 1.11'den itibaren artık bir ortam değişkeni 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 Go modülleriyle yerleşiktir.

Bu YAML, Go paketlerini ve bağımlılıklarını indirmek için komutunu uygular go get . Ardından, go build kullanarak PublishBuildArtifacts@1 görevi tarafından yayımlanan içeriği oluşturur.

trigger: 
 - main

pool:
   vmImage: 'ubuntu-latest'

steps: 
- task: GoTool@0
  inputs:
    version: '1.22'  # Use a currently supported Go version
- 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 (önceki)

Uyarı

1.11'den önceki Go sürümleri kullanım ömrü sonuna ulaştı ve artık güvenlik güncelleştirmelerini almıyor. dep Bağımlılık yöneticisi de kullanım dışıdır. Bu bölüm yalnızca hemen yükseltilemeyecek eski projeler için sağlanır. Go modülleriyle Go 1.21 veya sonraki bir sürüme geçiş yapın.

Go belgelerinde açıklandığı gibi Go çalışma alanı, ortam değişkeninin $GOPATH işaret ettiği bir kök dizinden oluşur. $GOPATH, Go derleyicisine kaynak kodu ve bağımlılıkları nerede bulacağını bildiren Go'ya özgü bir ortam değişkenidir. 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 üzerinde çalışır, ancak Windows ortamında uyarlamanız 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. Kullanmak istediğiniz Go sürümüne ayarlar $GOROOT .
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. Derlemenin uzak depodan getirttiği 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

Uyarı

Araç dep kullanım dışıdır ve bakımı yapılmamaktadır. Tüm Go projeleri için Go 1.11'den bu yana resmi bağımlılık yönetimi çözümü olan Go modüllerine geçiş yapın.

Eski projeniz, kodunuzdaki içeri aktarılan bağımlılıkları indirmek için hâlâ dep kullanıyorsa, dep ensure kullanın. komutu, dep ensure içeri aktarılan depoları projenizin satıcı dizinine kopyalar. Gopkg.lock Ve Gopkg.toml 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ılmıştı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 (go test ) test etmek için kullanın./.... 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 Azure Pipelines işlem hattınızı otomatik olarak oluşturmuştur.

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şturma ve Azure Container Registry'ye gönderme

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

İlgili içerik

• Visual Studio Code için go uzantısı
• Microsoft tarafından barındırılan aracılar
• YAML şema referansı
• Go modülleri belgeleri