Ajude a moldar o futuro da entrega de software e manifeste-se respondendo à pesquisa sobre o estado de DevOps 2202.

Como trabalhar com pacotes Node.js

O Artifact Registry é compatível com pacotes Node.js que você gerencia com o npm.

Visão geral

Para se familiarizar com os pacotes do Node.js no Artifact Registry, consulte o guia de início rápido.

Quando estiver pronto para saber mais, leia as seguintes informações:

  1. Se você é novo no npm, leia sobre os seguintes conceitos:
  2. Crie um repositório de pacotes Node.js para seus pacotes.
  3. Conceda permissões à conta que será conectada ao repositório. As contas de serviço para integrações comuns com o Artifact Registry têm permissões padrão para repositórios no mesmo projeto.
  4. Configure o npm para autenticar com o repositório.
  5. Saiba mais sobre o gerenciamento de pacotes.

Como usar escopos

Um escopo npm é um rótulo para agrupar pacotes. Os escopos são necessários quando você trabalha com vários registros npm, incluindo:

  • Publicar e instalar pacotes em registros diferentes sem a necessidade de alternar de um registro para outro. Por exemplo, suas versões podem incluir pacotes do registro npm público e de um repositório do Artifact Registry.
  • Publicar os mesmos pacotes em vários repositórios do Artifact Registry nos projetos do Google Cloud, bem como em outros registros npm, sem conflitos de nome de pacote.

É recomendável sempre definir um escopo para os repositórios. Se você não especificar um escopo ao publicar ou instalar um pacote, o npm usará o registro padrão configurado, como o registro npm público.

Você define o escopo para cada repositório do Artifact Registry no arquivo de configuração .npmrc. As mesmas credenciais para autenticação se aplicam a todos os repositórios.

O exemplo a seguir mostra a configuração de dois repositórios do Artifact Registry em diferentes projetos.

  • O escopo @blue é para o repositório no projeto blue-project.
  • O escopo @green é para o repositório no projeto green-project.
@blue:registry=https://us-central1-npm.pkg.dev/blue-project/blue-npm-repo/
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:always-auth=true

@green:registry=https://us-central1-npm.pkg.dev/green-project/green-npm-repo/
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:always-auth=true

Depois de autenticar-se no Artifact Registry, você pode fazer upload de um pacote para um repositório específico usando o escopo apropriado. Por exemplo, o comando a seguir faz upload de um pacote para blue-npm-repo no projeto blue-project:

npm publish @blue/blue-npm-repo

Para mais informações sobre escopos, consulte a documentação do NPM

Armazene as credenciais

As configurações usadas para autenticação são armazenadas nos arquivos de configuração do NPM. Esses arquivos são denominados .npmrc. As configurações a seguir são usadas para o Artifact Registry.

  • Credenciais do registro npm público

    Armazene suas credenciais para o registro npm público (https://registry.npmjs.org/) no arquivo de configuração por usuário para que não fiquem disponíveis a outros usuários. Esse arquivo fica localizado no diretório inicial do usuário ou é definido com o parâmetro npm --userconfig ou a variável de ambiente $NPM_CONFIG_USERCONFIG. As ferramentas do Artifact Registry para autenticação com os repositórios do Artifact Registry estão localizadas no registro npm público.

  • Configurações para se conectar a repositórios do Artifact Registry

    É possível armazenar as configurações do repositório do Artifact Registry em um destes arquivos de configuração npm:

    • O arquivo de configuração por projeto. Esse arquivo .npmrc geralmente está no mesmo diretório que o arquivo package.json do projeto npm. Essa é a opção mais simples.

    • O arquivo de configuração por usuário. Esse arquivo está localizado no diretório inicial do usuário ou é definido com o parâmetro npm --userconfig ou a variável de ambiente $NPM_CONFIG_USERCONFIG.

    • O arquivo de configuração global, $PREFIX/etc/npmrc. Para receber o valor de $PREFIX, execute o comando npm prefix -g.

Mantenha qualquer registro padrão atual configurado no arquivo .npmrc. O padrão é normalmente definido para o registro npm público em https://registry.npmjs.org/.

Para verificar o valor do registro padrão atual, execute o comando:

npm get registry

Para mais informações sobre os arquivos de configuração do NPM, consulte a documentação do arquivo de configuração do npm.