Aufbewahrungsrichtlinien

Konfigurieren von Aufbewahrungsrichtlinien

Führen Sie die folgenden Schritte aus, um die Seiten mit den Aufbewahrungseinstellungen in Ihrem Projekt zu öffnen und den Richtlinienbereich auszuwählen, den Sie verwalten möchten:

1. Melden Sie sich bei Ihrem Azure DevOps Projekt an.

2. Wählen Sie >Projekteinstellungen aus.

3. Wählen Sie eine der folgenden Optionen aus:

   • Unter "Pipelines" wählen Sie "Einstellungen" aus, um die Aufbewahrung für Ausführungen, Artefakte, Symbole, Anhänge und Pull-Request-Läufe zu konfigurieren.
   • Wählen Sie unter "Pipelines" die Option "Freigabeaufbewahrung" aus, um Freigabeaufbewahrungseinstellungen zu konfigurieren, einschließlich, wenn Versionen gelöscht oder dauerhaft zerstört werden.
   • Wählen Sie unter "Testen" die Option "Aufbewahrung" aus, um zu konfigurieren, wie lange manuelle und automatisierte Testläufe aufbewahrt werden.

1. Wechseln Sie in den Einstellungen Ihres Projekts zur Registerkarte >Einstellungen.

2. Wählen Sie im Abschnitt "Pipelines" die Option "Einstellungen" aus:

   • Legen Sie fest, wie viele Tage Artefakte, Symbole und Anlagen beibehalten werden sollen.
   • Legen Sie fest, wie viele Tage Ausführungen aufbewahrt werden sollen.
   • Stellen Sie ein, wie viele Tage die Pull-Request-Ausführungen gespeichert werden sollen.
   • Legen Sie die Anzahl der letzten Durchläufe fest, die für jede Pipeline beibehalten werden sollen.

Die Anzahl der letzten Ausführungen, die für jede Pipeline-Einstellung beibehalten werden sollen, wird je nach Repository-Typ unterschiedlich interpretiert:

• Azure Repos: Azure Pipelines behält die konfigurierte Anzahl der neuesten Ausführungen für den Standardbranch der Pipeline und für jeden geschützten Branch im Repository bei. Eine geschützte Verzweigung ist eine beliebige Verzweigung mit konfigurierten Verzweigungsrichtlinien.

  Ziehen Sie z. B. ein Repository mit zwei Verzweigungen in Betracht: main und release. Wenn die Pipeline-Standardverzweigung main ist und release eine Verzweigungsrichtlinie hat, dann wird release als geschützte Verzweigung behandelt. Wenn Sie die Aufbewahrung so konfigurieren, dass drei Ausführungen beibehalten werden, behält Azure Pipelines die neuesten drei Ausführungen für main, die neuesten drei Ausführungen für release und die neuesten drei Ausführungen für die Pipeline insgesamt (unabhängig vom Branch).

  Im folgenden Beispiel wird davon ausgegangen, dass die letzte Ausführung zuerst aufgeführt wird. Es wird angezeigt, welche Läufe beibehalten werden, wenn die Aufbewahrung so konfiguriert ist, dass die letzten drei Läufe erhalten bleiben (die Einstellung auf Tage wird dabei ignoriert).

  Nr. der Ausführung	Branch	Beibehalten/Nicht beibehalten	Warum?
  Lauf 10	Standard	Beibehalten	Die neuesten 3 für den Hauptzweig und die neuesten 3 für die Pipeline.
  Lauf 9	Branch1	Beibehalten	Die letzten 3 für Pipeline
  Ausführung 8	Branch2	Beibehalten	Die letzten 3 für Pipeline
  Lauf 7	Standard	Beibehalten	Die letzten 3 für „main“
  Ausführung 6	Standard	Beibehalten	Die letzten 3 für „main“
  Lauf 5	Standard	Nicht beibehalten	Nicht die neuesten 3 für Haupt- oder Pipeline
  Lauf 4	Standard	Nicht beibehalten	Nicht die neuesten 3 für Haupt- oder Pipeline
  Ausführung 3	Branch1	Nicht beibehalten	Nicht die neuesten 3 für Haupt- oder Pipeline
  Testlauf 2	Freigabe	Beibehalten	Die letzten 3 für Release
  Lauf 1	Standard	Nicht beibehalten	Nicht die neuesten 3 für Haupt- oder Pipeline

  Die Anzahl der Tage, die gespeichert werden sollen, wird ab dem Datum berechnet, an dem die Ausführung abgeschlossen ist. Zum Beispiel gibt es zwei Läufe auf einer Hauptzweigung am 19. Januar. Die später abgeschlossene Ausführung wird beibehalten.

