Pakketten verwijderen en herstellen

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure-artefacten slaat pakketversies op die u rechtstreeks publiceert naar uw feeds en versies die zijn opgeslagen vanuit upstream-bronnen. In de loop van de tijd kunnen oudere of ongebruikte versies het opslaggebruik verhogen en feeds moeilijker te beheren maken. U kunt pakketten handmatig verwijderen of bewaarbeleid gebruiken om oudere versies automatisch te verwijderen. Verwijderde pakketten blijven 30 dagen in de Prullenbak staan voordat Azure-artefacten ze definitief verwijdert.

In dit artikel wordt uitgelegd hoe u pakketten verwijdert, bewaarbeleid configureert en verwijderde pakketten herstelt in Azure-artefacten.

Benodigdheden

Product vereisten
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.
- Een Azure-artefacten-feed.
- Toestemmingen:
    - U moet een Feed-eigenaar zijn om retentiebeleid in te stellen, pakketten en feeds te verwijderen of pakketten uit de prullenbak te herstellen.
    - U moet een Feed Publisher (Inzender) of hoger zijn om pakketten uit de lijst te halen, af te schaffen of te verwijderen.

Pakketten verwijderen

In Azure-artefacten zijn pakketten onveranderbaar. Nadat u een pakketversie naar een feed hebt gepubliceerd, kunt u die versie niet wijzigen of het versienummer ervan opnieuw gebruiken voor een nieuw pakket. Dit gedrag helpt de pakketintegriteit in uw feeds te behouden en voorkomt dat builds of consumenten verschillende inhoud voor dezelfde versie ontvangen. Zelfs als u het pakket later verwijdert, houdt Azure-artefacten de versie in de geschiedenis van de feed en blijft dat versienummer permanent gereserveerd.

Voor NuGet-pakketten kunt u de lijst opheffen of een pakketversie verwijderen . Het verwijderen uit de lijst verbergt de pakketversie in de zoekresultaten van Azure-artefacten-feeds en op NuGet.org, maar het pakket blijft in de feed staan. Als u een pakketversie verwijdert, wordt deze verplaatst naar de Prullenbak en is deze niet beschikbaar voor installatie.

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer het pakket dat u wilt verwijderen en selecteer vervolgens Van lijst halen om het te verbergen in zoekresultaten in Azure-artefacten-feeds en op NuGet.orgof Verwijderen om het naar de Prullenbak te verplaatsen.

    een schermopname waarin wordt weergegeven hoe u een NuGet-pakket verwijdert of niet meer in de lijst opneemt in Azure-artefacten.

Pakketten uit de lijst verwijderen (CLI)

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefactenen selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer Verbinding maken met feed>NuGet.exeen zoek en kopieer uw pakketbron-URL. Deze indeling moet worden gevolgd: https://pkgs.dev.azure.com/OrganizationName/ProjectName/_packaging/FeedName/nuget/v3/index.json.

  4. Voer de volgende opdracht uit om je pakket uit de lijst te verwijderen. Het argument ApiKey is vereist, maar Azure-artefacten deze als tijdelijke aanduiding voor deze bewerking behandelt, zodat u een willekeurige tekenreeks kunt gebruiken:

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

Belangrijk

Azure DevOps interpreteert de nuget.exe delete opdracht als een bewerking om uit de lijst te verwijderen. Als u deze opdracht uitvoert, wordt het pakket niet uit uw feed verwijderd. In plaats daarvan wordt het pakket verborgen in zoekresultaten in Azure-artefacten feeds en op NuGet.org. Als u een pakket uit de feed wilt verwijderen, gebruikt u de REST API of verwijdert u het handmatig uit de webinterface.

Pakketten permanent verwijderen

Verwijderde pakketten blijven 30 dagen in de Prullenbak staan voordat Azure-artefacten ze automatisch verwijdert. Gedurende dat periode van 30 dagen tellen deze pakketten nog steeds mee voor uw opslaggebruik. Als u een pakket niet hoeft te herstellen, kunt u het permanent verwijderen uit de Prullenbak om het eerder te verwijderen.

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefactenen selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer in de rechterbovenhoek Prullenbak.

  4. Selecteer het pakket dat u wilt verwijderen en selecteer vervolgens Definitief verwijderen.

    Een schermopname waarin wordt weergegeven hoe u een pakket permanent verwijdert in Azure-artefacten.

  5. Selecteer Definitief Verwijderen opnieuw om uw beslissing te bevestigen.

    Een schermopname met een bevestigingsbericht voordat u een pakket definitief verwijdert.

Pakketten automatisch verwijderen met bewaarbeleid

Naarmate het aantal pakketversies in uw feed groeit, kan het opslaggebruik snel toenemen. Met bewaarbeleid kunt u deze groei beheren door automatisch oudere pakketversies te verwijderen die u niet meer nodig hebt.

Als u een pakketversie voor onbepaalde tijd wilt behouden, promoot deze dan tot een weergave. Pakketten in een weergave zijn uitgesloten van bewaarbeleid, dus deze opschoonregels verwijderen ze niet. Volg deze stappen om bewaarbeleid voor uw feed te configureren:

Notitie

Azure-artefacten biedt geen ondersteuning voor pakketdegradatie. Zodra een pakket is gepromoveerd naar een weergave, kan het niet meer worden teruggezet naar @local.

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefactenen selecteer vervolgens het tandwielpictogram tandwielpictogram in de rechterbovenhoek om toegang te krijgen tot de instellingen van uw feed.

  3. Selecteer Feeddetails, selecteer Pakketretentie inschakelen en configureer vervolgens de volgende instellingen:

    • Maximum aantal versies per pakket: het aantal versies dat voor elk pakket moet worden bewaard.

    • Dagen om onlangs gedownloade pakketten te bewaren: een pakketversie wordt alleen verwijderd als deze niet is gedownload voor het aantal dagen dat u opgeeft.

  4. Kies Opslaan wanneer u klaar bent.

    een schermopname waarin wordt weergegeven hoe u bewaarbeleid voor uw feed instelt.

