本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

请求包含上游存储库的程序包版本

以下示例显示了包管理器从具有上游存储库的软件包存储库请求 CodeCatalyst 包时可能出现的情况。

在此示例中，软件包管理器（例如）从名downstream为npm且具有多个上游存储库的软件包存储库中请求软件包版本。当请求包裹时，可能会出现以下情况：

一个存储库允许的直接上游存储库的最大数量为 10。请求软件包版本时 CodeCatalyst 搜索的最大存储库数为 25。

上游存储库的程序包保留

如果在上游存储库中找到了请求的软件包版本，则会保留对该版本的引用，并且在请求该版本的存储库中始终可用。这样可以确保在上游存储库意外中断时您可以访问您的软件包。保留的程序包版本不受以下任何因素的影响：

通过上游关系获取软件包

CodeCatalyst 可以通过多个名为上游存储库的链接存储库获取软件包。如果一个 CodeCatalyst 包存储库与另一个包存储库有上游连接，而另一个 CodeCatalyst 包存储库与网关存储库有上游连接，则会从外部存储库中复制对不在上游存储库中的软件包的请求。例如，考虑以下配置：名为的存储库与网关存储库repo-A有上游连接npm-public-registry-gateway。 npm-public-registry-gateway与公共软件包存储库有上游连接https://npmjs.com。

如果配置npm为使用repo-A存储库，则运行npm install会启动将软件包从复制https://npmjs.com到npm-public-registry-gateway。已安装的版本也会提取到 repo-A。下面的示例会安装 lodash。

$ npm config get registry
https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/
$ npm install lodash
+ lodash@4.17.20
added 1 package from 2 contributors in 6.933s

运行后npm install，仅repo-A包含最新版本 (lodash 4.17.20)，因为这是npm从中repo-A获取的版本。

由于与npm-public-registry-gateway有外部上游连接 https://npmjs.com，因此所有从中导入的软件包版本https://npmjs.com都存储在中npm-public-registry-gateway。这些软件包版本可以由任何具有上游连接的下游存储库获取。npm-public-registry-gateway

的内容为您npm-public-registry-gateway提供了一种查看一段时间以来导入的所有软件包和软件包版本的方法。https://npmjs.com

中间存储库中的程序包保留

CodeCatalyst 允许您链接上游存储库。例如，repo-A可以repo-B作为上游存储库，repo-B也可以repo-C作为上游存储库。这个配置意味着在 repo-A 中可以获取 repo-B 和 repo-C 中的程序包版本。

当包管理器连接到存储库repo-A并从存储库中获取软件包版本时repo-C，软件包版本不会保留在存储库repo-B中。软件包版本仅保留在最远的下游存储库中，在本示例中为。repo-A它不会保留在任何中间存储库中。对于较长的链也是如此；例如，如果有四个存储库：repo-A、repo-Brepo-Crepo-D、和，并且连接的包管理器从中repo-A获取软件包版本，则包版本将保留在或中repo-D，repo-A但不保留在repo-B或repo-C中。

从公共包存储库中提取包版本时，软件包保留行为类似，唯一的不同是包版本始终保留在与公共仓库有直接上游连接的网关存储库中。例如，repo-A具有repo-B作为上游存储库。 repo-Bnpm-public-registry-gateway作为上游存储库，它与公共存储库 npmjs.com 有上游连接；参见下图。

如果连接到的软件包管理器repo-A请求特定的软件包版本，例如 l odash 4.17.20，而该软件包版本不存在于三个存储库中的任何一个存储库中，则将从 npmjs.com 获取该版本。当获取 l odash 4.17.20 时，它会保留在中，repo-A因为这是最远的下游存储库，并且npm-public-registry-gateway它与公共外部存储库 npmjs.com 有上游连接。 l@@ odash 4.17.20 没有保留在中，repo-B因为那是一个中间存储库。