Introdução aos pacotes npm no Azure Artifacts
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Usando o Azure Artifacts, você pode publicar e baixar seus pacotes npm de feeds e registros públicos, como npmjs.com. Este guia de início rápido orientará você na criação do feed, na configuração do projeto e no gerenciamento de pacotes npm com o feed do Azure Artifacts.
Pré-requisitos
Uma organização do Azure DevOps. Crie um gratuitamente.
Um projeto do Azure DevOps. Crie um projeto se ainda não tiver um.
Criar um feed
Entre na sua organização do Azure DevOps e vá para o projeto.
Selecione Artefatos e, em seguida, selecione Criar Feed.
Em Nome, insira um nome descritivo para seu feed.
Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.
Se você quiser incluir pacotes de fontes públicas, marque a caixa de seleção em Fontes upstream.
Em Escopo, especifique se o escopo do feed é o projeto ou a organização.
Selecione Criar quando terminar.
Entre no servidor Azure DevOps e vá para o projeto.
Selecione Artefatos e, em seguida, selecione Criar Feed.
Em Nome, insira um nome descritivo para seu feed.
Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.
Se você quiser incluir pacotes de fontes públicas, marque a caixa de seleção em Fontes upstream.
Em Escopo, especifique se o escopo do feed é o projeto ou a organização.
Selecione Criar quando terminar.
Selecione Criar quando terminar.
Entre no servidor Azure DevOps e vá para o projeto.
Selecione Artefatos e, em seguida, selecione Novo feed.
Em Nome, insira um nome descritivo para seu feed.
Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.
Se você quiser incluir pacotes de fontes públicas, selecione a opção Usar pacotes de fontes públicas por meio deste feed .
Selecione Criar quando terminar.
Observação
Por padrão, os feeds recém-criados têm o valor do Serviço de Compilação do projeto definido como Feed e Leitor Upstream (Colaborador).
Conectar-se a um feed
Observação
vsts-npm-auth não há suporte em Azure DevOps Server.
O Azure Artifacts recomenda o uso de dois arquivos .npmrc. O primeiro deve ser colocado no diretório $home (Linux/macOS) ou $env. HOME (Windows) para armazenar suas credenciais com segurança. Isso permite que o cliente npm localize o arquivo e recupere suas credenciais para autenticação, permitindo que você compartilhe seu arquivo de configuração sem expor suas credenciais. Nesta seção, configuraremos o segundo arquivo .npmrc , que deve ser colocado no mesmo diretório do seu arquivo package.json .
Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Conectar ao feed.
Selecione npm na área de navegação à esquerda. Se esta for a primeira vez que você usa o Azure Artifacts com o npm, verifique se você instalou os pré-requisitos.
Siga as instruções na seção Configuração do projeto para configurar seu arquivo de configuração e conectar-se ao seu feed.
Entre na sua coleção do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Conectar ao Feed.
Selecione npm à esquerda e siga as instruções na seção Configuração do projeto para se conectar ao seu feed.
Entre na sua coleção do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Conectar ao feed.
Selecione npm à esquerda e siga as instruções em Configuração do projeto para configurar o arquivo de configuração e conectar-se ao feed.
Entre na sua coleção do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Conectar ao feed.
Uma nova janela será exibida. No painel de navegação esquerdo, selecione npm e siga as instruções para configurar o projeto e os arquivos .npmrc do usuário.
Importante
O npm dá suporte a um single registry em seu arquivo .npmrc. Vários registros são possíveis com escopos e fontes upstream.
Publicar pacotes
Execute o seguinte comando no diretório do projeto para publicar seus pacotes npm:
npm publish
Importante
Não há suporte para o uso da publishConfig propriedade para substituir o parâmetro de configuração do Registro no momento da publicação.
Restaurar pacotes
Execute o seguinte comando no diretório do projeto para restaurar os pacotes npm:
npm install
Para restaurar um pacote npm específico, execute o seguinte comando no diretório do projeto:
npm install --save <PACKAGE_NAME>