在 Artifact Registry 中存储 Node.js 软件包
本快速入门介绍如何设置私有 Artifact Registry Node.js 软件包代码库并向其上传软件包。
准备工作
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
启用 Artifact Registry API。
- 安装 Google Cloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init
-
在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
启用 Artifact Registry API。
- 安装 Google Cloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init
- 如果您想从 Windows 连接到 Node.js 软件包代码库,请安装 PowerShell。
启动 Cloud Shell
在本快速入门中,您将使用 Cloud Shell,这是一个用于管理 Google Cloud 上托管的资源的 shell 环境。
Cloud Shell 预安装有 Google Cloud CLI。gcloud CLI 提供了 Google Cloud 的主要命令行界面。
启动 Cloud Shell:
转到 Google Cloud 控制台。
在 Google Cloud 控制台工具栏中,点击激活 Cloud Shell:
控制台下方的框架内会打开一个 Cloud Shell 会话。您可以使用此 shell 运行 gcloud
命令。
创建 Node.js 软件包代码库
为 Node.js 工件创建代码库。
创建代码库。
控制台
打开 Google Cloud 控制台中的制品库页面。
点击创建代码库。
指定
quickstart-nodejs-repo
作为该代码库的名称。选择 npm 格式,选择标准模式。
在位置类型下,选择区域,然后选择位置
us-central1
。点击创建。
该代码库会被添加到代码库列表中
gcloud
运行以下命令,在位置
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"
运行以下命令确认已创建代码库。
gcloud artifacts repositories list
如需详细了解 Artifact Registry 命令,请运行
gcloud artifacts
命令。为了简化
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 项目,以便使用您创建的代码库进行身份验证。在本快速入门中,您将上传一个简单的软件包,然后将其作为依赖项安装在第二个软件包中。
下载 emoji-regex 软件包,这是一个简单的软件包,提供用于匹配所有表情符号符号和序列的正则表达式。
npm pack emoji-regex
该命令会下载软件包的归档文件。
将归档文件解压缩到一个
emoji-regex
目录中。以下命令适用于emoji-regex
版本 10.1.0 的归档文件:mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
创建第二个 npm 软件包,用于从 Artifact Registry 安装
emoji-regex
软件包。对于此软件包,请使用npm init
命令创建基本软件包。mkdir npm-package2 cd npm-package2 npm init -y
出现提示时,接受默认值。
配置
emoji-regex
和npm-package2
项目,以使用您创建的 Artifact Registry 代码库进行身份验证。运行以下命令。该命令会返回要添加到 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
将上一步中的配置设置添加到每个 npm 项目的项目
.npmrc
文件中。该文件与package.json
文件位于同一目录中。如需详细了解
.npmrc
文件,请参阅 Node.js 概览。每个 Artifact Registry Node.js 软件包代码库都与一个 npm 注册表端点
https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY
相关联。如果您创建另一个 Artifact Registry Node.js 软件包代码库,npm 会作为具有自己范围的单独注册表与之交互。
在
emoji-regex
和npm-package2
项目中修改package.json
。确保
name
的值包含quickstart
范围。- 对于
emoji-regex
:
"name": "@quickstart/emoji-regex"
- 对于
npm-package2
:
"name": "@quickstart/npm-package2"
- 对于
在
scripts
下,为 google-artifactregistry-auth(用于更新 Artifact Registry 代码库凭据的客户端库)添加脚本。"scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }
将软件包上传到代码库
刷新用于连接到代码库的访问令牌。
npm run artifactregistry-login
将您的软件包添加到代码库。您可以使用
npm
或yarn
命令。npm publish
yarn publish
查看代码库中的软件包
如需验证您的软件包是否已添加到代码库中,请执行以下操作:
控制台
打开 Google Cloud 控制台中的制品库页面。
在代码库列表中,点击
quickstart-nodejs-repo
代码库。软件包页面列出代码库中的软件包。
点击软件包以查看软件包版本。
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 install
或 yarn 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 账号产生费用,请按照以下步骤操作。
在移除代码库之前,请确保要保留的任何软件包在其他位置提供。
如需删除代码库,请执行以下操作:
控制台
打开 Google Cloud 控制台中的制品库页面。
在代码库列表中,选择
quickstart-nodejs-repo
代码库。点击删除。
gcloud
如需删除
quickstart-nodejs-repo
代码库,请运行以下命令:gcloud artifacts repositories delete quickstart-nodejs-repo
如果要移除您为活跃
gcloud
配置配置的默认代码库和位置设置,请运行以下命令:gcloud config unset artifacts/repository gcloud config unset artifacts/location
后续步骤
- 详细了解如何配置身份验证
- 了解如何管理代码库
- 了解如何管理软件包
- 阅读我们关于 DevOps 的资源,并了解我们的研究项目。