Go プロジェクトのビルドとテスト

Go 1.11 以降では、 $GOPATH 環境を定義したり、ワークスペース レイアウトを設定したり、 dep モジュールを使用したりする必要がなくなりました。 依存関係管理が組み込まれるようになりました。

この YAML は、Go パッケージとその依存関係をダウンロードする go get コマンドを実装します。 その後、 go build を使用して、 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 のドキュメント で説明されているように、Go ワークスペースは、 $GOPATH 環境変数が指すルート ディレクトリで構成されます。 そのディレクトリ内には、次の標準サブディレクトリがあります。

• bin 実行可能コマンドを含める場合
• pkg コンパイル済みパッケージ (.a ファイル) を含む場合
• src Go ソース ファイル (.go、 .c、 .g、 .s) を格納する場合

Azure Pipelines ビルドがリモート リポジトリからコードをフェッチすると、コードはビルドの既定の作業ディレクトリに配置されます。 Go ワークスペースの予想される構造と一致させるために、次のスニペットを azure-pipelines.yml ファイルに追加します。 このスクリプトは Linux および macOS エージェント上の bash で実行されますが、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'

コードが GitHub にない場合は、 modulePath 変数の github.com の使用をモジュールの適切な値に変更します。

このスニペットは、次のアクションを実行します。

1. $GOROOT使用する Go のバージョンを設定します。
2. 他の既知の Go 環境変数を適切な値に設定します。
3. 子ディレクトリがbin、pkg、およびsrcgopathという名前のサブディレクトリに Go ワークスペースを作成します。
4. リモート リポジトリからフェッチされたコードをワークスペース src ディレクトリに移動します。
5. Go のバージョンとワークスペース bin ディレクトリをパスに追加します。

依存関係のインストール

go get を使用する

go プロジェクトのソース コードをダウンロードしたり、Go ワークスペースにツールをインストールしたりするには、 go get を使用します。 次のスニペットを azure-pipelines.yml ファイルに追加します。

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

dep ensure を使用する

プロジェクトで dep を使用してコードにインポートされた依存関係をダウンロードする場合は、 dep ensure を使用します。 dep ensure実行すると、インポートされたリポジトリがプロジェクトのベンダー ディレクトリに複製されます。 その Gopkg.lock ファイルと Gopkg.toml ファイルは、プロジェクトで作業するすべてのユーザーがビルドと同じバージョンの依存関係を使用することを保証します。 azure-pipelines.yml ファイルに次のスニペットを追加します。

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