Faça a gestão de pacotes Node.js

O Artifact Registry suporta pacotes Node.js que gere com o npm.

Vista geral

Para se familiarizar com os pacotes Node.js no Artifact Registry, pode experimentar o início rápido.

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

  1. Se não tiver experiência com o npm, leia acerca dos seguintes conceitos:
  2. Crie um repositório de pacotes Node.js para os seus pacotes.
  3. Conceda autorizações à conta que vai associar-se ao repositório. As contas de serviço para integrações comuns com o Artifact Registry têm autorizações predefinidas para repositórios no mesmo projeto.
  4. Configure as suas ferramentas:
  5. Saiba como gerir pacotes.

Usar âmbitos

Um âmbito do npm é uma etiqueta para agrupar pacotes. Os âmbitos são necessários quando está a trabalhar com vários registos npm, incluindo:

  • Publicar e instalar pacotes em diferentes registos sem ter de alternar entre registos. Por exemplo, as suas compilações podem incluir pacotes do registo npm público e de um repositório do Artifact Registry.
  • Publicar os mesmos pacotes em vários repositórios do Artifact Registry em Google Cloud projetos, bem como noutros registos npm, sem conflitos de nomes de pacotes.

Recomendamos que defina sempre um âmbito para os seus repositórios. Se não especificar um âmbito quando publica ou instala um pacote, o npm usa o registo predefinido configurado, como o registo npm público.

Define o âmbito de cada repositório do Artifact Registry no ficheiro de configuração .npmrc. As mesmas credenciais de autenticação aplicam-se a todos os repositórios.

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

  • O âmbito @blue é para o repositório no projeto blue-project.
  • O âmbito @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/: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 se autenticar no Artifact Registry, pode carregar um pacote para um repositório específico com o âmbito adequado. Por exemplo, o comando seguinte carrega um pacote para o blue-npm-repo no projeto blue-project:

npm publish @blue/blue-npm-repo

Para mais informações sobre âmbitos, consulte a documentação do npm

Configurar o npm

As definições usadas para a autenticação são armazenadas no ficheiro de configuração .npmrc. Pode configurar um ficheiro .npmrc ao nível do projeto, do utilizador ou global.

Quando configura a autenticação com o Artifact Registry, define os repositórios aos quais quer estabelecer ligação e as credenciais para autenticação.

Repositórios do Artifact Registry

Recomendamos que defina a lista de repositórios no ficheiro de configuração por projeto. Normalmente, este ficheiro encontra-se no mesmo diretório que o ficheiro package.json no seu projeto npm. Por predefinição, o auxiliar de credenciais do Artifact Registry verifica este ficheiro para os seus repositórios..npmrc

Se não quiser expor os caminhos do repositório no seu sistema de controlo de origem, pode:

  • Adicione o nome de ficheiro .npmrc à lista de ficheiros a ignorar do controlo de origem.
  • Em alternativa, armazene a lista de repositórios no ficheiro de configuração por utilizador. O ficheiro .npmrc por utilizador encontra-se no diretório base do utilizador ou é definido com o parâmetro --userconfig do npm ou a variável de ambiente $NPM_CONFIG_USERCONFIG. As definições no ficheiro de configuração por utilizador aplicam-se a todos os seus projetos, a menos que as substitua ao nível do projeto.
Credenciais do Artifact Registry

Armazene as suas credenciais para o Artifact Registry no ficheiro de configuração por utilizador para que não estejam disponíveis para outros utilizadores. Este ficheiro encontra-se no diretório base do utilizador ou é definido com o parâmetro --userconfig do npm ou a variável de ambiente $NPM_CONFIG_USERCONFIG.

O auxiliar de credenciais do Artifact Registry é armazenado no registo npm público e não requer autenticação para instalação.

Deve manter qualquer registo predefinido existente configurado no ficheiro .npmrc. Normalmente, a predefinição está definida para o registo npm público em https://registry.npmjs.org/.

Para verificar o valor predefinido atual da base de dados de registo, execute o comando:

npm get registry

Para mais informações sobre os ficheiros de configuração do npm, consulte a documentação do ficheiro de configuração do npm.