Introdução aos pacotes npm nos Artefatos do Azure

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

Usando o Azure Artifacts, você pode publicar e baixar pacotes npm de feeds e registros públicos como npmjs.com. Este guia de início rápido orientará você pelo processo de criação de seu feed, configuração de seu projeto e publicação e download de pacotes npm de e para seu feed de Artefatos do Azure.

Criar um feed

Um feed é uma construção organizacional que permite aos usuários armazenar seus pacotes e controlar quem pode acessá-los. Os Artefatos do Azure dão suporte ao armazenamento de vários tipos de pacote em um único feed, como NuGet, npm, Maven, Python, Cargo e pacotes Universal.

1. Entre em 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 visualizar os 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 Fontes upstream.

4. Selecione Criar quando terminar.

   

Nota

Por padrão, os feeds recém-criados têm o Serviço de Criação do projeto definido como Feed e Leitor Upstream (Colaborador).

Configure seus arquivos .npmrc

Nota

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

Recomendamos o uso de dois arquivos .npmrc. O primeiro deve estar localizado no mesmo diretório que o seu arquivo package.json. O segundo deve ser colocado no diretório $home (Linux/macOS) ou $env. HOME (Windows) para armazenar suas credenciais com segurança. O cliente npm poderá então procurar esse arquivo e buscar suas credenciais para autenticação. Isso permite que você compartilhe seu arquivo de configuração enquanto mantém suas credenciais seguras.

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 no painel de navegação esquerdo. Se esta for a primeira vez que você usa Artefatos do Azure com npm, selecione Obter as ferramentas e siga as etapas para baixar Node.js e configurar sua máquina.

4. Insira o seguinte trecho no arquivo .npmrc, aquele localizado no mesmo diretório do arquivo package.json. Substitua os espaços reservados pelos valores apropriados.

   • Feed com escopo da organização:

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

   • Feed com escopo do projeto:

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

Credenciais de configuração

Importante

O npm suporta um único registry em seu arquivo .npmrc. Vários registros são possíveis com escopos e fontes a montante.

Windows

Se você estiver desenvolvendo no Windows, recomendamos usar vsts-npm-auth para autenticar com Artefatos do Azure. Certifique-se de que tem o vsts-npm-auth instalado a partir de Obter as ferramentas e, em seguida, execute vsts-npm-auth para obter um token de Artefactos do Azure adicionado ao seu ficheiro npmrc ao nível do utilizador:

vsts-npm-auth -config .npmrc

Outro

Se você estiver desenvolvendo em uma plataforma que não seja Windows e precisar se autenticar com o Azure Artifacts, precisará criar um token de acesso pessoal, codificá-lo na Base 64 e adicioná-lo ao seu arquivo npmrc no nível do usuário.

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

2. Codifique seu token de acesso pessoal recém-gerado da seguinte maneira:

   1. Execute o seguinte comando em uma janela de prompt de comando para codificar seu PAT:

      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(); })"
      

   2. Cole o seu token de acesso pessoal e, em seguida, prima Enter.

   3. Copie o token de acesso pessoal codificado Base 64.

3. Copie o seguinte trecho de código para o arquivo .npmrc de nível de usuário e substitua o espaço reservado [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] pelo token de acesso pessoal Base 64:

   • 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
     

---

Publicar pacotes

Para publicar o pacote npm, execute o seguinte comando no diretório do projeto:

npm publish

Importante

Não há suporte para o uso da publishConfig propriedade para substituir o param de configuração do Registro em tempo de publicação.

Restaurar pacotes

Para restaurar um pacote npm, execute o seguinte comando no diretório do projeto:

npm install --save <package>

Para restaurar todos os seus pacotes npm, execute o seguinte comando no diretório do projeto:

npm install

Artigos relacionados

• Publicar pacotes npm (YAML/Classic)
• Use pacotes de npmjs.com
• Usar escopos npm