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 Server로 이동합니다.
2. 컬렉션을 선택합니다.
3. 컬렉션에서 첫 번째 프로젝트를 만드는 경우 새 프로젝트를 선택하거나 프로젝트 만들기를 선택하여 새 프로젝트를 만듭니다.
4. 프로젝트 이름을 입력합니다.
5. 프로젝트의 표시 유형을 선택합니다.
6. 만들기를 선택합니다.

파이프라인 만들기

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. 자식 디렉터binpkgsrc리를 사용하여 명명 gopath 된 하위 디렉터리에 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 .

참고 항목

다음 스크립트는 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 프로젝트를 빌드하는 데 사용합니다 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)