Armazenar pacotes do Node.js no Artifact Registry
Neste guia de início rápido, mostramos como configurar um Node.js particular do Artifact Registry repositório de pacotes e fazer upload de um pacote para ele.
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Artifact Registry API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Artifact Registry API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Instale o PowerShell para se conectar a um repositório de pacotes Node.js do Windows.
Iniciar o Cloud Shell
Neste guia de início rápido, você vai usar o Cloud Shell, que é um ambiente shell para gerenciar recursos hospedados Google Cloud.
O Cloud Shell vem pré-instalado com o Google Cloud CLI: CLI gcloud fornece a interface de linha de comando principal do Google Cloud.
Inicie o Cloud Shell
Acesse o Console do Google Cloud.
Na barra de ferramentas do console do Google Cloud, clique em Ativar o Cloud Shell:
Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console.
Use esse shell para executar comandos gcloud
.
Criar um repositório de pacotes Node.js
Crie o repositório para seus artefatos do Node.js.
Crie o repositório.
Console
Abra a página Repositórios no console do Google Cloud.
Clique em Criar repositório.
Especifique
quickstart-nodejs-repo
como o nome do repositório.Escolha npm como o formato e Padrão como o modo.
Em Tipo de local, selecione Região e escolha o local
us-central1
.Clique em Criar.
O repositório é adicionado à lista de repositórios
gcloud
Execute o seguinte comando para criar um novo repositório de pacotes Node.js chamado
quickstart-nodejs-repo
no localus-central1
com o descrição "Repositório Node.js".gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \ --location=us-central1 --description="Node.js package repository"
Execute o seguinte comando para verificar se o repositório foi criado.
gcloud artifacts repositories list
Para mais informações sobre os comandos do Artifact Registry, execute o comando
gcloud artifacts
.Para simplificar os comandos
gcloud
, defina o repositório padrão comoquickstart-nodejs-repo
e o local padrão comous-central1
. Depois que os valores forem definidos, não será necessário especificá-los nos comandosgcloud
que exigem um repositório ou local.Para definir o repositório, execute o comando:
gcloud config set artifacts/repository quickstart-nodejs-repo
Para definir o local, execute o comando:
gcloud config set artifacts/location us-central1
Saiba mais sobre esses comandos na documentação do gcloud config set.
Configurar NPM
Para fazer upload e download de pacotes, configure seus projetos npm com configurações para autenticar com o repositório que você criou. Para este guia de início rápido, você carregará um pacote simples e o instalará em um segundo pacote como .
Faça o download do pacote emoji-regex, simples que fornece uma expressão regular para corresponder a todos os símbolos e sequências de emoji.
npm pack emoji-regex
O comando faz o download de um arquivo do pacote.
Extraia o arquivo em um diretório
emoji-regex
. O comando a seguir é para um arquivo da versão 10.1.0 doemoji-regex
:mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
Crie um segundo pacote npm que será usado para instalar o pacote
emoji-regex
do Artifact Registry. Para este pacote, use o comandonpm init
para criar um pacote básico.mkdir npm-package2 cd npm-package2 npm init -y
Quando solicitado, aceite os valores padrão.
Configurar os projetos
emoji-regex
enpm-package2
para autenticação com o repositório do Artifact Registry que você criou.Execute o comando a seguir. O comando retorna definições de configuração para adicionar ao arquivo de configuração do npm.
gcloud artifacts print-settings npm --scope=@quickstart
O escopo
quickstart
está associado ao repositório. Quando você inclui o escopo nos comandos para publicar ou instalar pacotes, o npm usa seu repositório. Quando você publica ou instala pacotes sem um escopo, o repositório padrão configurado é usado. Para mais informações, consulte a visão geral do Node.js.A saída do comando
gcloud
é semelhante ao exemplo a seguir. PROJECT é o ID do projeto no Google Cloud.@quickstart:registry=https://us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/ //us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/:always-auth=true
Adicione as definições de configuração da etapa anterior ao projeto
.npmrc
em cada projeto NPM. O arquivo no mesmo diretório como o arquivopackage.json
.Para saber mais sobre o arquivo
.npmrc
, consulte a visão geral do Node.js.Cada repositório de pacotes Node.js do Artifact Registry está associado a um endpoint de registro do npm
https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY
. Se você criar outro repositório de pacotes Node.js do Artifact Registry, o npm interage com ele como separado com o próprio escopo.
Edite
package.json
nos projetosemoji-regex
enpm-package2
.Verifique se o valor de
name
inclui o escopoquickstart
.- Para obter
emoji-regex
:
"name": "@quickstart/emoji-regex"
- Para obter
npm-package2
:
"name": "@quickstart/npm-package2"
- Para obter
Em
scripts
, adicione um script para google-artifactregistry-auth, uma biblioteca de cliente que atualiza as credenciais dos repositórios do Artifact Registry."scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }
Fazer upload de um pacote para o repositório
Atualize o token de acesso para se conectar ao repositório.
npm run artifactregistry-login
Adicione o pacote ao repositório. Use um comando
npm
ouyarn
.npm publish
yarn publish
Ver o pacote no repositório
Para verificar se o pacote foi adicionado ao repositório:
Console
Abra a página Repositórios no console do Google Cloud.
Na lista de repositórios, selecione o repositório
quickstart-nodejs-repo
.A página Pacotes lista os pacotes no repositório.
Clique em um pacote para ver as versões dele.
gcloud
Para listar as imagens no repositório padrão quickstart-nodejs-repo
, execute o seguinte comando:
gcloud artifacts packages list
Para ver as versões de um pacote, execute o seguinte comando:
gcloud artifacts versions list --package=PACKAGE
Em que PACKAGE é o ID do pacote.
Como instalar pacotes
Instale o pacote emoji-regex
do seu repositório do Artifact Registry
em npm-package2
.
No diretório npm-package2
, execute o comando npm install
ou yarn add
:
npm install @quickstart/emoji-regex
yarn add @quickstart/emoji-regex
O comando instala o pacote emoji-regex
no projeto npm-package2
.
Ela também atualiza package.json
para definir emoji-regex
como uma dependência.
"dependencies": {
"@quickstart/emoji-regex": "^10.1.0"
}
Limpar
Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
Antes de remover um repositório, verifique se os pacotes que você quer manter estão disponíveis em outro local.
Para excluir o repositório:
Console
Abra a página Repositórios no console do Google Cloud.
Na lista de repositórios, selecione o repositório
quickstart-nodejs-repo
.Clique em Excluir.
gcloud
Para excluir o repositório
quickstart-nodejs-repo
, execute o seguinte comando:gcloud artifacts repositories delete quickstart-nodejs-repo
Se você quiser remover as configurações padrão de repositório e localização que definiu para a configuração ativa
gcloud
, execute os seguintes comandos:gcloud config unset artifacts/repository gcloud config unset artifacts/location
A seguir
- Saiba mais sobre como configurar a autenticação
- Saiba mais sobre como gerenciar repositórios
- Saiba mais sobre como gerenciar pacotes
- Leia nossos recursos sobre DevOps e conheça nosso programa de pesquisa.