Partilhar via


Usar pacotes do repositório npm

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

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

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização Azure DevOps .
- Um projeto do Azure DevOps .
- Baixe e instale Node.js e npm.

Obtenha as ferramentas

Se esta for a primeira vez que você usa Artefatos do Azure com npm em sua máquina, siga as etapas abaixo para configurar seu ambiente:

Certifique-se de que instalou o Node.js e o npm e, em seguida, execute o seguinte comando para instalar vsts-npm-auth:

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

Criar um feed

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

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

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

  3. Insira um Nome para seu feed, defina a Visibilidade para definir quem pode visualizar seus pacotes e escolha o Escopo do feed. Certifique-se de marcar a caixa Incluir pacotes de fontes públicas comuns para ativar fontes upstream e permitir a utilização de pacotes de registos 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 será adicionado automaticamente à lista de fontes upstream no seu feed. Caso contrário, pode adicioná-lo manualmente da seguinte forma:

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

  2. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.

  3. Selecione o ícone de engrenagem do botão ícone de engrenagem para abrir Definiçõ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 Adicionar quando terminar.

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

Conectar-se a um feed

Antes de começar a salvar pacotes de fontes upstream para seu feed, você deve primeiro configurar seu projeto e conectar-se ao seu feed.

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

  2. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.

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

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

Instalar pacotes do npmjs

Agora que você se autenticou com seu feed, pode começar a instalar pacotes de registros públicos, como npmjs.com. Quando você instala um pacote de uma fonte upstream, o Azure Artifacts salva automaticamente uma cópia desse pacote em seu 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.

Nota

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

  1. Aceda a https://www.npmjs.com.

  2. Procure o pacote Mongoose 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 i mongoose
    

Ver pacotes guardados

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

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

  2. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.

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

  4. O pacote mongoose que você instalou na etapa anterior agora deve aparecer no seu feed. Os Artefatos do Azure salvaram uma cópia automaticamente quando você executou o comando install.

    Uma captura de tela exibindo o novo pacote Mongoose que foi salvo do registro npm público.