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

업스트림 리포지토리가 포함된 패키지 버전 요청

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

이 예시에서는 npm과 같은 패키지 관리자가 여러 업스트림 리포지토리가 있는 downstream이라는 패키지 리포지토리에서 패키지 버전을 요청합니다. 패키지를 요청하면 다음이 발생할 수 있습니다.

하나의 리포지토리에 허용되는 최대 직접 업스트림 리포지토리 수는 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)만 포함됩니다. 해당 버전이 repo-A에서 npm를 통해 가져온 버전이기 때문입니다.

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-B는 repo-A의 업스트림 리포지토리가 되고 repo-C는 repo-B의 업스트림 리포지토리가 됩니다. 이 구성을 통해 repo-A에서 repo-B 및 repo-C 패키지 버전을 사용할 수 있습니다.

패키지 관리자가 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에 대한 업스트림 연결이 연결됩니다. 아래 다이어그램을 참조하세요.

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에는 유지되지 않습니다.