Crie e teste projetos Go

Serviços de DevOps do Azure

Use um pipeline para criar e testar automaticamente seus projetos Go.

Create your first pipeline (Criar o primeiro pipeline)

Novo no Azure Pipelines? Em caso afirmativo, recomendamos que experimente esta secção antes de passar para outras secções.

Fork o seguinte repo no GitHub:

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

Entrar no Azure Pipelines

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

1. Num browser, aceda a dev.azure.com e inicie sessão.
2. Selecione a 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, vá para o Servidor de DevOps do Azure.
2. Selecione a 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 sua organização do Azure DevOps e vá para o seu projeto.

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

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

4. Poderá ser redirecionado para o GitHub para iniciar sessão. Em caso afirmativo, insira suas credenciais do GitHub.

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

6. Você pode ser redirecionado para o GitHub para instalar o aplicativo Azure Pipelines. Em caso afirmativo, selecione Aprovar e instalar.

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

Ambiente de construção

Você pode usar o Azure Pipelines para criar seus projetos Go sem configurar nenhuma infraestrutura própria. Você pode usar agentes Linux, macOS ou Windows para executar suas compilações.

Atualize o seguinte trecho em seu azure-pipelines.yml arquivo 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 obter as versões exatas do Go pré-instalado, consulte Agentes hospedados pela Microsoft no Azure Pipelines.

Configurar o Go

Ir 1.11+

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

Este YAML implementa o go get comando para baixar pacotes Go e suas dependências. Em seguida, ele usa go build para gerar o conteúdo que é publicado com PublishBuildArtifacts@1 tarefa.

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

Ir < 1.11

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

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

Quando uma compilação do Azure Pipelines busca código de um repositório remoto, ela coloca o código no diretório de trabalho padrão da compilação. Para corresponder à estrutura esperada de um espaço de trabalho Go, adicione o seguinte trecho ao seu azure-pipelines.yml arquivo. Este script é executado em bash em agentes Linux e macOS, mas deve ser modificado para 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 modulePath uso da variável para github.com um valor apropriado para o módulo.

Este trecho executa as seguintes ações:

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

Instalar dependências

Use go get

Use go get para baixar o código-fonte de um projeto Go ou para instalar uma ferramenta no espaço de trabalho Go. Adicione o seguinte trecho ao seu azure-pipelines.yml arquivo:

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

Use dep ensure

Use dep ensure se seu projeto usa dep para baixar dependências importadas em seu código. A execução de dep ensure clones importou repositórios para o diretório de fornecedores do projeto. Seus Gopkg.lock arquivos e Gopkg.toml arquivos garantem que todos que trabalham no projeto usem a mesma versão de dependências que sua compilação. Adicione o seguinte trecho ao seu azure-pipelines.yml arquivo.

Nota

O script a seguir é executado em agentes Linux e macOS e pode ser usado para versões mais antigas do Go que exigem uma estrutura de pastas 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`'

Criar

Use go build para construir seu projeto Go. Adicione o seguinte trecho ao seu azure-pipelines.yml arquivo:

- 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 seguinte trecho ao seu azure-pipelines.yml arquivo:

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

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

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

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

Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para você personalizar!

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

Gorjeta

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

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

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

Extensões relacionadas

Extensão Go para Visual Studio Code (Microsoft)