Partilhar via


Conectar seu projeto npm ao Azure Artifacts

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

Os Artefatos do Azure permitem que os desenvolvedores gerenciem seus pacotes de várias fontes, incluindo registros públicos, como feeds npmjs.com e privados. Para autenticar com o Azure Artifacts, você precisará configurar seu arquivo de configuração npm. Esse arquivo contém URLs de feed e credenciais usadas pelo npm, oferecendo opções para personalizar o comportamento do cliente npm, como configurar proxies, definir locais de pacotes padrão ou configurar feeds de pacotes privados. O arquivo .npmrc normalmente está localizado no diretório base do usuário, mas também pode ser criado no nível do projeto para substituir as configurações padrão.

Pré-requisitos

Conectar-se ao Feed

O Azure Artifacts recomenda o uso de dois arquivos de configuração separados. O primeiro é dedicado à autenticação com Artefatos do Azure, enquanto o segundo deve ser mantido localmente para armazenar suas credenciais. Essa abordagem permite que você compartilhe seu arquivo de configuração enquanto mantém suas credenciais seguras.

Para configurar o segundo arquivo, basta colocá-lo em seu diretório pessoal em sua máquina de desenvolvimento e incluir todas as suas credenciais de registro. Isso permite que o cliente npm acesse facilmente suas credenciais para autenticação.

As etapas a seguir irão guiá-lo através da configuração do primeiro arquivo de configuração:

Nota

vsts-npm-auth não tem suporte no Servidor de DevOps do Azure.

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

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

    Uma captura de tela mostrando como se conectar a um feed nos Serviços de DevOps do Azure.

  3. Selecione npm na barra lateral esquerda. Se esta for a primeira vez usando Artefatos do Azure com npm, certifique-se de ter instalado os pré-requisitos.

  4. Siga as instruções na seção Configuração do projeto para se conectar ao seu feed.

    Uma captura de tela mostrando como configurar seu projeto npm.

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

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

    Uma captura de tela mostrando como se conectar a um feed no Azure DevOps Server 2022.1.

  3. Selecione npm na barra lateral esquerda e siga as instruções na seção Configuração do projeto para configurar seu arquivo de configuração.

    Uma captura de tela mostrando como configurar seu projeto npm no Azure DevOps Server 2022.1.

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

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

    Uma captura de tela mostrando como se conectar a um feed no Azure DevOps Server 2020.1.

  3. Selecione npm à esquerda e siga as instruções na configuração do Project para configurar seu arquivo de configuração.

    Uma captura de tela mostrando como configurar seu projeto npm no Azure DevOps Server 2020.1.

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

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

    Uma captura de tela mostrando como se conectar a um feed no Azure DevOps Server 2019.1.

  3. Aparecerá uma nova janela. No painel de navegação esquerdo, selecione npm.

  4. Siga as instruções fornecidas para configurar seus arquivos .npmrc de projeto e usuário .

    Uma captura de tela mostrando como configurar seus arquivos npmrc no nível do projeto e no nível do usuário no Azure DevOps Server 2019.1.

Gorjeta

O uso de vários registros em arquivos .npmrc é suportado com escopos e fontes upstream.

Autenticação de pipeline

Para autenticar com seu pipeline, o Azure Artifacts recomenda usar a tarefa npm authenticate.

Ao usar executores de tarefas como gulp ou Grunt, é priorizar a configuração da tarefa npm authenticate no início do pipeline. Esta etapa garante que suas credenciais sejam injetadas no arquivo .npmrc do projeto e mantidas durante toda a execução do pipeline, permitindo que as etapas subsequentes acessem as credenciais no arquivo de configuração.

  1. Navegue até o projeto, selecione Pipelines e, em seguida, selecione a definição do pipeline.

  2. Selecione Editar para modificar seu pipeline.

  3. Selecione + esta opção para adicionar uma nova tarefa ao seu pipeline.

    Captura de tela mostrando como adicionar a tarefa npm authenticate ao seu pipeline.

  1. Navegue até seu projeto, selecione Pipelines Builds e, em seguida, selecione sua definição de>compilação.

  2. Selecione Editar para modificar seu pipeline de compilação.

  3. Selecione + esta opção para adicionar uma nova tarefa ao seu pipeline de compilação.

    Captura de tela mostrando como adicionar a tarefa npm authenticate ao seu pipeline.

  1. Procure a tarefa npm Authenticate e selecione Adicionar.

    Captura de tela mostrando a tarefa de autenticação npm adicionada ao pipeline.

  2. Selecione o arquivo .npmrc e, em seguida, selecione Salvar fila & quando terminar.

    Captura de ecrã a mostrar como adicionar o seu ficheiro *.npmrc*.

Nota

Para acessar seu feed a partir do pipeline, verifique se a função de serviço de compilação está definida como Feed And Upstream Reader (Colaborador) em suas Permissões de configurações>de feed.

Uma captura de tela mostrando as funções de serviço de compilação nas configurações de feed.

Nota

Se sua organização estiver usando um firewall ou um servidor proxy, certifique-se de permitir as URLs de domínio apropriadas. Consulte Endereços IP permitidos e URLs de domínio para obter detalhes.

Resolver problemas

vsts-npm-auth não é reconhecido

Este erro indica que a pasta npm modules não foi adicionada ao seu caminho. Execute novamente a configuração do Node.js e certifique-se de selecionar a Add to PATH opção. Como alternativa, você pode adicionar a pasta npm modules ao seu caminho modificando a variável PATH para %APPDATA%\npm no Prompt de Comando ou $env:APPDATA\npm no PowerShell.

Uma captura de tela mostrando como configurar o node.js.

Não é possível autenticar

  • Erro: código E401 npm ERR! Não é possível autenticar: -> Execute o vsts-npm-auth comando com o sinalizador -F para autenticar novamente:

    vsts-npm-auth -config .npmrc -F
    

Redefinir vsts-npm-auth

Siga estas etapas para redefinir suas credenciais vsts-npm-auth:

  1. Desinstalar vsts-npm-auth:

    npm uninstall -g vsts-npm-auth
    
  2. Limpe o cache do npm:

    npm cache clean --force
    
  3. Exclua seu arquivo .npmrc .

  4. Reinstale o vsts-npm-auth:

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

Não é possível publicar

Se você encontrar um erro 403, isso pode indicar um conflito de nome. Nos Artefatos do Azure, os pacotes são imutáveis, o que significa que, depois que você publica um pacote em seu feed, seu número de versão é reservado permanentemente. Mesmo que você o exclua, não poderá publicar um novo pacote com o mesmo número de versão. Para resolver esse problema, atualize a versão do pacote no arquivo package.json e tente novamente.