Kvarhållningsprinciper

Konfigurera kvarhållningsprinciper

Om du vill öppna sidorna för kvarhållningsinställningar i projektet och välja det principområde som du vill hantera följer du dessa steg:

1. Logga in på ditt Azure DevOps projekt.

2. Välj >Projektinställningar.

3. Välj något av följande alternativ:

   • Under Pipelines väljer du Inställningar för att konfigurera kvarhållning av körningar, artefakter, symboler, bifogade filer och pull request-körningar.
   • Under Pipelines väljer du Versionskvarhållning för att konfigurera inställningar för kvarhållning av versioner, inklusive när versioner tas bort eller förstörs permanent.
   • Under Test väljer du Kvarhållning för att konfigurera hur länge manuella och automatiserade testkörningar ska sparas.

1. Gå till fliken >inställningar i projektets inställningar.

2. I avsnittet Pipelines väljer du Inställningar:

   • Ange hur många dagar artefakter, symboler och bifogade filer ska behållas.
   • Ange hur många dagar körningarna ska behållas.
   • Ange hur många dagar pull-begäranden ska köras.
   • Ange antalet senaste körningar som ska behållas för varje pipeline.

Antalet senaste körningar som ska behållas för varje pipelineinställning tolkas på olika sätt baserat på lagringsplatstyp:

• Azure-lagringsplatser: Azure-pipelines behåller det konfigurerade antalet senaste körningar för pipelines standardgren och för varje skyddad gren på lagringsplatsen. En skyddad branch är alla brancher med grenpolicyer konfigurerade.

  Överväg till exempel en lagringsplats med två grenar: main och release. Om pipelinens standardgren är main och release har en förgreningsprincip behandlas den release som en skyddad gren. Om du konfigurerar kvarhållning för att behålla tre körningar behåller Azure-pipelines de senaste tre körningarna för main, de senaste tre körningarna för release och de senaste tre körningarna för pipelinan totalt (oavsett filial).

  I följande exempel förutsätts att den senaste körningen visas först. Den visar vilka körningar som behålls när du konfigurerar kvarhållning för att behålla de senaste tre körningarna (ignorera den dagsbaserade inställningen).

  Springa #	Filial	Behålls/behålls inte	Varför?
  Kör 10	main	Behållen	Senaste 3 för main och senaste 3 för pipeline
  Kör 9	filial1	Behållen	De senaste 3 i pipelinen
  Kör 8	gren2	Behållen	De senaste 3 i pipelinen
  Kör 7	main	Behållen	Senaste 3 för huvudmenyn
  Kör 6	main	Behållen	Senaste 3 för huvudmenyn
  Kör 5	main	Behålls inte	För main eller pipeline är det inte bland de senaste tre.
  Kör 4	main	Behålls inte	För main eller pipeline är det inte bland de senaste tre.
  Kör 3	filial1	Behålls inte	För main eller pipeline är det inte bland de senaste tre.
  Kör 2	släppa	Behållen	Senaste 3 för lansering
  Kör 1	main	Behålls inte	För main eller pipeline är det inte bland de senaste tre.

  Antalet dagar som ska behållas beräknas från det datum körningen är avslutad. Till exempel finns det två körningar på huvudgrenen den 19 januari. Körningen som slutfördes senare bevaras.

• Alla andra Git-lagringsplatser: Azure-pipelines behåller det konfigurerade antalet senaste körningar för hela pipelinen.

• Team Foundation Version Control (TFVC): Azure-pipelines behåller det konfigurerade antalet senaste körningar för hela pipelinen, oavsett gren.

När en körning raderas tas följande data bort:

• Loggar
• Alla pipeline-artifakter och byggartefakter
• Alla symboler
• Binärer
• Testresultat
• Köra metadataprocessen
• Källetiketter (TFVC) eller taggar (Git)

Kvarhållning av pipelinekörning styr inte universella paket, NuGet, npm och andra paket.

En körning tas bort om alla följande villkor är uppfyllda:

• Det överskrider antalet dagar som konfigurerats i kvarhållningsinställningarna.
• Det är inte en av de senaste körningarna som konfigurerats i kvarhållningsinställningarna.
• Den är inte markerad för obegränsad lagringstid.
• Den sparas inte av en utgåva.

