Opções de pipeline para repositórios Git

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Ao editar um pipeline que usa um repositório Git — em um projeto de DevOps do Azure, GitHub, GitHub Enterprise Server, Bitbucket Cloud ou outro repositório Git — você tem as seguintes opções.

Filial

Esta é a ramificação que você deseja que seja o padrão quando você enfileirar manualmente esta compilação. Se você definir um gatilho agendado para a compilação, esta é a ramificação da qual sua compilação obterá as fontes mais recentes. A ramificação padrão não tem influência quando a compilação é acionada por meio de integração contínua (CI). Normalmente, você definirá isso como o mesmo que a ramificação padrão do repositório (por exemplo, "master").

Limpe o repositório local no agente

Você pode executar diferentes formas de limpeza do diretório de trabalho do seu agente auto-hospedado antes que uma compilação seja executada.

Em geral, para um desempenho mais rápido de seus agentes auto-hospedados, não limpe o repositório. Neste caso, para obter o melhor desempenho, certifique-se de que também está a criar de forma incremental, desativando qualquer opção Limpar da tarefa ou ferramenta que está a utilizar para compilar.

Se você precisar limpar o repositório (por exemplo, para evitar problemas causados por arquivos residuais de uma compilação anterior), suas opções estão abaixo.

parameters:
- name: clean
  displayName: Checkout clean
  type: boolean
  default: true
  values:
  - false
  - true

trigger:
- main

pool: FabrikamPool
#  vmImage: 'ubuntu-latest'

steps:
- checkout: self
  clean: ${{ parameters.clean }}

Fontes de etiquetas

Você pode querer rotular seus arquivos de código-fonte para permitir que sua equipe identifique facilmente qual versão de cada arquivo está incluída na compilação concluída. Você também tem a opção de especificar se o código-fonte deve ser rotulado para todas as compilações ou apenas para compilações bem-sucedidas.

No formato Label, você pode usar variáveis definidas pelo usuário e predefinidas que têm um escopo de "Todos". Por exemplo:

$(Build.DefinitionName)_$(Build.DefinitionVersion)_$(Build.BuildId)_$(Build.BuildNumber)_$(My.Variable)

As quatro primeiras variáveis são predefinidas. My.Variablepode ser definido por si no separador variáveis.

O pipeline de construção rotula seus códigos-fonte com uma tag Git.

Algumas variáveis de compilação podem produzir um valor que não é um rótulo válido. Por exemplo, variáveis como $(Build.RequestedFor) e $(Build.DefinitionName) podem conter espaço em branco. Se o valor contiver espaço em branco, a tag não será criada.

Depois que os códigos-fonte são marcados pelo pipeline de compilação, um artefato com a ref refs/tags/{tag} do Git é adicionado automaticamente à compilação concluída. Isso dá à sua equipe rastreabilidade adicional e uma maneira mais amigável de navegar da compilação para o código que foi criado. A tag é considerada um artefato de construção, uma vez que é produzida pela compilação. Quando a compilação é excluída manualmente ou por meio de uma política de retenção, a tag também é excluída.

Status da compilação do relatório (Azure Pipelines, TFS 2018 e mais recente)

Você tem a opção de dar à sua equipe uma visão do status da compilação a partir do repositório de origem remoto.

Se suas fontes estiverem em um repositório Git do Azure Repos em seu projeto, essa opção exibirá um selo na página Código para indicar se a compilação está passando ou falhando. O status da compilação é exibido nas seguintes guias:

• Arquivos: indica o status da compilação mais recente para a ramificação selecionada.
• Commits: indica o status de compilação de cada commit (isso requer que o gatilho de integração contínua (CI) seja habilitado para suas compilações).
• Ramos: Indica o status da compilação mais recente para cada ramificação.

Se você usar vários pipelines de compilação para o mesmo repositório em seu projeto, poderá optar por habilitar essa opção para um ou mais dos pipelines. No caso em que essa opção está habilitada em vários pipelines, o selo na página Código indica o status da compilação mais recente em todos os pipelines. Os membros da sua equipe podem clicar no selo de status da compilação para exibir o status da compilação mais recente para cada um dos pipelines de compilação.

Outros tipos de repositórios remotos Git

Se sua origem estiver em qualquer outro tipo de repositório remoto, você não poderá usar o Azure Pipelines ou o TFS para publicar automaticamente o status da compilação nesse repositório. No entanto, você pode usar um selo de compilação como uma maneira de integrar e mostrar o status da compilação em suas experiências de controle de versão.

