Dela via


Ta bort och återställa paket

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Azure Artifacts lagrar säkert olika pakettyper i en feed, oavsett om de publiceras direkt eller sparas från överordnade källor. När äldre paketversioner blir mindre relevanta kan du ta bort dem manuellt eller genom att använda kvarhållningsprinciper för att frigöra utrymme och minska kostnaderna.

Förutsättningar

Produkt Kravspecifikationer
Azure DevOps – En organisation i Azure DevOps .
– Ett Azure DevOps-projekt.
– Ett Azure Artifacts-flöde.
- behörigheter:
    – Du måste vara en flödesägare för att konfigurera kvarhållningsprinciper, ta bort paket och flöden eller återställa paket från papperskorgen.
    – Du måste vara en flödespublicerare (kontributör) eller högre för att avlista, föråldra eller dra tillbaka paket.

Ta bort paket

I Azure Artifacts är paket oföränderliga, vilket innebär att deras versionsnummer inte kan återanvändas eller ändras efter publiceringen. När du publicerar ett paket i en feed är versionsnumret permanent reserverat. Även om du tar bort paketet förblir dess version registrerad i feedens historik och du kan inte publicera ett nytt paket med samma versionsnummer.

Det finns två sätt att ta bort ett NuGet-paket från en feed: Ta bort och Ta bort. Om du avlistar en paketversion döljs den från sökresultat i Azure Artifacts-feeds och på NuGet.org. Om du tar bort en paketversion flyttas den till papperskorgen och gör den otillgänglig för installation.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj det paket som du vill ta bort och välj sedan Ta bort för att dölja det från sökresultat i Azure Artifacts-feeds och på NuGet.orgeller Ta bort för att flytta det till papperskorgen.

    En skärmbild som visar hur du tar bort eller avlistar ett NuGet-paket i Azure Artifacts.

Ta bort lista över paket (CLI)

  1. Logga in på din Azure DevOps-organisation och gå sedan till projektet.

  2. Välj Artefakteroch välj sedan din feed i rullgardinsmenyn.

  3. Välj Anslut för att mata>NuGet.exeoch leta sedan upp och kopiera url:en för -paketkälla. Det bör följa det här formatet: https://pkgs.dev.azure.com/OrganizationName/ProjectName/_packaging/FeedName/nuget/v3/index.json.

  4. Kör följande kommando för att avlista paketet. Argumentet ApiKey krävs men behandlas som platshållare när du publicerar till en Azure Artifacts-feed, så att du kan använda valfritt strängvärde:

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

Viktigt!

Azure DevOps tolkar kommandot nuget.exe delete som en avlistningsåtgärd. Det innebär att kommandot inte tar bort paketet utan i stället döljer det från sökresultat i Azure Artifacts-feeds och på NuGet.org. Om du vill ta bort ett paket från feeden måste du använda REST API- eller ta bort det manuellt från webbgränssnittet.

Ta bort paket permanent

Paket i papperskorgen tas bort automatiskt efter 30 dagar, men de räknas fortfarande mot din lagringsanvändning under den här perioden. Om du vill ta bort dem tidigare kan du ta bort dem manuellt från papperskorgen genom att följa dessa steg:

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakteroch välj sedan din feed från rullgardinsmenyn.

  3. I det övre högra hörnet väljer du Papperskorgen.

  4. Välj det paket som du vill ta bort permanent och välj sedan Ta bort permanent.

    En skärmbild som visar hur du tar bort ett paket permanent i Azure Artifacts.

  5. Välj Ta bort permanent igen för att bekräfta ditt beslut. Paketet tas bort permanent.

    En skärmbild som visar ett bekräftelsemeddelande innan du tar bort ett paket permanent.

Ta bort paket automatiskt med bevarandeprinciper

I takt med att antalet paketversioner i flödet växer kan lagringsanvändningen öka snabbt. Du kan konfigurera kvarhållningsprinciper för att automatiskt ta bort gamla paketversioner och frigöra utrymme.

Om du behöver behålla ett paket på obestämd tid höjer du upp det till en vy. Paket i en vy är undantagna från kvarhållningsprinciper och kommer inte att tas bort. Följ stegen nedan för att konfigurera kvarhållningsprinciper för ditt flöde:

Anmärkning