• Alle anderen Git-Repositorys: Azure Pipelines behält die konfigurierte Anzahl der neuesten Ausführungen für die gesamte Pipeline bei.

• Team Foundation Version Control (TFVC): Azure Pipelines behält die konfigurierte Anzahl der neuesten Ausführungen für die gesamte Pipeline unabhängig von der Verzweigung bei.

Wenn eine Ausführung gelöscht wird, werden die folgenden Daten entfernt:

• Logdateien
• Alle Pipeline- und Buildartefakte
• Alle Symbole
• Binärdateien
• Testergebnisse
• Ausführungsmetadaten
• Quellbezeichnungen (TFVC) oder Tags (Git)

Die Beibehaltung von Pipeline-Ausführungen betrifft nicht Universal Packages, NuGet, npm und andere Pakete.

Eine Ausführung wird gelöscht, wenn alle folgenden Bedingungen erfüllt sind:

• Er überschreitet die Anzahl von Tagen, die in den Aufbewahrungseinstellungen konfiguriert wurden.
• Es handelt sich entsprechend den konfigurierten Aufbewahrungseinstellungen nicht um eine der letzten Ausführungen
• Sie ist nicht für unbefristete Aufbewahrung markiert.
• Wird nicht von einem Release aufbewahrt.

Aufbewahrungsrichtlinien werden einmal pro Tag verarbeitet. Die Verarbeitungszeit variiert, da die Arbeit täglich für den Lastenausgleich verteilt wird. Sie können diesen Zeitplan nicht ändern.

Automatisches Festlegen von Aufbewahrungsleases für Pipelineausführungen

Aufbewahrungsleasen ermöglichen es Ihnen, die Lebensdauer der Pipeline über konfigurierte Aufbewahrungszeiträume hinaus zu verlängern oder zu steuern. Sie können Leases für eine Pipeline hinzufügen oder löschen, die mit der Lease-API ausgeführt wird. Sie können diese API aus einer Pipeline mit einem Skript und vordefinierten Variablen für runId und definitionId aufrufen.

Sie können eine Lease für eine bestimmte Dauer festlegen. Sie können beispielsweise eine Ausführung beibehalten, die für einen kürzeren Zeitraum in einer Testumgebung bereitgestellt wird. Sie können eine Ausführung beibehalten, die für eine längere Zeit in der Produktion bereitgestellt wird.

Manuelles Festlegen von Aufbewahrungsleases für Pipelineausführungen

Sie können eine Pipelineausführung manuell über das Menü "Weitere Aktionen " auf der Seite " Pipelineausführungsdetails " beibehalten.

Löschen einer Ausführung

Sie können Ausführungen über das Menü „Weitere Aktionen“ auf der Seite „Pipeline-Ausführungsdetails“ löschen.

YAML- und Buildpipelines verwenden dieselbe Ausführungs-Aufbewahrungsrichtlinie. Sie können diese Einstellungen unter Project einstellungen>Pipelines>Settings anzeigen.

Globale Archivierungsrichtlinie für Releases

In Azure DevOps Services können Sie diese Einstellungen anzeigen, sie können jedoch nicht auf Projektebene ändern.

