在多個登錄機碼之間同步 NPM 包

照片由 Nicolas Radzimski 在 Unsplash 拍攝

問題

我們的團隊依賴內部 GitLab NPM 註冊表來管理套件。這非常適合內部分發，但在某些情況下需要與外部協作者共用套件。將套件從內部註冊表同步到外部註冊表成為一項新的挑戰。

我開始尋找解決方案，但像往常一樣，遇到了一系列障礙，這使我的開發者鬥爭變成了又一章。

試試 1：使用 HTTP 請求模仿 NPM CLI

最初，我認為我可以使用原始 HTTP 請求來處理這個問題，本質上是模仿 NPM CLI 在幕後所做的事情。這個想法很簡單：查詢來源註冊表中的包元數據，獲取 tarball，並將其上傳到目標註冊表。

為什麼失敗：

• 過程過於複雜且脆弱。
• 它需要為每個版本手動建立整個package.json 清單。
• 每一個小失誤都會造成包裹破損。

試試 2：利用 npm-registry-sync

接下來，我發現了 npm-registry-sync，一個專為同步 NPM 註冊表而設計的函式庫。這個工具幾乎解決了這個問題；它可以監控更改並跨註冊表複製它們。

為什麼它對我不起作用：

• 它以「守護程式模式」運行，並不斷輪詢更新。
• 在 GitLab CI 管道中，我需要一次執行，完全由管道控制 — 不允許後台程序。

獲勝解決方案：NPM CLI

最終，我意識到我可以堅持使用久經考驗的 NPM CLI。步驟很簡單：

1. 從註冊表 A 本地安裝軟體包。
   1. 重新配置 NPM 以指向註冊表 B。
   2. 將套件發佈到Registry 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

這是怎麼回事？換行了！

在某些發行版上，wrap 參數預設為 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中文網其他相關文章！