Compartilhar via


Usar pacotes de npmjs.com

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

O cliente npm foi projetado para funcionar com um registro principal (conhecido como feed no Azure Artifacts) por vez. No entanto, ele dá suporte a registros com escopo adicional. Se você planeja usar pacotes privados e públicos do npmjs.com, é recomendável usar fontes upstream. Depois de habilitar 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 do Azure Artifacts.

  • Baixe 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 de fontes upstream para ativá-los. Se você já tiver um feed, prossiga para a próxima etapa para adicionar npmjs como uma fonte upstream.

  1. Entre na 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 de fontes upstream durante a criação do seu feed, o npmjs deve ter sido adicionado automaticamente. Caso contrário, você pode adicioná-lo manualmente da seguinte maneira:

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

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

  3. Selecione o botão ícone de engrenagem ícone de engrenagem do ícone de engrenagem para navegar até as configurações do 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 Adicionar quando terminar e, em seguida, selecione Salvar no canto superior direito para salvar suas 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 de instalação 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 de instalação.

    npm install axios
    

Observação

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

Exibir pacotes salvos

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

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

  3. Selecione npmjs no menu de origem. O pacote Axios que instalamos anteriormente agora está disponível em nosso feed. O Azure Artifacts salvou automaticamente uma cópia em nosso feed ao executar o comando de instalação.

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