Dar saída dos submódulos

Selecione se deseja baixar arquivos de submódulos. Você pode optar por obter os submódulos imediatos ou todos os submódulos aninhados em qualquer profundidade de recursão. Se você quiser usar o LFS com submódulos, certifique-se de ver a nota sobre o uso do LFS com submódulos.

O pipeline de construção verificará seus submódulos do Git desde que sejam:

• Não autenticado: um repositório público não autenticado sem credenciais necessárias para clonar ou buscar.

• Autenticado:

  • Contido no mesmo projeto, organização do GitHub ou conta do Bitbucket Cloud como o repositório Git especificado acima.

  • Adicionado usando uma URL relativa ao repositório principal. Por exemplo, este seria verificado: git submodule add /../../submodule.git mymodule Este não seria verificado: git submodule add https://dev.azure.com/fabrikamfiber/_git/ConsoleApp mymodule

Submódulos autenticados

As mesmas credenciais que são usadas pelo agente para obter os códigos-fonte do repositório principal também são usadas para obter os códigos-fonte para submódulos.

Se o repositório principal e os submódulos estiverem em um repositório Git do Azure Repos em seu projeto do Azure DevOps, você poderá selecionar a conta usada para acessar as fontes. Na guia Opções, no menu Escopo de autorização de trabalho de compilação, selecione:

• Coleção de projetos para usar a conta de serviço Project Collection Build

• Projeto atual para usar a conta do Project Build Service.

Certifique-se de que qualquer conta que você use tenha acesso tanto ao repositório principal quanto aos submódulos.

Se o repositório principal e os submódulos estiverem na mesma organização do GitHub, o token armazenado na conexão de serviço do GitHub será usado para acessar as fontes.

Alternativa ao uso da opção de submódulos Checkout

Em alguns casos, não é possível usar a opção Checkout submódulos . Você pode ter um cenário em que um conjunto diferente de credenciais é necessário para acessar os submódulos. Isso pode acontecer, por exemplo, se o repositório principal e os repositórios do submódulo não estiverem armazenados na mesma organização do Azure DevOps ou no mesmo serviço Git.

Se você não puder usar a opção Checkout submódulos , poderá usar uma etapa de script personalizada para buscar submódulos. Primeiro, obtenha um token de acesso pessoal (PAT) e prefixe-o com pat:. Em seguida, base64-encode essa cadeia de caracteres prefixada para criar um token de autenticação básico. Finalmente, adicione este script ao seu pipeline:

git -c http.https://<url of submodule repository>.extraheader="AUTHORIZATION: basic <BASE64_ENCODED_TOKEN_DESCRIBED_ABOVE>" submodule update --init --recursive

Certifique-se de substituir "<BASIC_AUTH_TOKEN>" pelo seu token codificado em Base64.

Use uma variável secreta em seu projeto ou pipeline de construção para armazenar o token de autenticação básico que você gerou. Use essa variável para preencher o segredo no comando Git acima.

Confira arquivos do LFS

Selecione se deseja baixar arquivos do LFS (armazenamento de arquivos grandes).

No editor clássico, marque a caixa de seleção para habilitar essa opção.

Em uma compilação YAML, adicione uma etapa de checkout com lfs definido como true:

steps:
- checkout: self
  lfs: true

Se você estiver usando o TFS ou se estiver usando o Azure Pipelines com um agente auto-hospedado, deverá instalar git-lfs no agente para que essa opção funcione. Se seus agentes hospedados usam o Windows, considere usar a System.PreferGitFromPath variável para garantir que os pipelines usem as versões do git e do git-lfs instaladas na máquina. Para obter mais informações, consulte Qual versão do Git meu agente executa?

Usando o Git LFS com submódulos

Se um submódulo contiver arquivos LFS, o Git LFS deverá ser configurado antes do check-out dos submódulos. Os agentes macOS e Linux hospedados pela Microsoft vêm pré-configurados dessa forma. Agentes Windows e agentes macOS / Linux auto-hospedados não podem.

steps:
- script: |
    git config --global --add filter.lfs.required true
    git config --global --add filter.lfs.smudge "git-lfs smudge -- %%f"
    git config --global --add filter.lfs.process "git-lfs filter-process"
    git config --global --add filter.lfs.clean "git-lfs clean -- %%f"
  displayName: Configure LFS for use with submodules
