A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Solicitar uma versão do pacote com repositórios upstream
O exemplo a seguir mostra os cenários possíveis quando um gerenciador de pacotes solicita um pacote de um repositório de CodeCatalyst pacotes que tenha repositórios upstream.
Neste exemplo, um gerenciador de pacotes, como `npm`, solicita uma versão de pacote de um repositório de pacotes chamado `downstream` que tem vários repositórios upstream. Quando o pacote é solicitado, o seguinte pode ocorrer:
+ Se `downstream` contiver a versão do pacote solicitada, ela será devolvida ao cliente.
+ Se `downstream` não contiver a versão do pacote solicitada, CodeCatalyst procurará por ela nos `downstream` repositórios upstream, na ordem de pesquisa configurada. Se a versão do pacote for encontrada, uma referência a ela será copiada para `downstream` e a versão do pacote será devolvida ao cliente.
+ Se `downstream` nem seus repositórios upstream contiverem a versão do pacote, uma resposta HTTP 404 de `Not Found` será exibida ao cliente.
A quantidade máxima de repositórios upstream diretos permitidos para um repositório é dez. O número máximo de CodeCatalyst pesquisas nos repositórios quando uma versão do pacote é solicitada é 25.
## Retenção de pacotes de repositórios upstream
Se uma versão de pacote solicitada for encontrada em um repositório upstream, uma referência a ela será retida e estará sempre disponível no repositório que a solicitou. Isso garante que você tenha acesso aos seus pacotes se houver uma interrupção inesperada do repositório upstream. A versão retida do pacote não é afetada por nenhum das seguintes ações:
+ Excluir o repositório upstream.
+ Desconectar o repositório upstream do repositório downstream.
+ Excluir a versão do pacote do repositório upstream.
+ Editar a versão do pacote no repositório upstream (por exemplo, adicionar um novo ativo a ele).
## Busca de pacotes por meio de uma relação upstream
CodeCatalyst pode buscar pacotes por meio de vários repositórios vinculados chamados repositórios upstream. Se um repositório de CodeCatalyst pacotes tiver uma conexão upstream com outro repositório de CodeCatalyst pacotes que tenha uma conexão upstream com um repositório gateway, as solicitações de pacotes que não estão no repositório upstream serão copiadas do repositório externo. Por exemplo, considere a seguinte configuração: um repositório chamado `repo-A` tem uma conexão upstream com o repositório do gateway,. `npm-public-registry-gateway` `npm-public-registry-gateway`tem uma conexão upstream com o repositório público de pacotes,. [https://npmjs.com](https://npmjs.com)
Se `npm` estiver configurado para usar o `repo-A` repositório, a execução `npm install` inicia a cópia dos pacotes de [https://npmjs.com](https://npmjs.com)dentro. `npm-public-registry-gateway` As versões instaladas também são incorporadas em `repo-A`. O exemplo a seguir instala o `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
```
Depois de executar `npm install`, `repo-A` contém apenas a versão mais recente (`lodash 4.17.20`) porque essa é a versão que foi obtida por `npm` de `repo-A`.
Como `npm-public-registry-gateway` tem uma conexão upstream externa com [https://npmjs.com](https://npmjs.com), todas as versões do pacote importadas [https://npmjs.com](https://npmjs.com)são armazenadas em`npm-public-registry-gateway`. Essas versões do pacote poderiam ter sido obtidas por qualquer repositório downstream com uma conexão upstream que leva a `npm-public-registry-gateway`.
O conteúdo de `npm-public-registry-gateway` fornece uma maneira de você ver todos os pacotes e versões de pacotes importados [https://npmjs.com](https://npmjs.com)ao longo do tempo.
## Retenção de pacotes em repositórios intermediários
CodeCatalyst permite encadear repositórios upstream. Por exemplo, `repo-A` pode ter `repo-B` como repositório upstream e `repo-B` pode ter `repo-C` como repositório upstream. Essa configuração faz com que as versões do pacote sejam inseridas no `repo-B` e `repo-C` disponíveis do `repo-A`.
Quando um gerenciador de pacotes se conecta ao repositório `repo-A` e busca uma versão do pacote no repositório `repo-C`, a versão do pacote não será retida no repositório `repo-B`. A versão do pacote só será retida no repositório mais downstream, que, neste exemplo, é `repo-A`. Ela não será retida em nenhum repositório intermediário. Isso também vale para cadeias mais longas. Por exemplo, se houvesse quatro repositórios: `repo-A`, `repo-B`, `repo-C` e `repo-D` e um gerenciador de pacotes conectado ao `repo-A` buscasse uma versão do pacote no `repo-D`, a versão do pacote seria retida em `repo-A`, mas não em `repo-B` ou `repo-C`.
O comportamento de retenção do pacote é semelhante ao extrair uma versão do pacote de um repositório de pacotes público, exceto que a versão do pacote é sempre retida no repositório de gateway que tem a conexão upstream direta com o repositório público. Por exemplo, `repo-A` tem `repo-B` como repositório upstream. `repo-B` tem `npm-public-registry-gateway` como um repositório upstream, que tem uma conexão upstream com o repositório público, **npmjs.com**; veja o diagrama abaixo.
**Se um gerenciador de pacotes conectado ao `repo-A` solicitar uma versão de pacote específica, por exemplo, *lodash 4.17.20*, e a versão do pacote não estiver presente em nenhum dos três repositórios, ela será obtida em npmjs.com.** Quando o *lodash 4.17.20* for obtido, ele será retido no `repo-A`, pois é o repositório mais downstream, e no `npm-public-registry-gateway`, pois tem a conexão upstream com o repositório externo público **npmjs.com**. O *lodash 4.17.20* não será retido no `repo-B`, pois é um repositório intermediário.