Go プロジェクトをビルドしてテストする

Azure DevOps Services

パイプラインを使用して、Go プロジェクトを自動的にビルドしてテストします。

最初のパイプラインの作成

Azure Pipelines は初めてですか? その場合は、他のセクションに進む前に、このセクションを試してみることをお勧めします。

GitHub で次のリポジトリをフォークします。

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

Azure Pipelines にサインインする

Azure Pipelines にサインインします。 サインインすると、ブラウザーが https://dev.azure.com/my-organization-name に移動し、Azure DevOps ダッシュボーが表示されます。

選択した組織内で、"プロジェクト" を作成します。 組織にプロジェクトがない場合、 [プロジェクトを作成して開始します] 画面が表示されます。 それ以外の場合は、ダッシュボードの右上隅にある [ 新しいプロジェクト ] ボタンを選択します。

パイプラインを作成する

1. Azure DevOps 組織にサインインし、プロジェクトに移動します。

2. パイプラインに移動し、[新しいパイプライン] を選択します。

3. 最初に、ソース コードの場所として GitHub を選択し、ウィザードの手順を実行します。

4. サインインするために GitHub にリダイレクトされる場合があります。 その場合は、GitHub の資格情報を入力します。

5. リポジトリの一覧が表示されたら、目的のリポジトリを選択します。

6. Azure Pipelines アプリをインストールするために、GitHub にリダイレクトされる場合があります。 その場合は、[承認してインストール] を選択します。

[構成] タブが表示されたら、[移動] を選択します。 新しいパイプラインが表示され、YAML ファイルを azure-pipelines.yml 構成する準備が整います。 パイプラインをカスタマイズする一般的な方法の一部については、次のセクションを参照してください。

ビルド環境

Azure Pipelines を使用すると、独自のインフラストラクチャを設定せずに Go プロジェクトをビルドできます。 Linux、macOS、または Windows エージェントを使用してビルドを実行できます。

ファイル内の次のスニペットを azure-pipelines.yml 更新して、適切なイメージを選択します。

pool:
  vmImage: 'ubuntu-latest'

Go の最新バージョンは、 Microsoft がホストするエージェントにプレインストールされています。 プレインストールされている Go の正確なバージョンについては、 Azure Pipelines の Microsoft でホストされているエージェントを参照してください。

Go を設定する

Go 1.11 以降

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

この YAML は、 go get Go パッケージとその依存関係をダウンロードするコマンドを実装します。 その後、タスクと共PublishBuildArtifacts@1に発行されるコンテンツを生成するために使用go buildされます。

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 のドキュメント で説明されているように、Go ワークスペースは、環境変数が指すルート ディレクトリで $GOPATH 構成されます。 そのディレクトリ内には、次の標準サブディレクトリがあります。

• bin 実行可能コマンドを含む場合
• pkg コンパイル済みパッケージ (.a ファイル) を含む場合
• srcGo ソース ファイル (.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 にない場合は、変数のgithub.com使用をmodulePathモジュールの適切な値に変更します。

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

1. 使用する Go のバージョンに設定 $GOROOT します。
2. 他の既知の Go 環境変数を適切な値に設定します。
3. 子ディレクトリ binpkg、gopathおよび src.
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 。

Note

次のスクリプトは Linux および macOS エージェントで実行され、特定のフォルダー構造を必要とする古いバージョンの Go で使用できます。 スクリプトは Unix シェル用に記述されているため、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`'

Build

Go プロジェクトのビルドに使用 go build します。 ファイルに次のスニペットを azure-pipelines.yml 追加します。

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

テスト

go モジュールとそのサブディレクトリ (./...) をテストするために使用go testします。 ファイルに次のスニペットを azure-pipelines.yml 追加します。

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

準備ができたら、新しい azure-pipelines.yml ファイルをリポジトリにコミットし、コミット メッセージを更新します。 [保存および実行] を選択します。

パイプラインの動作を監視する場合は、Azure Pipelines ダッシュボードの [ジョブ ] オプションでビルドを選択します。

コードは Go テンプレートに適しているように見えたので、パイプラインが自動的に作成されました。

これで、リポジトリに作業用の YAML パイプライン (azure-pipelines.yml) が作成され、カスタマイズする準備ができました。

パイプラインを変更する準備ができたら、[パイプライン] ページでパイプラインを選択し、ファイルをazure-pipelines.yml編集します。

ヒント

この記事の説明に従って YAML ファイルを変更するには、[ パイプライン ] ページでパイプラインを選択し、[ 編集] を選択してファイルのエディターを azure-pipelines.yml 開きます。

イメージをビルドしてコンテナー レジストリにプッシュする

Go アプリの場合は、 イメージをビルド して コンテナー レジストリにプッシュすることもできます。

関連する拡張機能

Visual Studio Code の Go 拡張機能 (Microsoft)