Armazenar pacotes do Node.js no Artifact Registry

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

1. Acesse o Console do Google Cloud.

   Console do Google Cloud

2. 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.

1. Crie o repositório.

   Console

   1. Abra a página Repositórios no console do Google Cloud.

      Abrir a página Repositórios

   2. Clique em Criar repositório.

   3. Especifique quickstart-nodejs-repo como o nome do repositório.

   4. Escolha npm como o formato e Padrão como o modo.

   5. Em Tipo de local, selecione Região e escolha o local us-central1.

   6. Clique em Criar.

   O repositório é adicionado à lista de repositórios

   gcloud

   1. Execute o comando abaixo para criar um novo repositório de pacotes Node.js chamado quickstart-nodejs-repo no local us-central1 com a descrição "repositório do Node.js".

      gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \
      --location=us-central1 --description="Node.js package repository"
      

   2. 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.

2. Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-nodejs-repo e o local padrão como us-central1. Depois que os valores forem definidos, não será necessário especificá-los nos comandos gcloud 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, você precisa configurar seus projetos npm com 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 .

1. 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.

2. Extraia o arquivo em um diretório emoji-regex. O comando a seguir é para um arquivo do emoji-regex versão 10.1.0:

   mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
   

3. Crie um segundo pacote npm que você vai usar para instalar o emoji-regex do Artifact Registry. Para este pacote, use o npm init para criar um pacote básico.

   mkdir npm-package2
   cd npm-package2
   
   npm init -y
   

   Quando solicitado, aceite os valores padrão.

4. Configurar os projetos emoji-regex e npm-package2 para autenticação com o repositório do Artifact Registry que você criou.

   1. 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
      

   2. Adicione as definições de configuração da etapa anterior ao projeto .npmrc em cada projeto NPM. O arquivo no mesmo diretório que o arquivo package.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 vai interagir com ele como um registro separado com o próprio escopo.

5. Edite package.json nos projetos emoji-regex e npm-package2.

   1. Verifique se o valor de name inclui o escopo quickstart.

      • Para obter emoji-regex:

      "name": "@quickstart/emoji-regex"
      

      • Para obter npm-package2:

      "name": "@quickstart/npm-package2"
      

   2. 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

1. Atualize o token de acesso para se conectar ao repositório.

   npm run artifactregistry-login
   

2. Adicione o pacote ao repositório. Use um comando npm ou yarn.

   npm publish
   

   yarn publish
   

Ver o pacote no repositório

Para verificar se o pacote foi adicionado ao repositório:

 gcloud artifacts packages list

gcloud artifacts versions list --package=PACKAGE

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"
}