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

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

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

• Um feed de Artefatos do Azure. Crie um gratuitamente.

• Baixe e instale o Node.js e o npm.

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:

Windows

1. Entre em 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 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.

   

Outro

1. Adicione um arquivo .npmrc no diretório do seu projeto, no mesmo diretório que o arquivo package.json , e cole o seguinte trecho nele.

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Credenciais de configuração

1. Copie o seguinte trecho e cole-o em seu arquivo npmrc de nível de usuário:

   • Feed com escopo da organização:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Feed com escopo do projeto:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

2. Gere um token de acesso pessoal com escopos de leitura e gravação de empacotamento.

3. Execute o seguinte comando em uma janela de prompt de comando e cole seu token de acesso pessoal quando solicitado. Uma vez feito, copie o valor codificado Base 64 gerado.

   node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
   

4. Se você estiver no Linux/Mac, você pode alternativamente usar o seguinte comando para converter seu token de acesso pessoal para a Base 64. Copie o valor codificado Base64 resultante.

   echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
   

5. Substitua os espaços reservados [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] no arquivo .npmrc do usuário pelo token de acesso pessoal codificado obtido na etapa anterior.

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.

Clássico

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.

   

4. Procure a tarefa npm Authenticate e selecione Adicionar.

   

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

   

YAML

- task: npmAuthenticate@0
  inputs:
    workingFile: .npmrc                ## Path to the npmrc file
    customEndpoint: #Optional          ## Comma-separated list of npm service connection names for registries from external organizations. For registries in your org, leave this blank

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.

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.

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.

Artigos relacionados

• Publicar e restaurar pacotes npm (CLI)
• Publicar pacotes npm (YAML/Classic)
• Use pacotes de npmjs.com