Publicar e baixar pacotes npm com o Azure Artifacts

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

Azure Artifacts permite que os desenvolvedores publiquem e baixem pacotes npm de feeds ou registros públicos.

Este artigo orienta você na criação de um feed, configuração do projeto e publicação e download de pacotes npm.

Pré-requisitos

Criar um feed

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

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

  3. Insira um nome para o feed.

  4. Escolha uma configuração de visibilidade para controlar quem pode exibir pacotes no feed.

  5. Selecione Incluir pacotes de fontes públicas comuns se quiser que o feed use pacotes upstream de fontes como nuget.org ou npmjs.com.

  6. Para Escopo, escolha se o feed está no escopo do projeto atual ou de toda a organização.

  7. Selecione Criar quando terminar.

    Captura de tela mostrando seleções para criar um novo feed no Azure DevOps Services.

  1. Entre no seu servidor Azure DevOps e depois vá para seu projeto.

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

  3. Insira um nome para o feed.

  4. Escolha uma configuração de visibilidade para controlar quem pode exibir pacotes no feed.

  5. Selecione Incluir pacotes de fontes públicas comuns se quiser que o feed use pacotes upstream de fontes como nuget.org ou npmjs.com.

  6. Para Escopo, escolha se o feed está no escopo do projeto atual ou de toda a organização.

  1. Selecione Criar quando terminar.

    Captura de tela mostrando seleções para criar um novo feed no Azure DevOps 2022.

Observação

Quando você cria um feed, a conta do projeto Serviço de Compilação, como projectName Build Service (orgName), recebe por padrão a função de Leitor de Feed e Upstream (Colaborador).

Configurar a autenticação npm

Antes de se conectar a um feed, configure a autenticação para o cliente npm em seu computador. As etapas diferem dependendo do sistema operacional:

Windows

Instalevsts-npm-auth, que gera e atualiza as credenciais que o npm usa para se conectar ao feed de Azure Artifacts.

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

macOS e Linux

vsts-npm-auth não há suporte para macOS ou Linux. Em vez disso, crie um token de acesso pessoal (PAT) com o escopo Packaging>. Use esse PAT ao configurar o arquivo .npmrc no nível do usuário na próxima seção.

Conectar-se a um feed

O Azure Artifacts recomenda o uso de dois arquivos de configuração separados. O primeiro deve ser mantido localmente no diretório $HOME (Linux/macOS) ou $env. HOME (Windows) para armazenar com segurança suas credenciais. Isso permite que o cliente npm acesse suas credenciais para autenticação.

Usando essa configuração, você pode compartilhar a configuração do projeto com sua equipe sem expor credenciais no controle do código-fonte. Para obter mais detalhes, consulte Conectar-se a um feed de Azure Artifacts – npm.

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

  2. Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.

  3. Selecione npm no painel de navegação esquerdo.

  4. Em Configuração do projeto, selecione Windows ou Outro para o seu sistema operacional e, em seguida, siga as instruções fornecidas para atualizar seus arquivos .npmrc no nível do usuário e no nível do projeto.

    Captura de tela mostrando como configurar um projeto npm e se conectar a um feed no Azure DevOps Services.

Observação

O vsts-npm-auth não é compatível com o Azure DevOps Server.

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

  2. Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.

  3. Selecione npm no painel de navegação esquerdo.

  4. Em Configuração do projeto, selecione Windows ou Outro para o seu sistema operacional e, então, siga as instruções fornecidas para atualizar seus arquivos .npmrc no nível do usuário e no nível do projeto.

    Captura de tela mostrando como configurar um projeto npm e se conectar a um feed de Azure Artifacts no Azure DevOps Server 2022.

Importante

O npm dá suporte apenas a uma única registry configuração no arquivo .npmrc . Se você precisar de pacotes de várias fontes, use fontes upstream ou escopos em vez de adicionar várias entradas registry.

Publicar pacotes em seu feed

Observação

Para publicar pacotes em um feed, você deve ser um Editor de Feed (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Antes de publicar pacotes, certifique-se de se autenticar com o feed. Se você ainda não fez isso, siga as etapas na seção Conectar a um feed e continue com as instruções na seção a seguir.

  1. No diretório do projeto, execute o seguinte comando para publicar o pacote definido em seu package.json arquivo no feed:

    npm publish

Importante

Não há suporte para o uso da propriedade publishConfig para substituir a configuração do Registro no momento da publicação.

Restaurar pacotes do seu feed

Antes de restaurar pacotes, certifique-se de autenticar com o feed e atualizar os arquivos .npmrc para seu projeto. Se você ainda não fez isso, conclua as etapas em Conectar-se a um feed e continue.

  1. No diretório do projeto, execute o seguinte comando para restaurar todos os pacotes listados em seu package.json arquivo:

    npm install

  2. Para instalar um pacote específico do feed e adicioná-lo como uma dependência em seu package.json arquivo, execute o seguinte comando:

    npm install --save <PACKAGE_NAME>

Conteúdo relacionado

  • Last updated on