Notitie

Wanneer u bewaarbeleid inschakelt, verwijdert Azure-artefacten alleen een pakketversie wanneer aan beide van de volgende voorwaarden wordt voldaan:

  • Het totale aantal gepubliceerde versies bereikt het Maximum aantal versies per pakket limiet.
  • Een versie van dat pakket is niet gedownload binnen de periode die is opgegeven in Dagen om onlangs gedownloade pakkettente bewaren.

Verwijderde pakketten herstellen

Azure-artefacten verwijderde pakketten 30 dagen in de Prullenbak bewaart voordat ze definitief worden verwijderd. Gedurende die tijd kunt u een pakketversie herstellen als u deze per ongeluk hebt verwijderd of als een team er nog steeds van afhankelijk is. Voer de volgende stappen uit om een pakket te herstellen vanuit de Prullenbak:

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Klik op Artefactenen klik op Prullenbak.

  3. Selecteer het pakket dat u wilt herstellen en selecteer vervolgens Herstellen.

  4. Selecteer Opnieuw herstellen om uw beslissing te bevestigen.

    een schermopname waarin wordt weergegeven hoe verwijderde pakketten kunnen worden hersteld.

Vragen en Antwoorden

Wat is het verschil tussen het verouderd verklaren, de notering verwijderen, intrekken en verwijderen van een pakketversie?

De actie die u gebruikt, is afhankelijk van het pakkettype en of u een pakketversie wilt verbergen, het gebruik ervan wilt ontmoedigen of verwijderen uit de feed:

  • Afgeschaft (npm): Hiermee voegt u een waarschuwingsbericht toe aan de metagegevens van het pakket. Gebruikers zien de waarschuwing wanneer ze het pakket bekijken of installeren.
  • Lijst opheffen (NuGet): Hiermee wordt de pakketversie verborgen in zoekresultaten in Azure-artefacten feeds en op NuGet.org, maar wordt deze niet uit de feed verwijderd.
  • Yank (Cargo): Markeert de pakketversie als niet beschikbaar voor nieuwe afhankelijkheden zonder deze uit de feed te verwijderen.
  • Verwijderen: Hiermee verplaatst u de pakketversie naar de Prullenbak en is deze niet beschikbaar voor installatie of download. U kunt het gedurende 30 dagen herstellen voordat Azure-artefacten het definitief verwijdert.

U kunt pakketversies verwijderen uit npm-, Maven-, Python-, Cargo- en Universal Packages-feeds. Pakketspecifieke acties, zoals afgeschaft, uit de lijst verwijderen en yank, zijn alleen beschikbaar voor de ecosystemen die deze ondersteunen.

Hoe verwijder ik alle versies van een pakket?

Als u alle versies van een pakket wilt verwijderen, selecteert u het pakket in uw feed, selecteert u Versies en schakelt u het selectievakje naast Versie in om alle beschikbare versies te selecteren. Selecteer Verwijderen en bevestig de verwijdering wanneer u hierom wordt gevraagd.

Een schermopname waarin wordt weergegeven hoe u alle versies uit een feed verwijdert.

Wat gebeurt er met oudere pakketversies wanneer ik bewaarbeleid inschakelen?

Wanneer u bewaarbeleid inschakelt, Azure-artefacten bestaande pakketversies en nieuwe gepubliceerde versies evalueert op basis van de beleidsinstellingen. Pakketversies die voldoen aan de bewaarcriteria, worden voorlopig verwijderd en verplaatst naar de Prullenbak.

De opschoontaak wordt één keer per dag uitgevoerd. Wanneer u bewaarbeleid voor de eerste keer inschakelt, kan er een initiële vertraging optreden voordat oudere pakketversies worden verwerkt.

Verwijderde pakketten blijven 30 dagen in de Prullenbak staan voordat Azure-artefacten ze definitief verwijdert. Als u wilt voorkomen dat deze pakketten worden meegerekend naar factureerbare opslag voordat de periode van 30 dagen afloopt, verwijdert u deze definitief uit de Prullenbak met behulp van de webinterface of de REST API.

Wat gebeurt er als ik bewaarbeleid niet wil inschakelen?

Azure-artefacten bewaarbeleid is ontworpen om uw afhankelijkheden te beheren en kostenbeheer voor opslag te stroomlijnen. Als u bewaarbeleid niet inschakelt, moet u het opschonen van pakketten handmatig beheren door het opslaggebruik te controleren en pakketversies indien nodig te verwijderen. Deze aanpak geeft u volledige controle over wat er in de feed blijft, maar het vereist ook doorlopend onderhoud naarmate pakketversies zich verzamelen.

Azure-artefacten bevat 2 GiB gratis opslagruimte per organisatie. Nadat u deze limiet hebt overschreden, kunt u pas nieuwe artefacten publiceren nadat u facturering hebt ingesteld en de opslaglimiet hebt verhoogd.

Hoe lang duurt het voordat de opslag waarvoor kosten in rekening worden gebracht, wordt bijgewerkt nadat ik pakketten heb verwijderd?

Normaal gesproken moet het opslagverbruik binnen 24 uur worden bijgewerkt. In sommige gevallen kan het echter tot 48 uur duren voordat de wijzigingen worden doorgevoerd. Het gebruik van artefacten op de factureringspagina van uw organisatie wordt eenmaal per dag bijgewerkt, terwijl de pagina Artefactopslag vaker wordt bijgewerkt, wat kan leiden tot een kleine discrepantie tussen de twee.