本页介绍了如何在 Apt 代码库中添加、查看和删除 Debian 软件包。
准备工作
- 如果目标 Apt 代码库不存在，请创建新代码库。
- 配置虚拟机以访问代码库。
- （可选）为 gcloud 命令配置默认值。
- 确保元数据中的软件包名称符合 Debian 软件包名称标准。
添加软件包
代码库模式：标准
您必须同时拥有对代码库的读取和写入权限，才能添加软件包。
您可以使用 Google Cloud CLI 将软件包上传到代码库，也可以导入存储在 Cloud Storage 中的软件包。如果您使用 Cloud Build 构建软件包，则构建过程可以将软件包存储在 Cloud Storage 中，以供您导入。
导入或上传操作时间过长可能会超出 gcloud CLI 用于调用 API 的令牌的到期期限。如果您要添加的软件包数量非常多，不妨考虑分批添加，以便缩短每次上传或导入操作的完成时间。如需了解详情，请参阅操作系统软件包问题排查文档。
直接上传
使用 gcloud artifacts apt upload 命令将软件包上传到 Apt 代码库：
gcloud artifacts apt upload REPOSITORY \
--location=LOCATION \
--source=PACKAGES
替换以下值：
REPOSITORY是 Artifact Registry 制品库名称。-
LOCATION是代码库的单区域或多区域位置。 PACKAGES是软件包的路径。
例如，如需将软件包 my-package.deb 上传到位置 us-west1 中的 Apt 代码库 my-repo，请运行以下命令：
gcloud artifacts apt upload my-repo \
--location=us-west1 \
--source=my-package.deb
Cloud Storage
- 请执行以下操作，将软件包上传到 Cloud Storage：
- 直接上传软件包到 Cloud Storage 存储分区
- 使用 Cloud Build 构建软件包并将其存储在存储分区中
- 运行以下命令：
gcloud artifacts apt import REPOSITORY \ --location=LOCATION \ --gcs-source=PACKAGES
替换以下值：
REPOSITORY是 Artifact Registry 制品库名称。-
LOCATION是代码库的单区域或多区域位置。 PACKAGES是 Cloud Storage 中软件包的英文逗号分隔列表。如需上传目录中的所有软件包，请使用目录通配符 (*) 或递归目录通配符 (**) 上传所有子目录中的所有软件包。
例如，如需将软件包
package.deb和directory目录中的所有软件包从存储分区my-bucket上传到位置us-west1中的 Apt 代码库my-repo，请运行以下命令：gcloud artifacts apt import my-repo \ --location=us-west1 \ --gcs-source=gs://my-bucket/path/to/package.deb,gs://my-bucket/directory*
上传或导入操作完成后，您可以使用Google Cloud 控制台或 gcloud CLI 查看代码库中的软件包，并确认它们已成功上传。
如果您有包含大量软件包的大型代码库，则可能需要几分钟才能重新生成软件包索引，以便 Apt 客户端可以看到新软件包。
查看软件包
代码库模式：标准、远程（预览版）如需查看软件包，您必须拥有 Artifact Registry Reader 角色的权限。Artifact Registry 不会列出软件包内的文件。
如需使用 Google Cloud 控制台或 gcloud 查看软件包和软件包版本，请执行以下操作：
控制台
在 Google Cloud 控制台中打开制品库页面。
在代码库列表中，点击相应代码库。
软件包页面列出代码库中的软件包。
点击一个软件包以查看它的版本。
gcloud
如需列出代码库中的软件包，请运行以下命令：
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
替换以下内容：
如需查看软件包的版本，请运行以下命令：
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
替换以下内容：
安装软件包
代码库模式：标准、远程（预览版）在安装软件包之前，请验证您是否已正确配置软件包管理器和代码库。
如需在代码库中安装软件包，请执行以下操作：
更新可用软件包的列表：
sudo apt update安装软件包，指定在 Apt 中配置的代码库的名称。
sudo apt install PACKAGE/REPOSITORY替换以下值：
PACKAGE是软件包名称。REPOSITORY是 Artifact Registry 制品库的名称。对于远程仓库，请使用标准上游仓库的名称。
例如，如需从代码库
my-repo安装软件包my-package，请运行以下命令：sudo apt install my-package -t my-repo
删除软件包
代码库模式：标准
在删除软件包或软件包版本之前，请确认您已在其中告知或解决任何重要依赖项。
如需删除软件包，请按如下所述操作：
控制台
在 Google Cloud 控制台中打开制品库页面。
在代码库列表中，点击相应代码库。
软件包页面列出代码库中的软件包。
选择要删除的软件包。
点击删除。
在确认对话框中，点击删除。
gcloud
运行以下命令：
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
替换以下内容：
PACKAGE是代码库中的软件包名称。REPOSITORY是代码库的名称。如果您配置了默认代码库，则可以省略此标志以使用默认值。-
LOCATION是代码库的单区域或多区域位置。 使用此标志可查看特定位置的代码库。如果您配置了默认位置，则可以省略此标志以使用默认值。
--async 标志会导致命令立即返回，而无需等待正在进行的操作完成。
如需删除软件包的版本，请按如下所述操作：
控制台
在 Google Cloud 控制台中打开制品库页面。
在代码库列表中，点击相应代码库。
软件包页面列出代码库中的软件包。
点击一个软件包以查看它的版本。
选择您要删除的版本。
点击删除。
在确认对话框中，点击删除。
gcloud
运行以下命令：
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
替换以下内容：
VERSION是要删除的版本的名称。PACKAGE是代码库中的软件包名称。REPOSITORY是代码库的名称。如果您配置了默认代码库，则可以省略此标志以使用默认值。-
LOCATION是代码库的单区域或多区域位置。 使用此标志可查看特定位置的代码库。如果您配置了默认位置，则可以省略此标志以使用默认值。
--async 标志会导致命令立即返回，而无需等待正在进行的操作完成。
对于大型代码库，重新生成 Apt 软件包索引可能需要几分钟时间，以反映删除操作。