Usar pacotes do repositório npm

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

As fontes upstream do Azure Artifacts permitem que os desenvolvedores consumam pacotes de registros públicos, como npmjs.com. Depois que as fontes upstream estiverem habilitadas no feed, o Azure Artifacts salvará automaticamente uma cópia de qualquer pacote instalado de uma fonte upstream no feed. Essa configuração oferece a maior flexibilidade, permitindo que você use uma combinação de pacotes com escopo e sem escopo, incluindo os de registros públicos, tudo em um único feed. Essa configuração também garante o acesso contínuo a esses pacotes mesmo que a fonte upstream fique temporariamente indisponível.

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização do Azure DevOps.
- Um projeto do Azure DevOps .
– Baixar e instalar Node.js e npm.

Obter as ferramentas

Se esta for a primeira vez que você usa o Azure Artifacts com o npm em seu computador, siga as etapas abaixo para configurar seu ambiente:

Verifique se você instalou Node.js e npm e execute o seguinte comando para instalar vsts-npm-auth:

npm install -g vsts-npm-auth --registry https://registry.npmjs.com

Criar um feed

Se você já tiver um feed do Azure Artifacts, vá para a próxima seção. Caso contrário, crie um novo da seguinte maneira:

  1. Entre no Azure DevOps e navegue até o projeto.

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

  3. Insira um nome para o feed, defina a Visibilidade para definir quem pode exibir seus pacotes e escolha o Escopo do feed. Certifique-se de marcar a caixa Incluir pacotes de origens públicas comuns para habilitar as origens de upstreaming e permitir o consumo de pacotes direto de repositórios públicos.

  4. Selecione Criar quando terminar.

Adicionar npmjs upstream

Se você tiver marcado a caixa de seleção de fontes upstream durante a criação do feed, npmjs será adicionado automaticamente à lista de fontes upstream no feed. Caso contrário, você pode adicioná-lo manualmente da seguinte maneira:

  1. Entre no Azure DevOps e navegue até o projeto.

  2. Selecione Artefatos e depois selecione o feed no menu suspenso.

  3. Selecione o ícone de engrenagem para abrir configurações do Feed.

  4. Selecione fontes upstream e, em seguida, selecione Adicionar Upstream.

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

  6. Selecione Adicionar, quando terminar.

  7. Selecione Salvar no canto superior direito para aplicar suas alterações.

Conectar-se a um feed

Antes de começar a salvar pacotes de origens de upstreaming no feed, primeiro você deve configurar seu projeto e conectar-se ao feed.

  1. Entre no Azure DevOps e navegue até o projeto.

  2. Selecione Artefatos e depois selecione o feed no menu suspenso.

  3. Selecione Conectar ao Feed e, em seguida, selecione npm no painel esquerdo.

  4. Siga as etapas na seção de instalação do Project para configurar o arquivo .npmrc e autenticar-se com o feed. Consulte configurar seu projeto npm para obter detalhes.

Instalar pacotes do npmjs

Agora que você se autenticou com o feed, pode começar a instalar pacotes de repositórios públicos, como npmjs.com. Quando você instala um pacote de uma fonte upstream, o Azure Artifacts salva automaticamente uma cópia desse pacote no feed. Neste exemplo, você instalará o Mongoose, uma biblioteca ODM (Object Data Modeling) do MongoDB que ajuda na definição de esquema, validação de dados e modelagem de objetos em aplicativos Node.js.

Observação

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

  1. Acesse https://www.npmjs.com.

  2. Pesquise pelo pacote Mongoose 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 do prompt de comando, navegue até o diretório do projeto e execute o comando de instalação.

    npm i mongoose
    

Exibir pacotes salvos

Agora que você instalou um pacote do registro npm, você pode ver como o Azure Artifacts salva automaticamente uma cópia desse pacote no feed. Siga estas etapas para confirmar se o pacote foi adicionado ao feed:

  1. Entre no Azure DevOps e navegue até o projeto.

  2. Selecione Artefatos e depois selecione o feed no menu suspenso.

  3. No menu Origem no canto superior direito, selecione npmjs para filtrar pacotes do registro npm.

  4. O pacote mongoose instalado na etapa anterior agora deve aparecer no feed. O Azure Artifacts salvou uma cópia automaticamente quando você executou o comando de instalação.

    Captura de tela mostrando o novo pacote do Mongoose que foi salvo do registro npm público.