Criar e testar projetos do Go

Azure DevOps Services

Use um pipeline para compilar e testar automaticamente seus projetos do Go.

Crie seu primeiro pipeline

Novo no Azure Pipelines? Nesse caso, recomendamos que você experimente essa seção antes de passar para outras seções.

Bifurque o seguinte repositório no GitHub:

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

Entrar no Azure Pipelines

Entre no Azure Pipelines. Depois de entrar, o navegador vai para https://dev.azure.com/my-organization-name e exibe o painel do Azure DevOps.

1. Em um navegador, acesse dev.azure.com e entre.
2. Selecione sua organização.
3. Crie um novo projeto selecionando Novo projeto ou Criar projeto se estiver criando o primeiro projeto na organização.
4. Insira um Nome de projeto.
5. Selecione a Visibilidade do seu projeto.
6. Selecione Criar.

1. Em um navegador, acesse Azure DevOps Server.
2. Selecione sua coleção.
3. Crie um novo projeto selecionando Novo projeto ou Criar projeto se estiver criando o primeiro projeto da coleção.
4. Insira um Nome de projeto.
5. Selecione a Visibilidade do seu projeto.
6. Selecione Criar.

Criar o pipeline

1. Entre na organização do Azure DevOps e acesse seu projeto.

2. Vá para Pipelines e selecione Novo pipeline ou Criar pipeline se estiver criando seu primeiro pipeline.

3. Percorra as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.

4. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione o repositório.

6. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Se sim, selecione Aprovar e instalar.

Quando a guia Configurar for exibida, selecione Go. O novo pipeline é exibido, com o arquivo YAML azure-pipelines.yml pronto para ser configurado. Confira as seções a seguir para saber algumas das maneiras mais comuns de personalizar seu pipeline.

Ambiente de build

Você pode usar o Azure Pipelines para compilar seus projetos do Go sem configurar nenhuma infraestrutura própria. Você pode usar agentes do Linux, macOS ou Windows para executar seus builds.

Atualize o snippet de código a seguir em seu arquivo azure-pipelines.yml para selecionar a imagem apropriada.

pool:
  vmImage: 'ubuntu-latest'

As versões modernas do Go são pré-instaladas em agentes hospedados pela Microsoft. Para versões exatas do Go pré-instalado, confira Agentes hospedados pela Microsoft no Azure Pipelines.

Configurar o Go

Go 1.11+

A partir do Go 1.11, você não precisa mais definir um ambiente $GOPATH, configurar um layout de workspace ou usar o módulo dep. O gerenciamento de dependências agora está integrado.

Esse YAML implementa o comando go get para baixar pacotes do Go e suas dependências. Em seguida, ele usa go build para gerar o conteúdo publicado com a tarefa 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

Como descreve a documentação do Go, um workspace do Go consiste em um diretório raiz para o qual a variável de ambiente $GOPATH aponta. Dentro desse diretório, estão os seguintes subdiretórios padrão:

• bin para conter comandos executáveis
• pkg para conter pacotes compilados (arquivos .a)
• src para conter arquivos de origem do Go (.go, .c, .g, .s)

Quando um build do Azure Pipelines busca código de um repositório remoto, ele coloca o código no diretório de trabalho padrão do build. Para corresponder à estrutura esperada de um workspace do Go, adicione o snippet a seguir ao arquivo azure-pipelines.yml. Esse script é executado em bash em agentes do Linux e macOS, mas deve ser modificado para o 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'

Se o código não estiver no GitHub, altere o uso da variável modulePath de github.com para um valor apropriado para o seu módulo.

Esse snippet realiza as seguintes ações:

1. Define $GOROOT para a versão do Go que deve ser usada.
2. Define outras variáveis de ambiente do Go conhecidas como seus valores adequados.
3. Cria um workspace do Go em um subdiretório chamado gopath com diretórios filho bin, pkg e src.
4. Move o código que foi buscado do repositório remoto para o diretório src do workspace
5. Adiciona a versão do Go e o diretório bin do workspace ao caminho.

Instalar dependências

Usar go get

Use go get para baixar o código-fonte de um projeto do Go ou para instalar uma ferramenta no workspace do Go. Adicione o snippet de código a seguir ao seu arquivo azure-pipelines.yml:

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

Usar dep ensure

Use dep ensure se o projeto usar dep para baixar dependências importadas em seu código. A execução de dep ensure clona repositórios importados no diretório do fornecedor do projeto. Seus arquivos Gopkg.lock e Gopkg.toml garantem que todos que trabalham no projeto usem a mesma versão de dependências que o build. Adicione o snippet de código a seguir ao seu arquivo azure-pipelines.yml.

Observação

O script a seguir é executado em agentes do Linux e macOS e pode ser usado para versões mais antigas do Go que exigem uma estrutura de pasta específica. O script é escrito para shells Unix e, como resultado, não pode funcionar com agentes do 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

Use go build para compilar seu projeto do Go. Adicione o snippet de código a seguir ao seu arquivo azure-pipelines.yml:

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

Teste

Use go test para testar seu módulo go e seus subdiretórios (./...). Adicione o snippet de código a seguir ao seu arquivo azure-pipelines.yml:

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

Quando estiver pronto, confirme um novo arquivo azure-pipelines.yml no repositório e atualize a mensagem de confirmação. Selecione Salvar e executar.

Se você quiser assistir seu pipeline em ação, selecione o build na opção Trabalhos no painel do Azure Pipelines.

Como seu código parecia ser uma boa correspondência para o modelo do Go, criamos automaticamente seu pipeline.

Agora você tem um pipeline YAML em funcionamento (azure-pipelines.yml) no seu repositório e pronto para você personalizar!

Quando quiser fazer alterações no pipeline, selecione-o na página Pipelines e edite o arquivo azure-pipelines.yml.

Dica

Para fazer alterações no arquivo YAML, conforme descrito neste artigo, selecione o pipeline na página Pipelines e selecione Editar para abrir um editor para o arquivo azure-pipelines.yml.

Compilar uma imagem e enviar por push para o registro de contêiner

Para seu aplicativo Go, você também pode compilar uma imagem e enviá-la por push para um registro de contêiner.

Extensões relacionadas

Extensão do Go para Visual Studio Code (Microsoft)