Introdução aos pacotes npm no Azure Artifacts

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

Usando os Artefatos do Azure, você pode publicar e baixar seus pacotes npm de feeds e registros públicos, como npmjs.com. Este guia de início rápido o guiará na criação de seu feed, na configuração de seu projeto e no gerenciamento de pacotes npm com seu feed de Artefatos do Azure.

Pré-requisitos

• Uma organização do Azure DevOps. Crie um gratuitamente.

• Um projeto do Azure DevOps. Crie um novo projeto se você ainda não tiver um.

• Baixe e instale Node.js e npm.

Criar um feed

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

2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Códigos-fonte upstream.

4. Selecione Criar quando terminar.

   

Observação

Por padrão, os feeds recém-criados têm o 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 tem suporte no Servidor de DevOps do Azure.

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, vamos configurar o segundo arquivo .npmrc , que deve ser colocado no mesmo diretório que seu arquivo package.json .

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

2. Selecione Artefatos e, em seguida, selecione Conectar ao feed.

3. Selecione npm na área de navegação à esquerda. Se esta for sua primeira vez usando o Azure Artifacts com npm, verifique se você instalou os pré-requisitos.

4. Siga as instruções na seção Configuração do projeto para configurar o arquivo de configuração e conectar-se ao feed.

   

Importante

O npm suporta um único registry no 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 em tempo de 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>

Artigos relacionados

• Publicar pacotes npm (YAML/Clássico)
• Usar pacotes do npmjs.com
• Usar escopos npm