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

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

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

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

1. Pipeline – Defina por quanto tempo os artefatos, símbolos, anexos, execuções e execuções de solicitação de pull devem ser mantidos.
2. Versão (clássica) – Defina se deseja salvar builds e exibir as configurações de retenção padrão e máxima.
3. Teste – Defina por quanto tempo as execuções de teste, resultados e anexos automatizados e manuais devem ser mantidos.

Pré-requisitos

Por padrão, os membros dos grupos Colaboradores, Administradores de Compilações, Administradores de Projeto e Administradores de Versão podem gerenciar as políticas de retenção.

Para gerenciar as políticas de retenção, você precisa ter uma das seguintes assinaturas:

• Empresa
• Test Professional
• Plataformas MSDN

Você também pode comprar o acesso mensal do Azure Test Plans e atribuir o nível de acesso Planos de Teste + Básicos. Confira Testando o acesso por função de usuário.

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

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

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

Quando as execuções são excluídas

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

As políticas de retenção de versão para um pipeline de lançamento clássico determinam por quanto tempo uma versão e a execução vinculada a ela devem ser retidas. Usando essas políticas, você pode controlar por quantos dias deseja manter cada versão após a última modificação ou implantação e o número mínimo de versões que devem ser retidas 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. A configuração do número mínimo de versões a serem retidas tem precedência sobre o número de dias. Por exemplo, se você especificar para reter um mínimo de três versões, as três mais recentes serão retidas 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 lançamento, você pode personalizar políticas de retenção para versões do pipeline na guia Retenção.

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

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

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

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

• Azure DevOps Services: https://dev.azure.com/{organization}/{project}/_settings/release?app=ms.vss-build-web.build-release-hub-group
• 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 de quanto tempo as versões podem ser retidas para todos os pipelines de lançamento. Os autores de pipelines de lançamento 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 lançamento. Os autores de pipelines de build podem substituir esses valores.

A política de destruição ajuda você a manter as versõ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 lançamento individuais.

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

Perguntas frequentes

Se eu marcar uma execução ou uma versão a ser retida indefinidamente, a política de retenção ainda se aplicará?

Não. 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 individual ou uma versão a ser retida indefinidamente. Ela permanecerá até que você pare de retê-la indefinidamente.

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

Se você usar versões clássicas para implantar em produção, personalize a política de retenção no pipeline de lançamento. Especifique o número de dias em que as versões implantadas na produção devem ser retidas. Além disso, indique que as execuções associadas a essa versão devem ser retidas. 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 definir estará nas configurações do projeto. Não é possível personalizar a retenção com base no ambiente no qual o build é implantado.

Eu não marquei execuções para serem retidas indefinidamente. No entanto, vejo um grande número de execuções sendo retidas. Como posso evitar isso?

Isso pode ocorrer por um dos seguintes motivos:

• As execuções são marcadas por alguém em seu projeto para serem retidas indefinidamente.
• As execuções são consumidas por uma versão e a versã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, você pode excluir manualmente as execuções.

Como funciona a configuração de "versões mínimas a serem mantidas"?

As versões mínimas a serem mantidas são definidas no nível do estágio. Ele indica que o Azure DevOps sempre manterá o número determinado de versões implantadas pela última fase, mesmo que as versões estejam fora do período de retenção. Uma versão será considerada em versões mínimas a serem mantidas para um estágio somente quando a implantação for iniciada nesse estágio. As implantações bem-sucedidas e com falha são consideradas. Versões pendentes de aprovação não são consideradas.

Como o período de retenção é decidido quando a versão é implantada em vários estágios com um período de retenção diferente?

O período de retenção final é decidido considerando dias para manter as configurações de todos os estágios em que a versão é implantada e o máximo de dias para manter entre elas. O mínimo de versões a serem mantidas é regido no nível do estágio e não é alterado com base na versão implantada em vários estágios ou não. A retenção de artefatos associados será aplicável quando a versão for implantada em um estágio para o qual ele é definido como true.

Exclui um estágio para o qual tenho algumas versões antigas. Qual retenção será considerada nesse caso?

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

Minha organização exige que mantenhamos builds e versões por mais tempo do que o permitido nas configurações. Como posso solicitar uma retenção mais longa?

A única maneira de reter uma execução ou uma versão mais longa do que o permitido por meio de configurações de retenção é marcá-la manualmente para ser retida indefinidamente. Não é possível definir uma configuração de retenção mais longa manualmente. Entre em contato com o Suporte do Azure DevOps para obter ajuda.

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

Perdi algumas execuções. Há uma maneira de recuperá-los?

Se você acredita que perdeu as 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 build tiver sido excluída manualmente mais de uma semana antes, não será possível recuperá-la. Se as execuções foram excluídas conforme o esperado devido a uma política de retenção, não será possível recuperar as execuções perdidas.

Como usar a funcionalidade Build.Cleanup dos agentes?

A definição de uma funcionalidade Build.Cleanup em agentes fará com que os trabalhos de limpeza do pool sejam direcionados apenas para esses agentes, deixando o restante livre para trabalhos regulares. 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 Limpeza pode ser habilitada acessando Agente>Funcionalidades e definindo Build.Cleanup igual a 1.

O que acontece com o compartilhamento de arquivos do Artifacts quando o build é excluído

Quando um build com compartilhamento de arquivos do Artifacts é excluído, uma nova tarefa de build é colocada na fila em um agente de build para limpeza desses arquivos. Um agente é escolhido para executar essa tarefa com base nos seguintes critérios: Há um agente com funcionalidade Build.Cleanup disponível? O agente que executou o build está disponível? Um agente do mesmo pool está disponível? Um agente de um pool semelhante está disponível? Algum agente está disponível?

Os resultados do teste automatizado que são publicados como parte de uma versão são mantidos até que a versão seja excluída?

Os resultados do 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 versão seja mantida. Se você precisar dos resultados do teste desde a versão, defina as configurações de retenção para execuções de teste automatizado nas configurações do Projeto como Nunca excluir. Isso garante que os resultados do teste sejam excluídos somente quando a versão for excluída.

Os resultados do teste manual são excluídos?

Não. Os resultados do teste manual não são excluídos.

Artigos relacionados

• Controlar por quanto tempo os resultados do teste devem ser mantidos
• Excluir artefatos de teste