Kvarhållningsprinciper bearbetas en gång per dag. Bearbetningstiden varierar eftersom arbetet distribueras hela dagen för belastningsutjämning. Du kan inte ändra det här schemat.

Ange automatiskt kvarhållningslån för pipelinekörningar

Med kvarhållningslån kan du utöka eller kontrollera livslängden för pipelinekörningar utöver konfigurerade kvarhållningsperioder. Du kan lägga till eller ta bort leases för en pipelinekörning med hjälp av Lease API. Du kan anropa det här API:et från en pipeline med hjälp av ett skript och fördefinierade variabler för runId och definitionId.

Du kan ange ett hyresavtal för en viss varaktighet. Du kan till exempel behålla en körning som distribueras till en testmiljö under en kortare period. Du kan behålla en körning som distribueras till produktion under en längre tid.

Ange kvarhållningspolicy manuellt för pipelinekörningar

Du kan behålla en pipelinekörning manuellt från menyn Fler åtgärder på sidan Information om pipelinekörning .

Ta bort en körning

Du kan ta bort körningar från menyn Fler åtgärder på sidan Pipelinekörningsdetaljer.

YAML- och byggpipelines använder samma behållningspolicy för utförande. Du kan visa de här inställningarna under Project inställningar>Pipelines>Inställningar.

Global retentionspolicy för utgåvor

I Azure DevOps Services kan du visa de här inställningarna, men du kan inte ändra dem på projektnivå.

Du kan granska de globala inställningarna för versionsbevarande från sidan Release-kvarhållning i inställningarna för Projekt:

• Maximal kvarhållningsprincip: Definierar den övre gränsen för hur länge du kan behålla versioner i alla versionspipelines. Pipelineförfattare kan inte konfigurera kvarhållning utöver den här gränsen.
• Standardregel för kvarhållning: Definierar standardkvarhållningsvärden som tillämpas på utgivningspipelines. Pipelineutvecklare kan åsidosätta dessa förinställda värden.
• Förstör versioner permanent: Styr hur länge borttagna versioner sparas innan de tas bort permanent. En utgivningspipeline kan inte åsidosätta den här principen.

Global retentionspolicy för utgåvor

Om du använder Azure DevOps Server lokalt kan du konfigurera standardvärden och maxvärden på projektnivå för kvarhållning av versioner. Du kan också ange när borttagna versioner förstörs permanent. (De tas bort från fliken Borttaget i Build Explorer.)

• Maximal kvarhållningsprincip: Definierar den övre gränsen för hur länge du kan behålla versioner i alla versionspipelines. Pipelineförfattare kan inte konfigurera kvarhållning utöver den här gränsen.
• Standardregel för kvarhållning: Definierar standardkvarhållningsvärden som tillämpas på utgivningspipelines. Pipelineutvecklare kan åsidosätta dessa förinställda värden.
• Förstör versioner permanent: Styr hur länge borttagna versioner sparas innan de tas bort permanent. En utgivningspipeline kan inte åsidosätta den här principen.

Ange kvarhållningsprinciper på samlingsnivå

Om du använder en lokal server kan du även konfigurera kvarhållning på samlingsnivå med anpassade regler. De här inställningarna gäller för klassiska byggprocesser och definierar standard- och högsta bevarandevärden för samlingen.

Använd aktiviteten Kopiera filer för att spara data längre

Om du behöver behålla byggutdata längre än den konfigurerade kvarhållningsperioden kopierar du dem till din egen lagringsplats med hjälp av aktiviteten Kopiera filer.

Använd Kopiera filer i stället för Publicera byggartefakter eftersom data som publiceras som byggartefakter fortfarande är föremål för kvarhållningsrensning.

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

Hur gör jag för att bevara mina etiketter eller taggar för versionskontroll?

Om etiketter eller taggar måste bevaras efter att en version har tagits bort kan du använda dem i en pipelineaktivitet, lägga till dem manuellt utanför pipelinen eller behålla bygget på obestämd tid.

Vad händer med pipelines som används i andra pipelines?

Klassiska versioner behåller pipelines som de förbrukar automatiskt.

Vad händer med pipelines som används i andra pipelines?

Klassiska versioner behåller pipelines som de förbrukar automatiskt. Om du använder YAML kan du också skapa en YAML-pipeline med flera versioner för att representera din version och använda en annan YAML-pipeline i den som en resurs. Resurspipelinen behålls automatiskt så länge versionspipelinen behålls.