Publicar e baixar pacotes npm com o Artefactos do Azure

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

O Artefactos do Azure permite aos programadores publicar e descarregar pacotes npm a partir de feeds ou registos públicos.

Este artigo orienta-o na criação de um feed, configuração do seu 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. Introduza um Nome para o seu feed.

  4. Escolha uma definição de Visibilidade para controlar quem pode ver os pacotes no feed.

  5. Selecione Incluir pacotes de fontes públicas comuns se quiser que o seu feed utilize pacotes a montante de fontes como nuget.org ou npmjs.com.

  6. Em Âmbito, escolha se o feed se aplica ao projeto atual ou a toda a organização.

  7. Selecione Criar quando terminar.

    Captura de ecrã a mostrar seleções para criar um novo feed no Azure DevOps Services.

  1. Inicie sessão no seu servidor Azure DevOps e, em seguida, aceda ao seu projeto.

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

  3. Introduza um Nome para o seu feed.

  4. Escolha uma definição de Visibilidade para controlar quem pode ver os pacotes no feed.

  5. Selecione Incluir pacotes de fontes públicas comuns se quiser que o seu feed utilize pacotes a montante de fontes como nuget.org ou npmjs.com.

  6. Em Âmbito, escolha se o feed se aplica ao projeto atual ou a toda a organização.

  1. Selecione Criar quando terminar.

    Captura de ecrã a mostrar seleções para criar um novo feed no Azure DevOps 2022.

Nota

Quando cria um feed, a conta Build Service do projeto, como projectName Build Service (orgName), recebe, por predefinição, a função Leitor do Feed e a montante (Colaborador).

Configurar autenticação NPM

Antes de te ligares a um feed, configura a autenticação para o cliente npm na tua máquina. Os passos variam consoante o seu sistema operativo:

Windows

Instale vsts-npm-auth, que gera e atualiza as credenciais que o npm usa para se ligar ao seu feed do Artefactos do Azure.

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

macOS e Linux

vsts-npm-auth não é suportado no macOS nem no Linux. Em vez disso, crie um token de acesso pessoal (PAT) com o âmbito Pacotes>. Usa esse PAT quando configurares o teu ficheiro .npmrc ao nível do utilizador na secção seguinte.

Conectar-se a um feed

O Artefactos do Azure 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 suas credenciais com segurança. Isso permite que o cliente npm acesse suas credenciais para autenticação.

Ao usar esta configuração, pode partilhar a configuração do projeto com a sua equipa sem expor credenciais no controlo de versão. Para mais detalhes, veja Ligar a um feed do Artefactos do Azure - npm.

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

  2. Selecione Artefatos, selecione seu 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 Project, selecione Windows ou Outro para o seu sistema operativo e siga as instruções fornecidas para atualizar os ficheiros .npmrc ao nível do utilizador e do project.

    Captura de ecrã a mostrar como configurar um projeto npm e ligar-se a um feed no Azure DevOps Services.

Nota

O vsts-npm-auth não é suportado no Azure DevOps Server.

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

  2. Selecione Artefatos, selecione seu 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 Project, selecione Windows ou Outro para o seu sistema operativo e siga as instruções fornecidas para atualizar os ficheiros .npmrc ao nível do utilizador e do project.

    Captura de ecrã que mostra como configurar um projeto npm e ligar-se a um feed do Artefactos do Azure no Azure DevOps Server 2022.

Importante

O NPM suporta apenas uma registry definição no seu ficheiro .npmrc . Se precisar de pacotes de várias fontes, use fontes a montante ou escopos em vez de adicionar várias entradas registry.

Publicar pacotes na sua feed

Nota

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

Antes de publicar encomendas, certifique-se de autenticar com o seu feed. Se ainda não fizeste isto, segue os passos na secção Ligar a um feed e depois continua com as instruções na secção seguinte.

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

    npm publish

Importante

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

Restaurar pacotes a partir do seu feed

Antes de restaurar os pacotes, certifique-se de autenticar com o seu feed e atualizar os ficheiros .npmrc do seu projeto. Se ainda não fizeste isto, completa os passos em Ligar a um feed e depois continua.

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

    npm install

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

    npm install --save <PACKAGE_NAME>

Conteúdo relacionado

  • Last updated on