Definir políticas de retenção para compilações, versões e testes

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

As Políticas de retenção permitem-lhe definir quanto tempo deve manter as execuções, as versões e os testes armazenados no sistema. Para economizar espaço de armazenamento, você deseja excluir execuções, testes e versões mais antigos.

As seguintes políticas de retenção estão disponíveis no Azure DevOps nas configurações do seu Project:

1. Pipeline - Defina por quanto tempo manter artefatos, símbolos, anexos, execuções e execuções de solicitação pull.
2. Release (classic) - Defina se deseja salvar compilações e exibir as configurações de retenção padrão e máxima.
3. Teste - Defina por quanto tempo manter execuções, resultados e anexos de teste automatizados e manuais.

Pré-requisitos

Por predefinição, os membros dos grupos Contribuidores, Administradores da Compilação, Administradores de Projeto e Administradores da Versão podem gerir políticas de retenção.

Para gerir as políticas de retenção, tem de ter uma das seguintes subscrições:

• Enterprise
• Profissional de Testes
• MSDN Platforms

Também pode comprar acesso mensal para os Planos de Teste do Azure e atribuir o nível de acesso Básico + Planos de Teste. Veja Testar o acesso por função de utilizador.

Definir políticas de retenção de execução

Na maioria dos casos, você não precisa reter execuções concluídas por mais do que um determinado número de dias. Usando políticas de retenção, você pode controlar quantos dias deseja manter cada execução antes de excluí-la.

Quais partes da execução são excluídas

Quando são execuções excluídas

Definir políticas de retenção de versão

As políticas de retenção de liberação para um pipeline de liberação clássico determinam por quanto tempo uma versão e a execução vinculada a ela são mantidas. Usando essas políticas, você pode controlar quantos dias deseja manter cada versão depois que ela foi modificada ou implantada pela última vez e o número mínimo de versões que devem ser mantidas para cada pipeline.

O temporizador de retenção em uma versão é redefinido sempre que uma versão é modificada ou implantada em um estágio. O número mínimo de libertações a manter tem precedência sobre o número de dias. Por exemplo, se você especificar manter um mínimo de três liberações, as três mais recentes serão mantidas indefinidamente - independentemente do número de dias especificado. No entanto, você pode excluir manualmente essas versões quando não precisar mais delas. Consulte as perguntas frequentes abaixo para obter mais detalhes sobre como funciona a retenção de versão.

Como autor de um pipeline de versão, você pode personalizar políticas de retenção para versões do seu pipeline na guia Retenção .

Política global de retenção de versões

Se você estiver usando um Team Foundation Server local ou Azure DevOps Server, você pode especificar padrões de política de retenção de liberação e máximos para um projeto. Você também pode especificar quando as versões são destruídas permanentemente (removidas da guia Excluído no explorador de compilação).

Se você estiver usando os Serviços de DevOps do Azure, poderá exibir, mas não alterar, essas configurações para seu projeto.

As configurações da política de retenção de versão global podem ser revisadas nas configurações de retenção de versão do seu projeto:

• Serviços de DevOps do Azure: https://dev.azure.com/{organization}/{project}/_settings/release?app=ms.vss-build-web.build-release-hub-group
• No local: https://{your_server}/tfs/{collection_name}/{project}/_admin/_apps/hub/ms.vss-releaseManagement-web.release-project-admin-hub

A política de retenção máxima define o limite superior para quanto tempo as liberações podem ser retidas para todos os pipelines de liberação. Os autores de pipelines de liberação não podem definir configurações para suas definições além dos valores especificados aqui.

A política de retenção padrão define os valores de retenção padrão para todos os pipelines de versão. Os autores de pipelines de compilação podem substituir esses valores.

A política de destruição ajuda você a manter as liberações por um determinado período de tempo depois que elas são excluídas. Essa política não pode ser substituída em pipelines de liberação individuais.

- task: CopyFiles@2
  displayName: 'Copy Files to: \\mypath\storage\$(Build.BuildNumber)'
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)'
    Contents: '_buildOutput/**'
    TargetFolder: '\\mypath\storage\$(Build.BuildNumber)'

FAQ

Se eu marcar uma execução ou uma liberação para ser retida indefinidamente, a política de retenção ainda se aplica?

N.º Nem a política de retenção do pipeline nem os limites máximos definidos pelo administrador são aplicados quando você marca uma execução ou liberação individual para ser retida indefinidamente. Ele permanecerá até que você pare de retê-lo indefinidamente.

Como especifico que as execuções implantadas na produção serão mantidas por mais tempo?

Se você usar versões clássicas para implantar na produção, personalize a política de retenção no pipeline de versão. Especifique o número de dias em que as versões implantadas na produção devem ser mantidas. Além disso, indique que as execuções associadas a essa liberação devem ser mantidas. Isso substituirá a política de retenção de execução.

Se você usar pipelines YAML de vários estágios para implantar na produção, a única política de retenção que você pode configurar está nas configurações do projeto. Não é possível personalizar a retenção com base no ambiente no qual a compilação é implantada.

