Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Azure Artifacts archivia le versioni dei pacchetti pubblicate direttamente nei feed e nelle versioni salvate da origini upstream. Nel corso del tempo, le versioni meno recenti o inutilizzate possono aumentare l'utilizzo dell'archiviazione e rendere i feed più difficili da gestire. È possibile eliminare manualmente i pacchetti o usare i criteri di conservazione per rimuovere automaticamente le versioni precedenti. I pacchetti eliminati rimangono nel Cestino per 30 giorni prima che Azure Artifacts li elimini definitivamente.
Questo articolo illustra come eliminare pacchetti, configurare i criteri di conservazione e ripristinare i pacchetti eliminati in Azure Artifacts.
Prerequisiti
| Prodotto | Requisiti |
|---|---|
| Azure DevOps | - Un'organizzazione di Azure DevOps. - Un progetto Azure DevOps . - Un feed di Azure Artifacts. Autorizzazioni - : - È necessario essere un Proprietario del Feed per configurare criteri di conservazione, eliminare pacchetti e feed o ripristinare i pacchetti dal cestino. - È necessario essere un Feed Publisher (Collaboratore) o superiore per rimuovere dall'elenco, deprecare o ritirare pacchetti. |
Eliminare pacchetti
In Azure Artifacts i pacchetti non sono modificabili. Dopo aver pubblicato una versione del pacchetto in un feed, non è possibile modificare tale versione o riutilizzarne il numero di versione per un nuovo pacchetto. Questo comportamento aiuta a preservare l'integrità dei pacchetti nei tuoi feed e impedisce ai processi di compilazione o ai client di ricevere un contenuto diverso per la stessa versione. Anche se si elimina il pacchetto in un secondo momento, Azure Artifacts mantiene la versione nella cronologia del feed e tale numero di versione rimane riservato in modo permanente.
Per i pacchetti NuGet, è possibile annullare l'elenco o eliminare una versione del pacchetto. L'annullamento dell'elenco nasconde la versione del pacchetto dai risultati della ricerca nei feed Azure Artifacts e in NuGet.org, ma il pacchetto rimane nel feed. L'eliminazione di una versione del pacchetto lo sposta nel Cestino e lo rende non disponibile per l'installazione.
Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.
Selezionare Elementi e quindi selezionare il tuo feed dal menu a tendina.
Selezionare il pacchetto da eliminare, quindi selezionare Unlist per nasconderlo dai risultati della ricerca nei feed di Azure Artifacts e in NuGet.orgoppure Elimina per spostarlo nel Cestino.
Rimuovere l'elenco dei pacchetti (interfaccia della riga di comando)
Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.
Selezionare Artefatti e quindi selezionare il tuo feed dal menu a discesa.
Selezionare Connetti al feed>NuGet.exe, quindi trovare e copiare l'URL di origine pacchetto . Deve seguire questo formato:
https://pkgs.dev.azure.com/OrganizationName/ProjectName/_packaging/FeedName/nuget/v3/index.json.Eseguire il comando seguente per annullare l'elenco del pacchetto. L'argomento ApiKey è obbligatorio, ma Azure Artifacts lo considera come valore segnaposto per questa operazione, in modo da poter usare qualsiasi stringa:
nuget.exe delete <PACKAGE_NAME> <PACKAGE_VERSION> -Source <PACKAGE_SOURCE_URL> -ApiKey <ANY_STRING>
Importante
Azure DevOps interpreta il comando nuget.exe delete come operazione di annullamento dell'elenco. L'esecuzione di questo comando non elimina il pacchetto dal feed. Nasconde invece il pacchetto dai risultati della ricerca in feed Azure Artifacts e in NuGet.org. Per eliminare un pacchetto dal feed, usare l'API REST o eliminarlo manualmente dall'interfaccia Web.
Eliminare i pacchetti in modo permanente
I pacchetti eliminati rimangono nel Cestino per 30 giorni prima che Azure Artifacts li rimuovono automaticamente. Durante la finestra di 30 giorni, questi pacchetti vengono comunque conteggiati per l'utilizzo dello spazio di archiviazione. Se non è necessario ripristinare un pacchetto, è possibile eliminarlo definitivamente dal Cestino per rimuoverlo prima.
Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.
Selezionare Artefatti e quindi selezionare il tuo feed dal menu a discesa.
Nell'angolo superiore destro, selezionare il Cestino.
Selezionare il pacchetto da rimuovere e quindi selezionare Elimina definitivamente.
Selezionare di nuovo Elimina definitivamente per confermare la decisione.
Eliminare automaticamente i pacchetti con i criteri di conservazione
Man mano che il numero di versioni del pacchetto nel feed aumenta, l'utilizzo dell'archiviazione può crescere rapidamente. I criteri di conservazione consentono di gestire la crescita rimuovendo automaticamente le versioni precedenti dei pacchetti non più necessarie.
Se è necessario mantenere una versione del pacchetto per un periodo illimitato, alzarla di livello a una visualizzazione. I pacchetti in una visualizzazione sono esenti dai criteri di conservazione, quindi queste regole di pulizia non le eliminano. Per configurare i criteri di conservazione per il feed, seguire questa procedura:
Nota
Azure Artifacts non supporta l'abbassamento di livello dei pacchetti. Una volta che un pacchetto è promosso a una visualizzazione, non può essere ripristinato a @local.
Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.
Selezionare Artefatti, quindi selezionare l'icona a forma di ingranaggio
nell'angolo superiore destro per accedere alle impostazioni del feed.Selezionare Dettagli feed, selezionare Abilita conservazione pacchetti e quindi configurare le impostazioni seguenti:
Numero massimo di versioni per pacchetto: numero di versioni da mantenere per ogni pacchetto.
Giorni per mantenere i pacchetti scaricati di recente: una versione del pacchetto viene eliminata solo se non è stata scaricata per il numero di giorni specificato.
Al termine, seleziona Salva.
Nota
Quando si abilitano i criteri di conservazione, Azure Artifacts elimina una versione del pacchetto solo quando vengono soddisfatte entrambe le condizioni seguenti:
- Il numero totale di versioni pubblicate raggiunge il numero massimo di versioni per pacchetto limite.
- Una versione del pacchetto non è stata scaricata entro l'intervallo di tempo specificato in Giorni per mantenere i pacchetti scaricati di recente.
Ripristinare i pacchetti eliminati
Azure Artifacts mantiene i pacchetti eliminati nel Cestino per 30 giorni prima di eliminarli definitivamente. Durante questo periodo, è possibile ripristinare una versione del pacchetto se è stata eliminata per errore o se un team dipende ancora da esso. Per ripristinare un pacchetto dal Cestino, seguire questa procedura:
Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.
Selezionare Artifacts, quindi selezionare Recycle Bin.
Selezionare il pacchetto da ripristinare e quindi selezionare Ripristina.
Selezionare di nuovo Ripristina per confermare la decisione.
Domande e risposte
Qual è la differenza tra deprecazione, rimozione dall'elenco, ritiro ed eliminazione di una versione del pacchetto?
L'azione usata dipende dal tipo di pacchetto e dal fatto che si voglia nascondere una versione del pacchetto, scoraggiarne l'uso o rimuoverlo dal feed:
- Deprecate (npm): aggiunge un messaggio di avviso ai metadati del pacchetto. Gli utenti visualizzano l'avviso quando visualizzano o installano il pacchetto.
- Annulla l'elenco (NuGet): nasconde la versione del pacchetto dai risultati della ricerca nei feed Azure Artifacts e in NuGet.org, ma non la rimuove dal feed.
- Yank (Cargo): contrassegna la versione del pacchetto come non disponibile per le nuove dipendenze senza eliminarla dal feed.
- Elimina: sposta la versione del pacchetto nel Cestino e lo rende non disponibile per l'installazione o il download. È possibile ripristinarlo per 30 giorni prima che Azure Artifacts lo elimini definitivamente.
È possibile eliminare le versioni dei pacchetti dai feed npm, Maven, Python, Cargo e Universal Packages. Le azioni specifiche del tipo di pacchetto, ad esempio deprecate, unlist e yank, sono disponibili solo per gli ecosistemi che li supportano.
Come si eliminano tutte le versioni di un pacchetto?
Per eliminare tutte le versioni di un pacchetto, selezionare il pacchetto nel feed, selezionare Versioni e quindi selezionare la casella di controllo accanto a Versione per selezionare tutte le versioni disponibili. Selezionare Elimina e quindi confermare l'eliminazione quando richiesto.
Cosa accade alle versioni precedenti dei pacchetti quando si abilitano i criteri di conservazione?
Quando si abilitano i criteri di conservazione, Azure Artifacts valuta le versioni dei pacchetti esistenti e le versioni appena pubblicate rispetto alle impostazioni dei criteri. Le versioni dei pacchetti che soddisfano i criteri di conservazione vengono eliminate in modo predefinito e spostate nel Cestino.
Il processo di pulizia viene eseguito una volta al giorno. Quando si abilitano i criteri di conservazione per la prima volta, può verificarsi un ritardo iniziale prima dell'elaborazione delle versioni precedenti del pacchetto.
I pacchetti eliminati rimangono nel Cestino per 30 giorni prima che Azure Artifacts li elimini definitivamente. Se si desidera fare in modo che tali pacchetti non vengano più conteggiati ai fini dello spazio di archiviazione fatturabile prima della fine del periodo di 30 giorni, eliminarli definitivamente dal Cestino tramite l'interfaccia Web o l'API REST.
Cosa succede se non si vogliono abilitare i criteri di conservazione?
Azure Artifacts criteri di conservazione sono progettati per facilitare la gestione delle dipendenze e semplificare la gestione dei costi di archiviazione. Se non si abilitano i criteri di conservazione, è necessario gestire manualmente la pulizia dei pacchetti monitorando l'utilizzo dell'archiviazione ed eliminando le versioni dei pacchetti in base alle esigenze. Questo approccio offre il controllo completo su ciò che rimane nel feed, ma richiede anche una manutenzione continua man mano che le versioni dei pacchetti si accumulano.
Azure Artifacts include 2 GiB di spazio di archiviazione gratuito per ogni organizzazione. Dopo aver superato tale limite, non è possibile pubblicare nuovi artefatti fino a quando non si configura la fatturazione e si aumenta il limite di archiviazione.
Quanto tempo ci vuole perché lo spazio di archiviazione fatturato si aggiorni dopo aver eliminato i pacchetti?
In genere, il consumo di archiviazione deve essere aggiornato entro 24 ore. In alcuni casi, tuttavia, potrebbero essere necessarie fino a 48 ore prima che le modifiche vengano riflesse. L'utilizzo degli artefatti nella pagina di fatturazione dell'organizzazione viene aggiornato una volta al giorno, mentre la pagina Di archiviazione artefatti viene aggiornata più frequentemente, che potrebbe causare una leggera discrepanza tra i due.