- checkout: self
  lfs: true
  submodules: true
# ... rest of steps ...

Clone um segundo repo

Por padrão, seu pipeline está associado a um repositório do Azure Repos ou a um provedor externo. Este é o repositório que pode acionar compilações em confirmações e solicitações pull.

Você pode incluir fontes de um segundo repositório em seu pipeline. Você pode fazer isso escrevendo um script.

git clone https://github.com/Microsoft/TypeScript.git

Se o repositório não for público, você precisará passar a autenticação para o comando Git.

Repositórios do Azure

- script: | 
    git clone -c http.extraheader="AUTHORIZATION: bearer $(System.AccessToken)" https://organization@dev.azure.com/project/FabrikamFiber/_git/reponame

Se você precisar clonar um repositório de outro projeto que não seja público, será necessário autenticar como um usuário que tem acesso a esse projeto.

Para os repositórios do Azure, você pode usar um token de acesso pessoal com a permissão Código (Leitura). Envie como o campo de senha em um cabeçalho de autorização "Básico" sem um nome de usuário. (Em outras palavras, base64-codificar o valor de :<PAT>, incluindo os dois pontos.)

AUTH=$(echo -n ":$REPO_PAT" | openssl base64 | tr -d '\n')
git -c http.<repo URL>.extraheader="AUTHORIZATION: basic $AUTH" clone <repo URL> --no-checkout --branch master

Não sincronizar fontes

Os trabalhos que não são de implantação buscam fontes automaticamente. Use essa opção se quiser ignorar esse comportamento. Esta opção pode ser útil nos casos em que pretende:

• Git init, config e fetch usando suas próprias opções personalizadas.

• Use um pipeline de compilação para executar apenas a automação (por exemplo, alguns scripts) que não depende do código no controle de versão.

Se você quiser desativar o download de fontes:

• Azure Pipelines, TFS 2018 e mais recente: clique em Configurações avançadas e selecione Não sincronizar fontes.

Busca rasa

Selecione se você deseja limitar a distância no histórico para download. Efetivamente, isso resulta em git fetch --depth=n. Se o repositório for grande, essa opção pode tornar o pipeline de compilação mais eficiente. Seu repositório pode ser grande se estiver em uso por um longo tempo e tiver um histórico considerável. Também pode ser grande se você adicionou e depois excluiu arquivos grandes.

Nesses casos, essa opção pode ajudá-lo a conservar recursos de rede e armazenamento. Também pode poupar tempo. A razão pela qual nem sempre economiza tempo é porque, em algumas situações, o servidor pode precisar gastar tempo calculando as confirmações a serem baixadas para a profundidade que você especificar.

Depois de marcar a caixa de seleção para habilitar essa opção, na caixa Profundidade, especifique o número de confirmações.

Prefira o Git do caminho

Por padrão, o agente do Windows usa a versão do Git que acompanha o software do agente. A Microsoft recomenda usar a versão do Git que acompanha o agente, mas você tem várias opções para substituir esse comportamento padrão e usar a versão do Git que a máquina do agente instalou no caminho.

• Defina uma variável de pipeline nomeada System.PreferGitFromPath como true em seus pipelines.
• Em agentes auto-hospedados, você pode criar um arquivo chamado .env no diretório raiz do agente e adicionar uma System.PreferGitFromPath=true linha ao arquivo. Para obter mais informações, consulte Como definir variáveis de ambiente diferentes para cada agente individual?

Para ver a versão do Git usada por um pipeline, você pode examinar os logs para uma checkout etapa no seu pipeline, conforme mostrado no exemplo a seguir.

Syncing repository: PathFilter (Git)
Prepending Path environment variable with directory containing 'git.exe'.
git version
git version 2.26.2.windows.1

Essa configuração é sempre verdadeira em agentes que não são do Windows.

Opções de gatilho para outro Git

Quando um repositório Git Outro/externo é especificado, as compilações de CI exigem que o repositório esteja acessível a partir da Internet. Se o repositório estiver atrás de um firewall ou proxy, apenas compilações agendadas e manuais funcionarão.

FAQ

Quais protocolos o agente de compilação pode usar com o Git?

O agente suporta HTTPS.

O agente ainda não suporta SSH. Consulte Permitir que a compilação use a autenticação SSH ao fazer check-out dos submódulos do Git.