Azure Artifacts stöder inte nedgradering av paket. När ett paket har befordrats till en vy kan det inte återställas till @local.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakteroch välj kugghjulsikonen kugghjulsikonen i det övre högra hörnet för att komma åt feedens inställningar.

  3. Välj feed-information, markera kryssrutan Aktivera kvarhållning av paket och konfigurera följande inställningar:

    • Maximalt antal versioner per paket: Antalet versioner för varje paket som du vill behålla.

    • Dagar för att behålla nyligen nedladdade paket: Paket tas bara bort om de inte har laddats ned under det angivna antalet dagar som anges här.

  4. Välj Spara när du är klar.

    En skärmbild som visar hur du konfigurerar kvarhållningsprinciper för ditt flöde.

Anmärkning

När kvarhållningsprinciper är aktiverade tas en paketversion bara bort när båda av följande villkor uppfylls:

  • Det totala antalet publicerade versioner når Maximalt antal versioner per paket gräns.
  • En version av paketet har inte laddats ned inom den tidsram som anges i Days för att behålla nyligen nedladdade paket.

Återställa borttagna paket

Borttagna paket finns kvar i papperskorgen i 30 dagar. Efter den här perioden tas de bort permanent. Följ dessa steg för att återställa ett paket från papperskorgen:

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter, sedan välj Papperskorgen.

  3. Välj ditt paket och välj sedan Återställ.

  4. Välj Återställ igen för att bekräfta ditt beslut.

    En skärmbild som visar hur du återställer borttagna paket.

Frågor och svar

F: Vad är skillnaden mellan Deprecate, Unlist, Yankoch Delete en paketversion?

S: Föråldra gäller för npm-paket, Ta bort gäller för Cargo-paket medan Avlista gäller för NuGet-paket. Du kan Ta bort någon av pakettyperna (npm, Maven, Python, Cargo och universella paket) från Azure Artifacts-flödet.

  • Avmarkera (npm): När du avmarkerar en paketversion läggs ett varningsmeddelande till i paketets metadata. Azure Artifacts och de flesta npm-klienter visar det här varningsmeddelandet när paketet visas eller installeras.

  • Avlista (NuGet): Avlistning av en paketversion döljer den från sökresultat i Azure Artifacts-feeds och på NuGet.org.

  • Yank (Cargo): Att dra tillbaka en paketversion markerar det som utdaterat, vilket avråder från dess användning, men det tar inte bort paketet.

  • Ta bort: Om du tar bort en paketversion flyttas den till papperskorgen, vilket gör den otillgänglig för installation. Borttagna paket kan återställas från papperskorgen inom 30 dagar. Efter den här perioden tas de bort permanent.

F: Hur tar jag bort alla paketversioner?

S: Om du vill ta bort alla versioner av ett paket väljer du paketet i feeden, väljer Versioneroch markerar sedan kryssrutan bredvid version. Då väljs alla versioner av paketet i feeden. Välj Ta bortoch välj sedan ta bort en gång till för att bekräfta.

En skärmbild som visar hur du tar bort alla versioner från en feed.

F: Vad händer med gamla eller befintliga paket när vi aktiverar kvarhållningsprinciper?

S: Gamla eller befintliga paket tas bort mjukt och flyttas till papperskorgen. Borttagningsjobbet körs en gång om dagen, men det kan uppstå en inledande fördröjning efter att regeln har aktiverats första gången på grund av en tillströmning av paket.

Paketen finns kvar i papperskorgen i 30 dagar innan de tas bort permanent. Om du vill ta bort paketen från din fakturerbara lagring kan du ta bort dem manuellt med hjälp av webbgränssnittet eller REST-API:et innan 30-dagarsperioden slutar.

F: Vad händer om jag inte vill aktivera kvarhållningsprinciper?

S: Kvarhållningsprinciper för Azure Artifacts är utformade för att hantera dina beroenden och effektivisera lagringskostnadshanteringen. Om du väljer att inte aktivera kvarhållningsprinciper måste du hantera lagringen manuellt, övervaka förbrukning och ta bort paket efter behov. Azure Artifacts erbjuder 2 GiB kostnadsfri lagring per organisation, vilket gör att du kan utvärdera om tjänsten passar ditt arbetsflöde. När du överskrider lagringsgränsen kan du inte publicera nya artefakter såvida du inte har konfigurerat faktureringen och ökat lagringsgränsen.

F: Hur lång tid tar det för den fakturerade lagringsmängden att uppdateras efter borttagningen av artefakter?

S: Vanligtvis bör lagringsförbrukningen uppdateras inom 24 timmar. I vissa fall kan det dock ta upp till 48 timmar innan ändringarna återspeglas. Artefaktanvändningen på organisationens faktureringssida uppdateras en gång om dagen, medan artefaktlagringssidan uppdateras oftare, vilket kan leda till en liten avvikelse mellan de två.