在 Artifact Registry 中存储 Node.js 软件包

本快速入门介绍如何设置私有 Artifact Registry Node.js 软件包代码库并向其上传软件包。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  3. 确保您的 Google Cloud 项目已启用结算功能

  4. 启用 Artifact Registry API。

    启用 API

  5. 安装 Google Cloud CLI。
  6. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  7. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  8. 确保您的 Google Cloud 项目已启用结算功能

  9. 启用 Artifact Registry API。

    启用 API

  10. 安装 Google Cloud CLI。
  11. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  12. 如果您想从 Windows 连接到 Node.js 软件包代码库,请安装 PowerShell。

启动 Cloud Shell

在本快速入门中,您将使用 Cloud Shell,这是一个用于管理 Google Cloud 上托管的资源的 shell 环境。

Cloud Shell 预安装有 Google Cloud CLI。gcloud CLI 提供了 Google Cloud 的主要命令行界面。

启动 Cloud Shell:

  1. 转到 Google Cloud 控制台。

    Google Cloud 控制台

  2. 在 Google Cloud 控制台工具栏中,点击激活 Cloud Shell

控制台下方的框架内会打开一个 Cloud Shell 会话。您可以使用此 shell 运行 gcloud 命令。

创建 Node.js 软件包代码库

为 Node.js 工件创建代码库。

  1. 创建代码库。

    控制台

    1. 打开 Google Cloud 控制台中的制品库页面。

      打开“代码库”页面

    2. 点击创建代码库

    3. 指定 quickstart-nodejs-repo 作为该代码库的名称。

    4. 选择 npm 格式,选择标准模式。

    5. 位置类型下,选择区域,然后选择位置 us-central1

    6. 点击创建

    该代码库会被添加到代码库列表中

    gcloud

    1. 运行以下命令,在位置 us-central1 中创建一个名为 quickstart-nodejs-repo 且说明为“Node.js repository”的新 Node.js 软件包代码库。

      gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \
      --location=us-central1 --description="Node.js package repository"
      
    2. 运行以下命令确认已创建代码库。

      gcloud artifacts repositories list
      

    如需详细了解 Artifact Registry 命令,请运行 gcloud artifacts 命令。

  2. 为了简化 gcloud 命令,请将默认代码库设置为 quickstart-nodejs-repo,并将默认位置设置为 us-central1。设置以上值之后,您无需在需要代码库或位置的 gcloud 命令中指定这些值。

    如需设置代码库,请运行以下命令:

    gcloud config set artifacts/repository quickstart-nodejs-repo
    

    如需设置位置,请运行以下命令:

    gcloud config set artifacts/location us-central1
    

    如需详细了解这些命令,请参阅 gcloud config set 文档。

配置 npm

如需上传和下载软件包,您必须使用设置来配置 npm 项目,以便使用您创建的代码库进行身份验证。在本快速入门中,您将上传一个简单的软件包,然后将其作为依赖项安装在第二个软件包中。

  1. 下载 emoji-regex 软件包,这是一个简单的软件包,提供用于匹配所有表情符号符号和序列的正则表达式。

    npm pack emoji-regex
    

    该命令会下载软件包的归档文件。

  2. 将归档文件解压缩到一个 emoji-regex 目录中。以下命令适用于 emoji-regex 版本 10.1.0 的归档文件:

    mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
    
  3. 创建第二个 npm 软件包,用于从 Artifact Registry 安装 emoji-regex 软件包。对于此软件包,请使用 npm init 命令创建基本软件包。

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

    出现提示时,接受默认值。

  4. 配置 emoji-regexnpm-package2 项目,以使用您创建的 Artifact Registry 代码库进行身份验证。

    1. 运行以下命令。该命令会返回要添加到 npm 配置文件的配置设置。

      gcloud artifacts print-settings npm --scope=@quickstart
      

      quickstart 范围与您的代码库关联。在用于发布或安装软件包的命令中包含该范围后,npm 会使用您的代码库。当您发布或安装没有范围的软件包时,系统会使用您配置的默认代码库。如需了解详情,请参阅 Node.js 概览

      gcloud 命令的输出如以下示例所示。PROJECT 是您的 Google Cloud 项目 ID。

      @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. 将上一步中的配置设置添加到每个 npm 项目的项目 .npmrc 文件中。该文件与 package.json 文件位于同一目录中。

      如需详细了解 .npmrc 文件,请参阅 Node.js 概览

      每个 Artifact Registry Node.js 软件包代码库都与一个 npm 注册表端点 https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY 相关联。如果您创建另一个 Artifact Registry Node.js 软件包代码库,npm 会作为具有自己范围的单独注册表与之交互。

  5. emoji-regexnpm-package2 项目中修改 package.json

    1. 确保 name 的值包含 quickstart 范围。

      • 对于 emoji-regex
      "name": "@quickstart/emoji-regex"
      
      • 对于 npm-package2
      "name": "@quickstart/npm-package2"
      
    2. scripts 下,为 google-artifactregistry-auth(用于更新 Artifact Registry 代码库凭据的客户端库)添加脚本。

      "scripts": {
        "artifactregistry-login": "npx google-artifactregistry-auth"
      }
      

将软件包上传到代码库

  1. 刷新用于连接到代码库的访问令牌。

    npm run artifactregistry-login
    
  2. 将您的软件包添加到代码库。您可以使用 npmyarn 命令。

    npm publish
    
    yarn publish
    

查看代码库中的软件包

如需验证您的软件包是否已添加到代码库中,请执行以下操作:

控制台

  1. 打开 Google Cloud 控制台中的制品库页面。

    打开“代码库”页面

  2. 在代码库列表中,点击 quickstart-nodejs-repo 代码库。

    软件包页面列出代码库中的软件包。

  3. 点击软件包以查看软件包版本。

gcloud

如需列出默认 quickstart-nodejs-repo 代码库中的映像,请运行以下命令:

 gcloud artifacts packages list

如需查看软件包的版本,请运行以下命令:

gcloud artifacts versions list --package=PACKAGE

其中 PACKAGE 是软件包 ID。

安装软件包

从 Artifact Registry 代码库的 npm-package2 中安装 emoji-regex 软件包。

npm-package2 目录中,运行 npm installyarn add 命令:

npm install @quickstart/emoji-regex
yarn add @quickstart/emoji-regex

该命令会在 npm-package2 项目中安装 emoji-regex 软件包。它还会更新 package.json 以将 emoji-regex 设置为依赖项。

"dependencies": {
  "@quickstart/emoji-regex": "^10.1.0"
}

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用,请按照以下步骤操作。

在移除代码库之前,请确保要保留的任何软件包在其他位置提供。

如需删除代码库,请执行以下操作:

控制台

  1. 打开 Google Cloud 控制台中的制品库页面。

    打开“代码库”页面

  2. 在代码库列表中,选择 quickstart-nodejs-repo 代码库。

  3. 点击删除

gcloud

  1. 如需删除 quickstart-nodejs-repo 代码库,请运行以下命令:

    gcloud artifacts repositories delete quickstart-nodejs-repo
    
  2. 如果要移除您为活跃 gcloud 配置配置的默认代码库和位置设置,请运行以下命令:

    gcloud config unset artifacts/repository
    gcloud config unset artifacts/location
    

后续步骤