Principais conceitos do Azure Artifacts

Serviços Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts ajuda as equipes a hospedar, compartilhar e gerenciar pacotes para simplificar a colaboração e a distribuição de pacotes. Este artigo apresenta os principais conceitos que você precisa entender antes de publicar, consumir ou gerenciar pacotes com Azure Artifacts.

Feeds

Os feeds são constructos organizacionais que fornecem uma maneira estruturada de armazenar, gerenciar e compartilhar pacotes ao controlar o acesso. Um feed não se limita a um único tipo de pacote e pode hospedar vários tipos de pacote, como npm, NuGet, Maven, Python, Cargo e Pacotes Universais.

Você pode restringir os feeds a um projeto ou a uma organização. Somente feeds com escopo de projeto hospedados em um projeto público podem ser tornados públicos e você não pode converter feeds com escopo de organização em feeds com escopo de projeto. Para obter mais informações, consulte O que são feeds do Azure Artifacts? e Escopos dos feeds.

Modos de exibição de feed

As exibições de feed permitem compartilhar um subconjunto selecionado de versões do pacote com os consumidores. Um caso de uso comum é compartilhar apenas versões de pacotes testadas e validadas, mantendo retidas as versões que ainda estão em desenvolvimento ou que não atendem ao seu padrão de qualidade.

Cada feed inclui três exibições por padrão: @local, @prereleasee @release. Você pode renomear ou excluir os dois últimos, mas @local é o modo de exibição padrão e contém todos os pacotes publicados diretamente no feed, bem como todos os pacotes salvos de fontes upstream. Para obter mais informações, confira O que são exibições de feed?

Fontes primárias

As fontes upstream permitem armazenar pacotes de várias origens em um único feed. Isso inclui pacotes publicados diretamente e pacotes salvos de feeds externos ou registros públicos, como NuGet.org ou npmjs.com. Quando você habilita uma fonte upstream em seu feed, o Azure Artifacts salva automaticamente uma cópia de qualquer pacote instalado dessa fonte por um usuário com função Colaborador ou superior.

Para gerenciadores de pacotes públicos que dão suporte a vários feeds, como NuGet e Maven, a ordem na qual os feeds são consultados pode variar. Por exemplo, o NuGet envia consultas paralelas a todos os feeds configurados e usa a primeira resposta válida que recebe, o que pode levar a um comportamento não determinístico. As fontes upstream removem essa incerteza pesquisando o feed e suas fontes upstream em uma ordem fixa: pacotes publicados diretamente no feed, pacotes já salvos de uma fonte upstream e, por fim, pacotes disponíveis de cada fonte upstream, pesquisados na ordem em que aparecem na configuração do feed.

Funções e permissões

Você controla o acesso a um feed por meio de funções no feed, como Leitor, Colaborador, Contribuidor e Proprietário. Essas funções determinam quem pode exibir pacotes, salvar pacotes de fontes upstream, publicar novos pacotes e gerenciar configurações de feed. Para obter mais informações, consulte funções e permissões do Feed.

Imutabilidade

Depois de publicar uma versão específica de um pacote em um feed, esse número de versão será permanentemente reservado. Você não pode carregar uma revisão mais recente do pacote no mesmo número de versão e não pode excluí-lo e republicar um novo pacote com o mesmo número de versão.

Retenção e a Lixeira

Você pode excluir pacotes manualmente ou configurar políticas de retenção para que um feed remova automaticamente versões de pacote mais antigas e não modificadas à medida que novas são publicadas. Os pacotes excluídos são colocados na Lixeira e permanecem lá por 30 dias antes que Azure Artifacts os exclua permanentemente. Somente um proprietário do feed pode restaurar pacotes da Lixeira.

Você também deve ser proprietário do feed para excluí-lo. Os feeds excluídos permanecem na Lixeira por 30 dias antes de serem excluídos permanentemente e o nome do feed fica disponível para reutilização depois que isso acontece. Para obter mais informações, consulte Excluir e recuperar pacotes.

Indexação

Azure Artifacts mantém um índice de cada pacote em cada feed, o que permite operações de lista rápidas. Essa indexação difere dos compartilhamentos de arquivos, em que o cliente deve abrir cada pacote e examinar seus metadados, a menos que o compartilhamento de arquivos esteja configurado para fornecer um índice reconhecido pelo cliente.

Boa formação

Azure Artifacts valida todos os pacotes publicados para garantir sua integridade e correção, o que ajuda a impedir que pacotes inválidos entrem em seu ambiente de desenvolvimento. Se o fluxo de trabalho existente publicar pacotes malformados, revise-o antes de migrar para Azure Artifacts para que seus pacotes passem pela validação.

Símbolos

Os arquivos de símbolo mapeiam binários compilados de volta ao código-fonte para que você possa depurar executáveis nativos. Azure Artifacts fornece um servidor de símbolos dedicado em que você pode publicar e consumir arquivos de símbolo junto com seus pacotes. Para obter mais informações, consulte a visão geral dos símbolos.

Armazenamento e cobrança

O Azure Artifacts cobra pelo armazenamento por organização com base no tamanho total de todos os pacotes em todos os feeds. Você pode monitorar o consumo no nível da organização e definir alertas à medida que se aproxima dos limites de armazenamento. Para obter mais informações, consulte Monitorar o consumo de armazenamento do Azure Artifacts e Limites de tamanhos e contagens de pacotes.

Conteúdo relacionado

• Práticas recomendadas do Azure Artifacts

• O que são feeds do Azure Artifacts?

• O que são fontes upstream?