Сборка и тестирование проектов 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. В браузере перейдите к dev.azure.com и войдите в систему.
2. Выберите свою организацию.
3. Создайте новый проект, выбрав новый проект или создав проект при создании первого проекта в организации.
4. Заполните поле Имя проекта.
5. Выберите видимость для вашего проекта.
6. Выберите Создать.

Создание конвейера

1. Войдите в свою организацию Azure DevOps и откройте нужный проект.

2. Перейдите к конвейерам и выберите "Создать конвейер" или "Создать конвейер" при создании первого конвейера.

3. Выполните все шаги мастера, выбрав GitHub в качестве расположения исходного кода.

4. Возможно, вас перенаправят на GitHub для входа. В этом случае введите учетные данные GitHub.

5. Когда появится список репозиториев, выберите свой.

6. Вы можете перенаправиться на GitHub, чтобы установить приложение Azure Pipelines. В этом случае выберите " Утвердить" и "Установить".

Когда появится вкладка Настройка, выберите Go. Появится новый конвейер с azure-pipelines.yml YAML-файлом, готовым к настройке. Дополнительные сведения о более распространенных способах настройки конвейера см. в следующих разделах.

Среда разработки и сборки

Azure Pipelines можно использовать для создания проектов Go без настройки собственной инфраструктуры. Для выполнения сборок можно использовать агенты Linux, macOS или Windows.

Обновите следующий фрагмент кода в файле azure-pipelines.yml, чтобы выбрать соответствующее изображение.

pool:
  vmImage: 'ubuntu-latest'

Современные версии Go предварительно установлены на агенты, размещенные на платформе Microsoft. Точные версии предварительно установленного Go см. в размещенных корпорацией Майкрософт агентах в Azure Pipelines.

Настройка Go

Go 1.11+

Начиная с Go 1.11, вам больше не нужно определять среду $GOPATH, настраивать макет рабочей области или использовать модуль dep. Теперь управление зависимостями встроено.

Этот YAML реализует команду go get для скачивания пакетов Go и их зависимостей. Затем он использует 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 < 1.11

Как в документации go описывается, рабочая область Go состоит из корневого каталога, в который указывает переменная среды $GOPATH. В этом каталоге представлены следующие стандартные подкаталогы:

• bin должно содержать исполняемые команды
• pkg должен содержать скомпилированные пакеты (файлы типа.a)
• src содержит исходные файлы Go (.go, .c, .g, .s)

Когда сборка в Azure Pipelines извлекает код из удаленного репозитория, он помещает его в рабочий каталог сборки по умолчанию. Чтобы соответствовать ожидаемой структуре рабочей области Go, добавьте следующий фрагмент кода в файл azure-pipelines.yml. Этот сценарий выполняется в bash в агентах Linux и macOS, но их необходимо изменить для 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. Создает рабочую область Go в подкаталоге с именем gopath с дочерними каталогами bin, pkgи src.
4. Перемещает код, полученный из удаленного репозитория в каталог рабочей области src
5. Добавляет в системный путь версию Go и директорию рабочей области bin.

Установка зависимостей

Используйте go get

Используйте go get, чтобы скачать исходный код для проекта Go или установить средство в рабочую область Go. Добавьте следующий фрагмент кода в azure-pipelines.yml файл:

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

Используйте dep ensure

Используйте dep ensure, если проект использует dep для скачивания зависимостей, импортированных в код. Выполнение dep ensure клонирует импортированные репозитории в директорию вендора вашего проекта. Файлы Gopkg.lock и Gopkg.toml гарантируют, что все, работающие над проектом, используют ту же версию зависимостей, что и сборка. Добавьте следующий фрагмент кода в azure-pipelines.yml файл.

Примечание.

Следующий скрипт выполняется в агентах 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`'

Строить

Используйте go build для создания проекта Go. Добавьте следующий фрагмент кода в azure-pipelines.yml файл:

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

Тест

Используйте go test для тестирования вашего модуля Go и его подкаталогов (./...). Добавьте следующий фрагмент кода в 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, как описано в этой статье, выберите конвейер на странице Конвейеры, а затем выберите Изменить, чтобы открыть редактор для файла YAML azure-pipelines.yml.

Создание образа и отправка в реестр контейнеров

Для приложения Go можно также создать образ и отправить его в реестр контейнеров.

Связанные расширения

Расширение Go для Visual Studio Code