Não marquei corridas para serem retidas indefinidamente. No entanto, vejo um grande número de corridas sendo mantidas. Como posso evitar isso?

Tal pode dever-se a uma das seguintes razões:

• As execuções são marcadas por alguém do seu projeto para serem retidas indefinidamente.
• As execuções são consumidas por uma versão, e a liberação mantém um bloqueio de retenção nessas execuções. Personalize a política de retenção de versão conforme explicado acima.

Se você acredita que as execuções não são mais necessárias ou se as versões já foram excluídas, então você pode excluir manualmente as execuções.

Como funciona a configuração de "liberações mínimas a manter"?

As libertações mínimas a manter são definidas ao nível das fases. Isso indica que o Azure DevOps sempre manterá o número determinado de últimas versões implantadas para um estágio, mesmo que as versões estejam fora do período de retenção. Uma versão será considerada sob versões mínimas para manter por um estágio somente quando a implantação tiver começado nesse estágio. As implantações bem-sucedidas e fracassadas são consideradas. Liberações pendentes de aprovação não são consideradas.

Como o período de retenção é decidido quando a liberação é implantada em vários estágios com diferentes períodos de retenção?

O período de retenção final é decidido considerando dias para manter as configurações de todos os estágios em que a liberação é implantada e levando no máximo dias para manter entre eles. As liberações mínimas a serem mantidas são regidas no nível do estágio e não mudam com base na liberação implantada em vários estágios ou não. Reter artefatos associados será aplicável quando a liberação for implantada em um estágio para o qual ela esteja definida como true.

Eu apaguei um estágio para o qual eu tenho alguns lançamentos antigos. Que retenção será considerada para este caso?

Como o estágio é excluído, as configurações de retenção no nível do estágio não são aplicáveis agora. O Azure DevOps voltará à retenção padrão no nível do projeto para esse caso.

Minha organização exige que mantenhamos compilações e lançamentos por mais tempo do que o permitido nas configurações. Como posso pedir uma retenção mais longa?

A única maneira de manter uma execução ou uma liberação por mais tempo do que o permitido através das configurações de retenção é marcá-la manualmente para ser retida indefinidamente. Não é possível configurar manualmente uma configuração de retenção mais longa. Entre em contato com o Suporte do Azure DevOps para obter assistência.

Você também pode explorar a possibilidade de usar as APIs REST para baixar informações e artefatos sobre as execuções e carregá-los em seu próprio armazenamento ou repositório de artefatos.

Perdi algumas corridas. Há alguma forma de as recuperar?

Se você acredita que perdeu execuções devido a um bug no serviço, crie um tíquete de suporte imediatamente para recuperar as informações perdidas. Se uma definição de compilação foi excluída manualmente mais de uma semana antes, não será possível recuperá-la. Se as execuções foram excluídas como esperado devido a uma política de retenção, não será possível recuperar as execuções perdidas.

Como faço para usar a Build.Cleanup capacidade dos agentes?

Definir uma Build.Cleanup capacidade nos agentes fará com que os trabalhos de limpeza do pool sejam direcionados apenas para esses agentes, deixando o restante livre para fazer trabalho regular. Quando uma execução de pipeline é excluída, os artefatos armazenados fora do Azure DevOps são limpos por meio de um trabalho executado nos agentes. Quando o pool de agentes fica saturado com trabalhos de limpeza, isso pode causar um problema. A solução para isso é designar um subconjunto de agentes no pool que são os agentes de limpeza. Se algum agente tiver Build.Cleanup definido, somente esses agentes executarão os trabalhos de limpeza, deixando o restante dos agentes livres para continuar executando trabalhos de pipeline. A funcionalidade de Limpeza pode ser ativada navegando até Recursos do Agente> e definindo Build.Cleanup igual a .1

O que acontece com artefatos de compartilhamento de arquivos quando a compilação é excluída

Quando uma compilação com artefatos de compartilhamento de arquivos é excluída, uma nova tarefa de compilação é enfileirada em um agente de compilação para limpar esses arquivos. Um agente é escolhido para executar essa tarefa com base nos seguintes critérios: Existe um agente com Build.Cleanup capacidade disponível? O agente que executou a compilação está disponível? Existe um agente do mesmo pool disponível? Está disponível um agente de um grupo semelhante? Existe algum agente disponível?

Os resultados de testes automatizados publicados como parte de uma versão são retidos até que a versão seja excluída?

Os resultados de teste publicados em um estágio de uma versão são retidos conforme especificado pela política de retenção configurada para os resultados do teste. Os resultados do teste não são retidos até que a liberação seja mantida. Se você precisar dos resultados do teste desde a liberação, defina as configurações de retenção para execuções de teste automatizado nas configurações do projeto de acordo com Nunca excluir. Isso garante que os resultados do teste sejam excluídos somente quando a versão for excluída.

Os resultados dos testes manuais são eliminados?

N.º Os resultados dos testes manuais não são excluídos.

Artigos relacionados

• Controlar por quanto tempo manter os resultados do teste
• Excluir artefatos de teste
• Usando tarefas para reter execuções no Azure Pipelines