Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 업스트림 리포지토리가 포함된 패키지 버전 요청
<a name="packages-upstream-repositories-request"></a>

다음 예시는 패키지 관리자가 업스트림 리포지토리가 있는 CodeCatalyst 패키지 리포지토리에서 패키지를 요청하는 경우 발생할 수 있는 시나리오를 보여줍니다.

이 예시에서는 `npm`과 같은 패키지 관리자가 여러 업스트림 리포지토리가 있는 `downstream`이라는 패키지 리포지토리에서 패키지 버전을 요청합니다. 패키지를 요청하면 다음이 발생할 수 있습니다.
+  요청된 패키지 버전이 `downstream`에 포함되어 있는 경우 클라이언트에 반환됩니다.
+  요청된 패키지 버전이 `downstream`에 포함되어 있지 않은 경우 CodeCatalyst는 `downstream` 업스트림 리포지토리에서 구성된 검색 순서에 따라 해당 버전을 찾습니다. 패키지 버전을 찾으면 해당 패키지에 대한 참조가 `downstream`에 복사되고 패키지 버전이 클라이언트에 반환됩니다.
+  `downstream` 및 해당 업스트림 리포지토리 모두에 패키지 버전이 포함되어 있지 않은 경우 HTTP 404 `Not Found` 응답이 클라이언트에 반환됩니다.

 하나의 리포지토리에 허용되는 최대 직접 업스트림 리포지토리 수는 10개입니다. 패키지 버전이 요청될 때 CodeCatalyst가 확인하는 최대 리포지토리 수는 25개입니다.

## 업스트림 리포지토리의 패키지 보존
<a name="package-retention-upstream-repos"></a>

요청된 패키지 버전이 업스트림 리포지토리에서 발견되면 해당 버전에 대한 참조가 유지되며 해당 버전의 요청을 받은 리포지토리에서 항상 사용할 수 있습니다. 이렇게 하면 업스트림 리포지토리가 예기치 않게 중단되는 경우에 패키지에 액세스할 수 있습니다. 유지되는 패키지 버전은 다음 사항에 영향을 받지 않습니다.
+  업스트림 리포지토리 삭제 
+  업스트림 리포지토리와 다운스트림 리포지토리 간 연결 해제 
+  업스트림 리포지토리에서 패키지 버전 삭제 
+  업스트림 리포지토리의 패키지 버전 편집(예: 새 자산 추가) 

## 업스트림 관계를 통해 패키지 가져오기
<a name="fetching-packages-through-an-upstream-relationship"></a>

CodeCatalyst는 업스트림 리포지토리라는 연결된 여러 리포지토리를 통해 패키지를 가져올 수 있습니다. CodeCatalyst 패키지 리포지토리에 게이트웨이 리포지토리에 대한 업스트림 연결이 있는 다른 CodeCatalyst 패키지 리포지토리에 대한 업스트림 연결이 있는 경우, 업스트림 리포지토리에 없는 패키지에 대한 요청은 외부 리포지토리에서 복사됩니다. 예를 들어, 다음과 같은 구성을 살펴보겠습니다. `repo-A`라는 리포지토리는 `npm-public-registry-gateway`라는 게이트웨이 리포지토리에 대한 업스트림 연결이 있습니다. `npm-public-registry-gateway`는 퍼블릭 패키지 리포지토리인 [https://npmjs.com](https://npmjs.com) 대한 업스트림 연결이 있습니다.

![\[세 개의 리포지토리가 서로 연결되어 있는 모습을 보여주는 간단한 업스트림 리포지토리 다이어그램\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/packages/upstream-with-external.png)


`npm`이 `repo-A` 리포지토리를 사용하도록 구성된 경우 `npm install`을 실행하면 [https://npmjs.com](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`)만 포함됩니다. 해당 버전이 `repo-A`에서 `npm`를 통해 가져온 버전이기 때문입니다.

 `npm-public-registry-gateway`에 [https://npmjs.com](https://npmjs.com)에 대한 외부 업스트림 연결이 있기 때문에 [https://npmjs.com](https://npmjs.com)에서 가져온 모든 패키지 버전이 `npm-public-registry-gateway`에 저장됩니다. 이러한 패키지 버전은 `npm-public-registry-gateway`로 업스트림 연결이 있는 모든 다운스트림 리포지토리에서 가져올 수 있었을 것입니다.

`npm-public-registry-gateway`의 내용은 시간이 지남에 따라 [https://npmjs.com](https://npmjs.com)에서 가져온 모든 패키지 및 패키지 버전을 볼 수 있는 방법을 제공합니다.

## 중간 리포지토리에 패키지 보존
<a name="package-retention-intermediate-repositories"></a>

 CodeCatalyst를 사용하면 업스트림 리포지토리를 연결할 수 있습니다. 예를 들어 `repo-B`는 `repo-A`의 업스트림 리포지토리가 되고 `repo-C`는 `repo-B`의 업스트림 리포지토리가 됩니다. 이 구성을 통해 `repo-A`에서 `repo-B` 및 `repo-C` 패키지 버전을 사용할 수 있습니다.

![\[세 개의 리포지토리가 서로 연결되어 있는 모습을 보여주는 간단한 업스트림 리포지토리 다이어그램\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/packages/upstream-chaining.png)


 패키지 관리자가 `repo-A` 리포지토리에 연결하고 `repo-C` 리포지토리에서 패키지 버전을 가져오면 해당 패키지 버전은 `repo-B` 리포지토리에 유지되지 않습니다. 이 예시에서는 패키지 버전은 최종 `repo-A` 다운스트림 리포지토리에만 유지됩니다. 중간 리포지토리에는 유지되지 않습니다. 더 긴 체인의 경우에도 마찬가지입니다. 예를 들어, 네 개의 리포지토리 `repo-A`, `repo-B`, `repo-C`, `repo-D` 및 패키지 관리자가 `repo-A`에 연결되어 있고 `repo-D`에서 패키지 버전을 가져온 경우, 해당 패키지 버전은 `repo-A`에는 유지되지만 `repo-B` 또는 `repo-C`에는 유지되지 않습니다.

패키지 보존 동작은 퍼블릭 패키지 리포지토리에서 패키지 버전을 가져올 때와 비슷합니다. 단, 패키지 버전이 퍼블릭 리포지토리에 대한 직접 업스트림 연결이 연결된 게이트웨이 리포지토리에 항상 유지된다는 점이 다릅니다. 예를 들어 `repo-B`는 `repo-A`의 업스트림 리포지토리로 사용됩니다. `npm-public-registry-gateway`는 `repo-B`의 업스트림 리포지토리로, 퍼블릭 리포지토리 **npmjs.com**에 대한 업스트림 연결이 연결됩니다. 아래 다이어그램을 참조하세요.

![\[npmjs.com에 대한 외부 업스트림 연결과 함께 연결된 세 개의 리포지토리를 보여주는 업스트림 리포지토리 다이어그램\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/packages/upstream-chaining-external.png)


 `repo-A`에 연결된 패키지 관리자가 특정 패키지 버전(예: *lodash 4.17.20*)을 요청했으나 해당 패키지 버전이 세 리포지토리 중 어디에도 없는 경우 **npmjs.com**에서 해당 패키지 버전을 가져옵니다. *lodash 4.17.20*을 가져오면 이는 최종 다운스트림 리포지토리인 `repo-A`와 퍼블릭 외부 리포지토리인 **npmjs.com**에 대한 업스트림 연결이 되어 있는 `npm-public-registry-gateway`에 유지됩니다. *lodash 4.17.20*은 중간 저장소인 `repo-B`에는 유지되지 않습니다.