여러 레지스트리 간에 NPM 패키지 동기화

사진: Nicolas Radzimski, Unsplash

문제

저희 팀은 패키지 관리를 위해 내부 GitLab NPM 레지스트리를 사용합니다. 이는 내부 배포에 완벽하게 작동하지만 패키지를 외부 공동 작업자와 공유해야 하는 경우가 있습니다. 내부 레지스트리에서 외부 레지스트리로 패키지를 동기화하는 것이 새로운 과제가 되었습니다.

저는 해결책을 찾기 시작했고, 평소와 같이 이를 개발자 투쟁의 또 다른 장으로 바꾸는 일련의 장애물에 직면했습니다.

시도 1: HTTP 요청을 사용하여 NPM CLI를 모방

처음에는 NPM CLI가 내부적으로 수행하는 작업을 기본적으로 모방하여 원시 HTTP 요청으로 이 문제를 처리할 수 있다고 생각했습니다. 아이디어는 간단했습니다. 소스 레지스트리에서 패키지 메타데이터를 쿼리하고, tarball을 가져와서 대상 레지스트리에 업로드하는 것입니다.

실패한 이유:

• 과정이 너무 복잡하고 취약했습니다.
• 모든 버전에 대해 전체 package.json 매니페스트를 수동으로 구성해야 했습니다.
• 작은 실수 하나하나가 패키지 파손으로 이어졌습니다.

시도 2: npm-registry-sync 활용

다음으로 NPM 레지스트리 동기화를 위해 설계된 라이브러리인 npm-registry-sync를 발견했습니다. 이 도구는 문제를 거의 해결했습니다. 변경 사항을 모니터링하고 레지스트리 전체에 복제할 수 있습니다.

나에게 효과가 없었던 이유:

• 업데이트를 지속적으로 폴링하는 "데몬 모드"로 작동합니다.
• GitLab CI 파이프라인에서는 파이프라인에 의해 전적으로 제어되는 일회성 실행이 필요했으며 백그라운드 프로세스는 허용되지 않았습니다.

성공적인 솔루션: NPM CLI

결국 저는 검증된 NPM CLI를 고수할 수 있다는 것을 깨달았습니다. 단계는 간단했습니다.

1. 레지스트리 A에서 로컬로 패키지를 설치합니다.
   1. 레지스트리 B를 가리키도록 NPM을 재구성합니다.
   2. 패키지를 레지스트리 B에 게시합니다.

이 기능이 매력적이긴 했지만 CI 친화적으로 만들기 위해서는 몇 가지 추가 단계가 필요했습니다.

---

여러 레지스트리에 대한 NPM 구성

CI 파이프라인에서 레지스트리 구성을 동적으로 관리하는 것은 약간 까다로웠습니다.

제가 해결한 방법은 다음과 같습니다.

일반 구성

npm CLI를 사용하여 각 레지스트리에 대한 매개변수를 설정할 수 있습니다.

npm config set "//my.awesome.registry.com:<parameter name>=<parameter value>"

중요 사항:
구성의 URL은 프로토콜(https:)을 제외해야 합니다.

패키지-레지스트리 연결

특정 네임스페이스나 패키지를 레지스트리와 연결하려면:

npm config set "<your namespace>:registry" "<your registry url with https:>"

CI 파이프라인에서 인증 처리

일부 레지스트리에는 사용자 이름/비밀번호 조합이 필요했지만 다른 레지스트리에서는 토큰을 사용했습니다. 제가 배운 내용은 다음과 같습니다.

토큰

토큰은 간단하지만 인증 URL을 구성할 때 프로토콜을 제거해야 합니다.

npm config set "//my.awesome.registry.com:<parameter name>=<parameter value>"

기본 인증

기본 인증 해시(사용자 이름:비밀번호)를 생성하려면 세부적인 주의가 필요했습니다. 일부 배포판에서는 base64 명령에 다른 명령과 다른 특징이 있습니다.

macOS의 경우:

npm config set "<your namespace>:registry" "<your registry url with https:>"

(예상대로) 제공:

npm config set "//my.registry.com:_authToken=<token>"

docker linuxkit 사용:

echo -n "<my username & password hash>" | base64

여기서 무슨 일이 벌어지고 있는 걸까요? 줄바꿈이 있어요!

일부 배포판에서는 개인 키 형식 지정 등을 위해 랩 매개변수의 기본값이 76자로 설정되어 있습니다.

다음과 같이 작동합니다.

d2hhdCBhcmUgeW91IGRvaW5nIGhlcmU/IGdvdCB5YSEgc29tZSBtb3JlIHRleHQgdG8gbWFrZSB0aGlzIHJlYWxseSByZWFsbHkgbG9uZw==

echo -n은 매우 중요합니다. 생략하면 echo는 문자열 끝에 줄 바꿈을 추가하고 이로 인해 해시가 조작됩니다.

완성된 스크립트

모두 종합하면 스크립트는 다음과 같습니다.

d2hhdCBhcmUgeW91IGRvaW5nIGhlcmU/IGdvdCB5YSEgc29tZSBtb3JlIHRleHQgdG8gbWFrZSB0
aGlzIHJlYWxseSByZWFsbHkgbG9uZw==

다음과 같이 사용할 수 있습니다.

echo -n "<my username & password hash>" | base64 --wrap 0

---

배운 주요 교훈

1. 간단한 도구를 고수하세요:
   npm CLI는 이 작업에 적합하지 않을 수도 있지만 안정적이고 작업을 완료합니다.

2. 세부 사항에 유의하세요.
   특히 base64를 사용한 인증 구성에는 플랫폼별로 미묘한 차이가 있을 수 있습니다.

3. CI 친화적으로 유지:
   CI/CD 파이프라인에서 작업할 때 데몬이나 백그라운드 작업과 같은 솔루션을 피하세요. 프로세스를 파이프라인으로 제어하세요.

레지스트리 간 npm 패키지 동기화는 실망스러웠지만 보람 있는 학습 경험이었습니다. 비슷한 문제에 직면하고 있다면 이 강의를 통해 좀 더 쉽게 어려움을 헤쳐나가실 수 있기를 바랍니다!

위 내용은 여러 레지스트리 간에 NPM 패키지 동기화의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!