照片由 Nicolas Radzimski 在 Unsplash 上拍摄
我们的团队依赖内部 GitLab NPM 注册表来管理包。这非常适合内部分发,但在某些情况下需要与外部协作者共享包。将包从内部注册表同步到外部注册表成为一项新的挑战。
我开始寻找解决方案,但像往常一样,遇到了一系列障碍,这使我的开发者斗争变成了又一章。
最初,我认为我可以使用原始 HTTP 请求来处理这个问题,本质上是模仿 NPM CLI 在幕后所做的事情。这个想法很简单:查询源注册表中的包元数据,获取 tarball,并将其上传到目标注册表。
• 过程过于复杂且脆弱。
• 它需要为每个版本手动构建整个package.json 清单。
• 每一个小失误都会导致包裹破损。
接下来,我发现了 npm-registry-sync,一个专为同步 NPM 注册表而设计的库。这个工具几乎解决了这个问题;它可以监控更改并跨注册表复制它们。
• 它以“守护程序模式”运行,不断轮询更新。
• 在 GitLab CI 管道中,我需要一次性执行,完全由管道控制 — 不允许后台进程。
最终,我意识到我可以坚持使用久经考验的 NPM CLI。步骤很简单:
虽然这很神奇,但需要一些额外的步骤才能使其对 CI 友好。
在 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:>"
一些注册表需要用户名/密码组合,而其他注册表则使用令牌。这是我学到的:
令牌很简单,但请确保在配置身份验证 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
坚持使用简单的工具:
npm CLI 可能不太适合这项任务,但它很可靠并且可以完成工作。
注意细节:
配置身份验证,尤其是使用 Base64,可能会出现微妙的特定于平台的怪癖。
保持 CI 友好:
在 CI/CD 管道中工作时,避免使用守护进程或后台任务等解决方案。让流程处于管道控制之下。
在注册表之间同步 npm 包是一次令人沮丧但有益的学习经历。如果您面临类似的挑战,我希望这些课程可以帮助您更轻松地度过难关!
以上是在多个注册表之间同步 NPM 包的详细内容。更多信息请关注PHP中文网其他相关文章!