Löschen und Wiederherstellen von Paketen

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019 | TFS 2018

Azure Artifacts speichert verschiedene Pakettypen sicher in Ihrem Feed, unabhängig davon, ob Sie sie direkt veröffentlicht oder aus Upstream Quellen gespeichert haben. Da ältere Paketversionen weniger relevant werden, können Sie erwägen, sie durch manuelles Löschen oder mithilfe von Aufbewahrungsrichtlinien zu entfernen. In diesem Artikel lernen Sie Folgendes:

  • Löschen Sie Pakete aus Ihrem Feed.
  • Einrichten von Aufbewahrungsrichtlinien
  • Löschen Sie Pakete manuell dauerhaft.
  • Stellen Sie kürzlich gelöschte Pakete wieder her.

Hinweis

Um Pakete zu löschen oder Aufbewahrungsrichtlinien einzurichten, müssen Sie Feedbesitzer oder Administrator sein.

Löschen von Paketen

In Azure Artifacts sind Pakete unveränderlich. Nachdem Sie ein Paket in Ihrem Feed veröffentlicht haben, ist dessen Versionsnummer dauerhaft reserviert. Selbst wenn Sie es aus Ihrem Feed löschen, können Sie kein neues Paket mit derselben Versionsnummer veröffentlichen.

Hinweis

Sie müssen Mitwirkender sein, um die Liste eines Pakets aufzuheben, und ein Besitzer , um es zu löschen.

Es stehen zwei Optionen zum Entfernen eines NuGet-Pakets aus Ihrem Feed zur Verfügung: Auslist aufheben und Löschen. Wenn Sie die Liste einer Paketversion aufheben, wird sie in den Suchergebnissen in Azure Artifacts-Feeds und auf NuGet.org ausgeblendet. Beim Löschen einer Paketversion wird sie in den Papierkorb gesendet und für die Installation nicht mehr verfügbar.

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed aus dem Dropdownmenü aus.

  3. Wählen Sie das Paket aus, das Sie löschen möchten, und wählen Sie dann Auslist aufheben oder Löschen aus.

    Screenshot: Löschen oder Aufheben der Liste eines NuGet-Pakets

  1. Navigieren Sie zu Ihrem Projekt http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Wählen Sie Build and Release (Erstellen und Freigeben) aus.

  3. Wählen Sie Pakete und dann das Paket aus, das Sie löschen möchten.

  4. Wählen Sie Auslistung aufheben oder Letzte löschen aus.

    Screenshot: Löschen oder Aufheben der Liste eines NuGet-Pakets in Team Foundation Server 2018

Aufheben der Liste von Paketen mithilfe von NuGet.exe

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed aus dem Dropdownmenü aus.

  3. Wählen Sie Verbinden aus, umNuGet.exezu feeden>, und suchen Und kopieren Sie dann Ihre Paketquell-URL. Es sollte dem folgenden Format ähneln: "https://pkgs.dev.azure.com/OrganizationName/ProjectName/_packaging/FeedName/nuget/v3/index.json".

  4. Führen Sie den folgenden Befehl aus, um die Liste Ihres NuGet-Pakets aufzuheben:

    nuget.exe delete <PACKAGE_NAME> <PACKAGE_VERSION> -Source <PACKAGE_SOURCE_URL> -ApiKey <KEY>

Hinweis

Azure DevOps und Visual Studio Team Foundation Server interpretieren den Befehl als Vorgang zum Aufheben der nuget.exe delete Liste. Zum Löschen eines Pakets müssen Sie die REST-API verwenden oder manuell über die Weboberfläche löschen.

Dauerhaftes Löschen von Paketen

