Compartilhar via


Usar pacotes do repositório npm

Azure DevOps Services | 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 --always-auth false

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 repositórios públicos comuns para habilitar fontes ascendentes e permitir o consumo de pacotes 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, em seguida, selecione seu 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 Public source 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 fontes upstream 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, em seguida, selecione 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 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. Ir para 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, em seguida, selecione 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 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.

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