Die globalen Einstellungen zur Releaseaufbewahrung können Sie auf der Seite Release-Aufbewahrung Ihres Projekts in Ihren Projekteinstellungen einsehen:

• Maximale Aufbewahrungsrichtlinie: Definiert die obere Grenze für die Dauer der Aufbewahrung von Versionen über alle Releasepipelines hinweg. Pipelineautoren können die Aufbewahrung nicht über diesen Grenzwert hinaus konfigurieren.
• Standardaufbewahrungsrichtlinie: Definiert die Standardaufbewahrungswerte, die auf Freigabepipelinen angewendet werden. Pipeline-Autoren können diese Standardwerte überschreiben.
• Endgültiges Löschen von Versionen: Steuert, wie lange gelöschte Versionen vor der dauerhaften Entfernung aufbewahrt werden. Einzelne Release-Pipelines können diese Richtlinie nicht überschreiben.

Globale Archivierungsrichtlinie für Releases

Wenn Sie Azure DevOps Server lokal verwenden, können Sie Standardwerte auf Projektebene und Höchstwerte für die Freigabeaufbewahrung konfigurieren. Sie können auch festlegen, wann gelöschte Versionen dauerhaft zerstört werden. (Sie werden aus der Registerkarte " Gelöscht " im Build-Explorer entfernt.)

• Maximale Aufbewahrungsrichtlinie: Definiert die obere Grenze für die Dauer der Aufbewahrung von Versionen über alle Releasepipelines hinweg. Pipelineautoren können die Aufbewahrung nicht über diesen Grenzwert hinaus konfigurieren.
• Standardaufbewahrungsrichtlinie: Definiert die Standardaufbewahrungswerte, die auf Freigabepipelinen angewendet werden. Pipeline-Autoren können diese Standardwerte überschreiben.
• Endgültiges Löschen von Versionen: Steuert, wie lange gelöschte Versionen vor der dauerhaften Entfernung aufbewahrt werden. Einzelne Release-Pipelines können diese Richtlinie nicht überschreiben.

Festlegen von Aufbewahrungsrichtlinien auf Sammlungsebene

Wenn Sie einen lokalen Server verwenden, können Sie die Aufbewahrung auf Sammlungsebene auch mit benutzerdefinierten Regeln konfigurieren. Diese Einstellungen gelten für klassische Build-Pipelines und definieren die Standard- und maximalen Aufbewahrungswerte für die Sammlung.

Verwenden der Aufgabe "Dateien kopieren" zum längeren Speichern von Daten

Wenn Sie die Buildausgabe länger als der konfigurierte Aufbewahrungszeitraum beibehalten müssen, kopieren Sie sie mithilfe der Aufgabe "Dateien kopieren" in Ihren eigenen Speicherort.

Verwenden Sie "Dateien kopieren" anstelle von "Buildartefakte veröffentlichen", da Daten, die als Buildartefakte veröffentlicht wurden, weiterhin der Aufbewahrungsbereinigung unterliegen.

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

Wie behalte ich meine Versionskontrollbezeichnungen oder Tags bei?

Wenn Bezeichnungen oder Tags nach dem Löschen eines Builds beibehalten werden müssen, wenden Sie sie in einer Pipelineaufgabe an, fügen Sie sie manuell außerhalb der Pipeline hinzu, oder behalten Sie den Build unbegrenzt bei.

Was geschieht mit Pipelines, die in anderen Pipelines verwendet werden?

Klassische Releases bewahren Pipelines auf, die sie automatisch nutzen.

Was geschieht mit Pipelines, die in anderen Pipelines verwendet werden?

Klassische Releases bewahren Pipelines auf, die sie automatisch nutzen. Wenn Sie YAML verwenden, können Sie auch eine mehrstufige YAML-Pipeline erstellen, um Ihre Version darzustellen und eine andere YAML-Pipeline darin als Ressource zu nutzen. Die Ressourcenpipeline wird automatisch aufbewahrt, solange die Releasepipeline aufbewahrt wird.