Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
O Artefactos do Azure armazena versões de pacotes que publicas diretamente nos teus feeds e versões guardadas de fontes a montante. Com o tempo, versões mais antigas ou não utilizadas podem aumentar o uso de armazenamento e tornar os feeds mais difíceis de gerir. Pode eliminar pacotes manualmente ou usar políticas de retenção para remover versões antigas automaticamente. Os pacotes eliminados ficam no Contentor de Reciclagem durante 30 dias antes de o Artefactos do Azure os apagar permanentemente.
Este artigo explica como eliminar pacotes, configurar políticas de retenção e restaurar pacotes eliminados no Artefactos do Azure.
Pré-requisitos
| Produto | Requisitos |
|---|---|
| Azure DevOps | - Uma organização Azure DevOps . - Um projeto do Azure DevOps . - Um feed de Artefactos do Azure . - Permissões: - Você deve ser um Feed Owner para configurar políticas de retenção, excluir pacotes e feeds ou restaurar pacotes da lixeira. - Você deve ser um Feed Publisher (Colaborador) ou superior para remover da lista, depreciar ou retirar pacotes. |
Excluir pacotes
No Artefactos do Azure, os pacotes são imutáveis. Depois de publicar uma versão de pacote num feed, não pode modificar essa versão nem reutilizar o seu número de versão para um novo pacote. Este comportamento ajuda a preservar a integridade do pacote em todos os seus feeds e impede que builds ou consumidores recebam conteúdos diferentes para a mesma versão. Mesmo que elimines o pacote mais tarde, o Artefactos do Azure mantém a versão no histórico do feed, e esse número de versão permanece permanentemente reservado.
Para pacotes NuGet, pode deslistar ou eliminar uma versão do pacote. A deslistagem esconde a versão do pacote dos resultados de pesquisa nos feeds Artefactos do Azure e no NuGet.org, mas o pacote permanece no feed. Eliminar uma versão de pacote move-a para o Contentor de Reciclagem e torna-o indisponível para instalação.
Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefactos e, em seguida, selecione o seu feed no menu suspenso.
Selecione o pacote que deseja eliminar e, em seguida, selecione Retirar da lista para ocultá-lo dos resultados da pesquisa nos feeds de Artefatos do Azure e em NuGet.org, ou Excluir para movê-lo para a lixeira.
Cancelar a lista de pacotes (CLI)
Entre na sua organização do Azure DevOps e navegue até o seu projeto.
Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.
Selecione Conectar ao feed>NuGet.exee, em seguida, localize e copie a URL da origem do pacote . Deve seguir este formato:
https://pkgs.dev.azure.com/OrganizationName/ProjectName/_packaging/FeedName/nuget/v3/index.json.Execute o seguinte comando para cancelar a lista do pacote. O argumento ApiKey é obrigatório, mas o Artefactos do Azure trata-o como um valor provisório para esta operação, por isso podes usar qualquer string:
nuget.exe delete <PACKAGE_NAME> <PACKAGE_VERSION> -Source <PACKAGE_SOURCE_URL> -ApiKey <ANY_STRING>
Importante
O Azure DevOps interpreta o comando nuget.exe delete como uma operação de remoção de listagem. Executar este comando não apaga o pacote do teu feed. Em vez disso, esconde o pacote dos resultados de pesquisa nos feeds Artefactos do Azure e no NuGet.org. Para eliminar um pacote do feed, use a API REST ou elimine-o manualmente da interface web.
Eliminar pacotes permanentemente
Os pacotes eliminados ficam na Reciclagem durante 30 dias antes de o Artefactos do Azure os remover automaticamente. Durante essa janela de 30 dias, esses pacotes continuam a contar para o seu uso de armazenamento. Se não precisares de restaurar um pacote, podes apagá-lo permanentemente do Contentor de Reciclagem para o remover mais cedo.
Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.
No canto superior direito, selecione Lixeira.
Seleciona o pacote que queres remover e depois seleciona Eliminar Permanentemente.
Para confirmar a sua decisão, selecione novamente Excluir permanentemente.
Excluir pacotes automaticamente com políticas de retenção
À medida que o número de versões de pacotes no feed cresce, o uso do armazenamento pode aumentar rapidamente. As políticas de retenção ajudam-no a gerir esse crescimento ao remover automaticamente versões antigas dos pacotes que já não precisa.
Se precisares de manter uma versão de pacote indefinidamente, promove-a para uma vista. Os pacotes numa visualização estão isentos de políticas de retenção, pelo que estas regras de limpeza não os eliminam. Para configurar políticas de retenção para o seu feed, siga estes passos:
Observação
O Artefactos do Azure não dá suporte ao rebaixamento de pacotes. Depois que um pacote é promovido para uma exibição, ele não pode ser revertido para @local.
Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatose, em seguida, selecione o ícone de engrenagem
no canto superior direito para acessar as configurações do feed.Selecione Detalhes do feed, selecione Ativar retenção de pacotes e depois configure as seguintes definições:
Número máximo de versões por pacote: O número de versões a manter para cada pacote.
Dias para guardar pacotes recentemente descarregados: Uma versão de pacote é eliminada apenas se não tiver sido descarregada durante o número de dias especificado.
Quando terminar, selecione Guardar.
Observação
Quando ativas políticas de retenção, o Artefactos do Azure apaga uma versão de pacote apenas quando ambas as seguintes condições forem verdadeiras:
- O número total de versões publicadas atinge o limite do número máximo de versões por pacote.
- Uma versão desse pacote não foi baixada dentro do prazo especificado em Dias para manter os pacotes baixados recentemente.
Restaurar pacotes excluídos
O Artefactos do Azure mantém os pacotes eliminados no Caixote do Lixo durante 30 dias antes de serem eliminados permanentemente. Durante esse tempo, podes restaurar uma versão do pacote se a apagares por engano ou se uma equipa ainda depender dela. Para restaurar um pacote a partir do Contentor de Reciclagem, siga estes passos:
Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatose, em seguida, selecione Lixeira.
Seleciona o pacote que queres restaurar e depois seleciona Restaurar.
Selecione Restaurar novamente para confirmar a sua decisão.
Perguntas e Respostas
Qual é a diferença entre descontinuar, remover da lista, retirar de circulação e eliminar uma versão de um pacote?
A ação que usas depende do tipo de embalagem e se queres esconder uma versão do pacote, desencorajar o seu uso ou removê-la do feed:
- Deprecate (npm): Adiciona uma mensagem de aviso aos metadados do pacote. Os consumidores veem o aviso quando visualizam ou instalam o pacote.
- Deslistar (NuGet): Oculta a versão do pacote dos resultados de pesquisa em Artefactos do Azure feeds e em NuGet.org, mas não a remove do feed.
- Yank (Cargo): Marca a versão do pacote como indisponível para novas dependências sem a eliminar do repositório.
- Eliminar: Move a versão do pacote para o Contentor de Reciclagem e torna-a indisponível para instalação ou download. Pode restaurá-lo no prazo de 30 dias, antes de o Artefactos do Azure o eliminar permanentemente.
Podes eliminar versões de pacotes dos feeds npm, Maven, Python, Cargo e Universal Packages. Ações específicas do tipo de pacote, como deprecate, unlist e yank, estão disponíveis apenas para os ecossistemas que as suportam.
Como é que apago todas as versões de um pacote?
Para eliminar todas as versões de um pacote, selecione o pacote no seu feed, selecione Versões e depois selecione a caixa ao lado de Versão para selecionar todas as versões disponíveis. Selecione Eliminar e depois confirme a eliminação quando solicitado.
O que acontece às versões antigas dos pacotes quando ativo políticas de retenção?
Quando ativas políticas de retenção, o Artefactos do Azure avalia as versões existentes dos pacotes e as versões recém-publicadas contra as definições da política. As versões dos pacotes que cumprem os critérios de retenção são apagadas suavemente e movidas para o Contentor de Reciclagem.
O trabalho de limpeza acontece uma vez por dia. Quando ativas as políticas de retenção pela primeira vez, pode haver um atraso inicial antes de as versões anteriores dos pacotes serem processadas.
Os pacotes eliminados permanecem na Reciclagem durante 30 dias antes de o Artefactos do Azure os apagar permanentemente. Se quiser evitar que esses pacotes contem para armazenamento faturável antes do fim do período de 30 dias, elimine-os permanentemente do Contentor de Reciclagem usando a interface web ou a API REST.
E se eu não quiser ativar políticas de retenção?
As políticas de retenção do Artefactos do Azure foram concebidas para ajudar a gerir as suas dependências e a simplificar a gestão dos custos de armazenamento. Se não ativar as políticas de retenção, deve gerir manualmente a limpeza dos pacotes monitorizando o uso de armazenamento e eliminando as versões dos pacotes conforme necessário. Esta abordagem dá-lhe controlo total sobre o que permanece no feed, mas também requer manutenção contínua à medida que as versões dos pacotes se acumulam.
O Artefactos do Azure inclui 2 GiB de armazenamento gratuito por organização. Depois de ultrapassares esse limite, não podes publicar novos artefactos até configurares a faturação e aumentares o limite de armazenamento.
Quanto tempo demora para o armazenamento faturado atualizar depois de apagar os pacotes?
Normalmente, o consumo de armazenamento deve ser atualizado dentro de 24 horas. No entanto, em alguns casos, pode levar até 48 horas para que as alterações sejam refletidas. O uso de Artefatos na página de faturamento da sua organização é atualizado uma vez por dia, enquanto a página Armazenamento de Artefatos é atualizada com mais frequência, o que pode levar a uma pequena discrepância entre os dois.