Membangun dan menguji proyek Go

Azure DevOps

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

Membuat alur 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.

1. Di browser, buka Azure DevOps Server Anda.
2. Pilih koleksi Anda.
3. Buat proyek baru dengan memilih Proyek baru atau Buat proyek jika membuat proyek pertama dalam koleksi.
4. Masukkan Nama proyek.
5. Pilih Visibilitas untuk proyek Anda.
6. Pilih Buat.

Membuat alur

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

2. Buka Alur, lalu pilih Alur baru atau Buat alur jika membuat alur 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. Alur baru Anda muncul, dengan azure-pipelines.yml file YAML siap 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.

YAML

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 dibangun.

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

YAML

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 dokumentasi Go, ruang kerja Go terdiri dari direktori akar tempat $GOPATH variabel lingkungan menunjuk. Dalam direktori tersebut, adalah subdirektori standar berikut:

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

Saat build Azure Pipelines mengambil kode dari repositori jarak jauh, build menempatkan kode di direktori kerja default build. 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.

YAML

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 modulePath penggunaan github.com variabel menjadi nilai yang sesuai untuk modul Anda.

Cuplikan ini melakukan tindakan berikut:

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

Instal dependensi

Gunakan pergi dapatkan

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 :

YAML

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

Gunakan dep pastikan

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

Catatan

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.

YAML

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

Build

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

YAML

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

Uji

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

YAML

- 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 menonton alur Anda beraksi, pilih build di 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 Edit azure-pipelines.yml file.

Tip

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 .

Membangun gambar dan mendorong ke registri kontainer

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

Ekstensi terkait

Ekstensi Go untuk Visual Studio Code (Microsoft)