Pakete, die im Papierkorb abgelegt werden, werden nach 30 Tagen endgültig gelöscht, tragen aber während dieser Zeit weiterhin zu Ihren Speicherkosten bei. Wenn Sie sie vor diesem Zeitraum entfernen möchten, können Sie sie manuell aus dem Papierkorb löschen, indem Sie die folgenden Schritte ausführen:

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  3. Wählen Sie in der oberen rechten Ecke Papierkorb aus.

    Screenshot: Zugreifen auf den Papierkorb in Azure Artifacts

  4. Wählen Sie das Paket aus, das Sie endgültig löschen möchten, und wählen Sie dann Dauerhaft Löschen aus.

    Screenshot: Dauerhaftes Löschen eines Pakets in Azure Artifacts

  5. Wählen Sie erneut Dauerhaft Löschen aus, um Ihre Entscheidung zu bestätigen. Ihr Paket wird endgültig gelöscht.

    Screenshot: Bestätigungsmeldung vor dem endgültigen Löschen eines Pakets

Automatisches Löschen von Paketen mit Aufbewahrungsrichtlinien

Die Anzahl der Versionen für jedes Paket, das in Ihrem Feed gehostet wird, kann schnell wachsen. Um Speicherplatz freizugeben, können Sie Aufbewahrungsrichtlinien einrichten, um alte Pakete automatisch zu löschen.

Wenn Sie ein Paket unbegrenzt beibehalten möchten, können Sie es zu einer Ansicht heraufstufen. Pakete, die zu einer Ansicht höhergestuft werden, sind von Aufbewahrungsrichtlinien ausgenommen und werden nicht gelöscht. Führen Sie zum Konfigurieren von Aufbewahrungsrichtlinien für Ihren Feed die folgenden Schritte aus:

Hinweis

Azure Artifacts unterstützt keine Paket-Herabstufung.

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann das Zahnradsymbol Zahnradsymbol in der oberen rechten Ecke aus, um auf die Einstellungen Ihres Feeds zuzugreifen.

  3. Wählen Sie Feeddetails aus, und aktivieren Sie dann das Kontrollkästchen Paketaufbewahrung aktivieren . Geben Sie Werte für die maximale Anzahl von Versionen pro Paket und Für Tage an, um zuletzt heruntergeladene Pakete beizubehalten.

    • Maximale Anzahl von Versionen pro Paket: Die Anzahl der Versionen für jedes Paket, das Sie beibehalten möchten.

    • Tage, um zuletzt heruntergeladene Pakete beizubehalten: Pakete werden nur gelöscht, wenn sie nicht für die hier angegebene Anzahl von Tagen heruntergeladen wurden.

  4. Wählen Sie Speichern aus, wenn Sie fertig sind.

    Screenshot: Einrichten von Aufbewahrungsrichtlinien für Ihren Feed

  1. Navigieren Sie zu Ihrem Projekt http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Wählen Sie Erstellen und Freigeben und dann Pakete aus.

  3. Wählen Sie das Zahnradsymbol Zahnradsymbol aus , um auf die Einstellungen Ihres Feeds zuzugreifen.

  4. Geben Sie auf der Registerkarte Aufbewahrung einen Wert für maximale Anzahl von Versionen pro Paket und Tage an, um zuletzt heruntergeladene Pakete beizubehalten.

    • Maximale Anzahl von Versionen pro Paket: Die Anzahl der Versionen für jedes Paket, das Sie beibehalten möchten.
    • Tage, um zuletzt heruntergeladene Pakete beizubehalten: Pakete werden nur gelöscht, wenn sie nicht für die hier angegebene Anzahl von Tagen heruntergeladen wurden.

  5. Wählen Sie Speichern aus, wenn Sie fertig sind.

Hinweis

Wenn Sie Aufbewahrungsrichtlinien aktivieren, wird eine Version eines Pakets gelöscht, wenn die beiden folgenden Bedingungen erfüllt sind:

  • Die Anzahl der veröffentlichten Versionen erreicht die Maximale Anzahl von Versionen pro Paket .
  • Eine Version dieses Pakets wurde für den in Tagen angegebenen Zeitraum nicht heruntergeladen , um zuletzt heruntergeladene Pakete beizubehalten.

Wiederherstellen gelöschter Pakete

