Membangun dan menguji proyek Go

Azure DevOps Services

Gunakan alur untuk membuat dan menguji proyek Go Anda secara otomatis.

Buat alur kerja pertama Anda

Baru menggunakan Azure Pipelines? Jika demikian, kami sarankan Anda mencoba bagian ini sebelum beralih ke bagian lain.

Fork repositori berikut pada GitHub:

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

Masuk ke Azure Pipelines

Masuk ke Azure Pipelines. Setelah Anda masuk, browser Anda masuk ke https://dev.azure.com/my-organization-name dan menampilkan dasbor Azure DevOps Anda.

1. Di browser, buka dev.azure.com dan masuk.
2. Pilih organisasi Anda.
3. Buat proyek baru dengan memilih Proyek baru atau Buat proyek jika membuat proyek pertama di organisasi.
4. Masukkan Nama proyek.
5. Pilih Visibilitas untuk proyek Anda.
6. Pilih Buat.

Membuat alur kerja

1. Masuk ke organisasi Azure DevOps Anda dan buka proyek Anda.

2. Pergi ke Pipeline, kemudian pilih Pipeline Baru atau Buat Pipeline jika membuat pipeline pertama Anda.

3. Lakukan langkah-langkah wizard dengan terlebih dahulu memilih GitHub sebagai lokasi kode sumber Anda.

4. Anda dapat diarahkan ke GitHub untuk masuk. Jika demikian, masukkan informasi masuk GitHub Anda.

5. Saat Anda melihat daftar repositori, pilih repositori Anda.

6. Anda mungkin diarahkan ke GitHub untuk menginstal aplikasi Azure Pipelines. Jika demikian, pilih Setujui & instal.

Saat tab Konfigurasi muncul, pilih Buka. Pipeline baru Anda muncul, dengan file YAML azure-pipelines.yml yang siap untuk dikonfigurasi. Lihat bagian berikut untuk mempelajari beberapa cara yang lebih umum untuk menyesuaikan alur Anda.

Membangun lingkungan

Anda dapat menggunakan Azure Pipelines untuk membangun proyek Go Anda tanpa menyiapkan infrastruktur anda sendiri. Anda dapat menggunakan agen Linux, macOS, atau Windows untuk menjalankan build Anda.

Perbarui cuplikan berikut dalam file Anda azure-pipelines.yml untuk memilih gambar yang sesuai.

pool:
  vmImage: 'ubuntu-latest'

Versi modern Go telah diinstal sebelumnya pada agen yang dihosting Microsoft. Untuk versi yang tepat dari Go yang telah diinstal sebelumnya, lihat agen yang dihosting Microsoft di Azure Pipelines.

Siapkan Go

Go 1.11+

Dimulai dengan Go 1.11, Anda tidak perlu lagi menentukan $GOPATH lingkungan, menyiapkan tata letak ruang kerja, atau menggunakan dep modul. Manajemen dependensi sekarang sudah terintegrasi.

YAML ini mengimplementasikan go get perintah untuk mengunduh paket Go dan dependensinya. Kemudian menggunakan go build untuk menghasilkan konten yang diterbitkan melalui tugas PublishBuildArtifacts@1.

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

Seperti yang dijelaskan dalam dokumentasi Go, ruang kerja Go terdiri dari direktori akar yang ditunjuk oleh variabel lingkungan . Dalam direktori tersebut, adalah subdirektori standar berikut:

• bin untuk berisi perintah yang dapat dieksekusi
• pkg digunakan untuk berisi paket yang telah dikompilasi (.a file)
• srcuntuk menampung file sumber Go (.go, .c, .g, .s)

Saat Azure Pipelines melakukan build dan mengambil kode dari repositori remote, kode ditempatkan di "default working directory" build tersebut. Agar sesuai dengan struktur ruang kerja Go yang diharapkan, tambahkan cuplikan berikut ke file Anda azure-pipelines.yml . Skrip ini berjalan di bash pada agen Linux dan macOS, tetapi harus dimodifikasi untuk Windows.

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'

Jika kode Anda tidak ada di GitHub, ubah penggunaan variabel modulePath menjadi nilai yang sesuai untuk modul Anda.

Cuplikan ini melakukan tindakan berikut:

1. Mengatur $GOROOT ke versi Go yang seharusnya digunakan.
2. Mengatur variabel lingkungan Go terkenal lainnya ke nilai yang tepat.
3. Membuat ruang kerja Go di subdirektori bernama gopath dengan direktori anak bin, pkg, dan src.
4. Memindahkan kode yang diambil dari repositori jarak jauh ke direktori ruang src kerja
5. Menambahkan direktori ruang kerja bin dan versi Go ke dalam path.

Pasang dependensi

Gunakan go get

Gunakan go get untuk mengunduh kode sumber untuk proyek Go atau untuk menginstal alat ke ruang kerja Go. Tambahkan cuplikan berikut ke file Anda azure-pipelines.yml :

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

Gunakan perintah dep ensure

Gunakan dep ensure jika proyek Anda menggunakan dep untuk mengunduh dependensi yang diimpor dalam kode Anda. Menjalankan dep ensure akan mengkloning repositori yang diimpor ke dalam direktori vendor proyek Anda. File Gopkg.lock dan Gopkg.toml menjamin bahwa semua orang yang bekerja pada proyek menggunakan versi dependensi yang sama dengan build Anda. Tambahkan cuplikan berikut ke file Anda azure-pipelines.yml .

Nota

Skrip berikut berjalan di agen Linux dan macOS dan dapat digunakan untuk versi Go yang lebih lama yang memerlukan struktur folder tertentu. Skrip ditulis untuk shell Unix, dan akibatnya tidak dapat bekerja dengan agen Windows.

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

Membangun

Gunakan go build untuk membangun proyek Go Anda. Tambahkan cuplikan berikut ke file Anda azure-pipelines.yml :

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

Ujian

Gunakan go test untuk menguji modul Go Anda dan subdirektorinya (./...). Tambahkan cuplikan berikut ke file Anda azure-pipelines.yml :

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

Saat Anda siap, terapkan file azure-pipelines.yml baru ke repositori Anda dan perbarui pesan penerapan. Pilih Simpan dan jalankan.

Jika Anda ingin melihat pipeline Anda beraksi, pilih build pada opsi Pekerjaan di dasbor Azure Pipelines Anda.

Karena kode Anda tampaknya cocok untuk templat Go , kami secara otomatis membuat alur Anda.

Anda sekarang memiliki alur YAML yang berfungsi (azure-pipelines.yml) di repositori Anda yang siap untuk Anda sesuaikan!

Saat Anda siap untuk membuat perubahan pada alur Anda, pilih di halaman Alur , lalu Editazure-pipelines.yml file.

Petunjuk / Saran

Untuk membuat perubahan pada file YAML seperti yang dijelaskan dalam artikel ini, pilih alur di halaman Alur , lalu pilih Edit untuk membuka editor file azure-pipelines.yml .

Membuat gambar dan mengunggah ke registri kontainer

Untuk aplikasi Go, Anda juga dapat membuat gambar dan mendorongnya ke registri kontainer.

Ekstensi terkait

Ekstensi Go untuk Visual Studio Code