Use pacotes de npmjs.com

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

O cliente npm foi projetado para trabalhar com um registro principal (conhecido como um feed nos Artefatos do Azure) de cada vez. No entanto, suporta registos com âmbito adicional. Se você planeja usar pacotes privados e públicos do npmjs.com, é recomendável usar fontes upstream. Depois de habilitar as fontes upstream em seu feed, o Azure Artifacts salva automaticamente uma cópia de qualquer pacote instalado em seu feed. Isso oferece a maior flexibilidade, permitindo que você use uma combinação de pacotes com e sem escopo em seu feed, incluindo pacotes com e sem escopo do npmjs.com.

Pré-requisitos

  • Uma organização e um projeto do Azure DevOps. Crie uma organização e um projeto , caso ainda não o tenha feito.

  • Um feed de Artefatos do Azure.

  • Baixar Node.js e npm.

Habilitar fontes upstream

Se você ainda não criou um feed, siga estas etapas para criar um novo e certifique-se de marcar a caixa de seleção fontes upstream para habilitá-los. Se você já tiver um feed, prossiga para a próxima etapa para adicionar npmjs como uma fonte upstream.

  1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione Criar feed.

  3. Forneça um Nome descritivo para seu feed, defina sua Visibilidade e Escopo. Marque a caixa de seleção Fontes upstream para incluir pacotes de registros públicos.

  4. Selecione Criar quando terminar.

Adicionar npmjs upstream

Se você marcou a caixa de seleção fontes upstream durante a criação do seu feed, o npmjs deve ter sido adicionado automaticamente. Caso contrário, pode adicioná-lo manualmente da seguinte forma:

  1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione seu feed.

  3. Selecione o botão ícone de engrenagem do ícone de engrenagem para navegar até Configurações de feed.

  4. Selecione Fontes Upstream e, em seguida, selecione Adicionar Upstream.

  5. Selecione Fonte pública e, em seguida, selecione npmjs (https://registry.npmjs.org/) no menu suspenso.

  6. Selecione Guardar quando terminar e, em seguida, selecione Guardar no canto superior direito para guardar as alterações.

Instalar pacotes do npmjs

Antes de salvar pacotes do npmjs, verifique se o projeto está configurado para se conectar ao feed. Se você ainda não fez isso, siga as instruções fornecidas para configurar seu projeto npm e conectar-se ao seu feed. Neste exemplo, instalaremos a biblioteca Axios para fazer solicitações HTTP:

  1. Navegue até npmjs em https://www.npmjs.com//.

  2. Procure o pacote Axios e selecione-o para navegar até a página de detalhes.

  3. Copie o comando install para a área de transferência.

  4. Em uma janela de prompt de comando, navegue até o diretório do projeto e execute o comando install.

    npm install axios
    

Nota

Para salvar pacotes de upstreams, você deve ter a função Feed e Upstream Reader (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Ver pacotes guardados

  1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.

  3. Selecione npmjs no menu de origem. O pacote Axios que instalamos anteriormente agora está disponível em nosso feed. Os Artefatos do Azure salvaram automaticamente uma cópia em nosso feed ao executar o comando install.

    Uma captura de tela mostrando o pacote axios que foi salvo do upstream.