Gelöschte Pakete verbleiben 30 Tage lang im Papierkorb. Nach diesem Zeitraum werden sie endgültig gelöscht. Sie müssen Feedbesitzer sein, um gelöschte Pakete wiederherzustellen.

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Papierkorb aus.

  3. Wählen Sie Ihr Paket und dann Wiederherstellen aus.

    Screenshot: Wiederherstellen gelöschter Pakete

  4. Wählen Sie erneut Wiederherstellen aus, um Ihre Entscheidung zu bestätigen.

  1. Navigieren Sie zu Ihrem Projekt http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Wählen Sie Build and Release Packages (Pakete erstellen und freigeben>) und dann Papierkorb aus.

  3. Wählen Sie Ihr Paket aus, und wählen Sie dann die Paketversion aus, die Sie löschen möchten.

    Screenshot: Paket im Papierkorb in Team Foundation Server

  4. Wählen Sie zum Feed Wiederherstellen aus.

    Screenshot: Schaltfläche zum Wiederherstellen des Feeds in Team Foundation Server

F&A

F: Was ist der Unterschied zwischen Veraltet, Nicht liste, Yank und Paketversion löschen ?

A: Veraltet gilt für npm-Pakete, Yank gilt für Cargo-Pakete, während Unlist für NuGet-Pakete gilt. Sie können auch alle Pakettypen (npm, Maven, Python, Cargo und Universal Packages) löschen :

  • Veraltet (npm): Wenn Sie eine Paketversion als veraltet festlegen, wird den Metadaten des Pakets eine Warnmeldung hinzugefügt. Azure Artifacts und die meisten npm-Clients zeigen diese Warnmeldung immer dann an, wenn das Paket angezeigt oder installiert wird.

  • Aufheben der Liste (NuGet): Das Aufheben der Liste einer Paketversion blendet sie in den Suchergebnissen in Azure Artifacts-Feeds und auf NuGet.org aus.

  • Yank (Cargo): Das Yanking einer Paketversion markiert sie als veraltet oder veraltet, was die Verwendung verhindert, aber das Paket wird nicht gelöscht.

  • Löschen: Durch das Löschen einer Paketversion ist die Installation nicht mehr verfügbar. Gelöschte Pakete können innerhalb von 30 Tagen nach dem Löschen aus dem Papierkorb wiederhergestellt werden. Nach diesem Zeitraum werden die Pakete endgültig gelöscht.

F: Was geschieht mit alten oder vorhandenen Paketen, wenn wir Aufbewahrungsrichtlinien aktivieren?

A: Alte oder vorhandene Pakete werden vorläufig gelöscht und in den Papierkorb verschoben. Der Löschauftrag wird ein Mal pro Tag ausgeführt, aber es kann zu einer anfänglichen Verzögerung kommen, nachdem die Richtlinie zum ersten Mal aktiviert wurde, weil ein Zustrom von Paketen zu verzeichnen ist.

Pakete verbleiben 30 Tage lang im Papierkorb, bevor sie endgültig gelöscht werden. Um die Pakete aus Ihrem kostenpflichtigen Speicher zu entfernen, können Sie sie manuell löschen, indem Sie die Benutzeroberfläche oder die REST-API verwenden, bevor die 30 Tage abgelaufen sind.

F: Wie lange dauert es, bis der in Rechnung gestellte Speicherbetrag nach dem Löschen von Artefakten aktualisiert wird?

A: In der Regel sollte der Speicherverbrauch innerhalb von 24 Stunden aktualisiert werden, obwohl es in bestimmten Fällen bis zu 48 Stunden dauern kann, bis die Änderungen widerspiegelt werden. Die Artefaktverwendung auf der Abrechnungsseite Ihres organization wird einmal täglich aktualisiert. Die Seite Artefaktspeicher wird jedoch häufiger aktualisiert, was zu einer geringfügigen Diskrepanz zwischen den auf den beiden Seiten angezeigten Informationen führen kann.