【Gitlab CI/CD】发布 npm 包到 Gitlab 私有仓库遇到的关于 scope 的问题

• #gitlab

之前我写过一篇关于将 npm 包发布到 Gitlab 私有仓库 的文章。最近在项目中遇到一个新问题：当需要管理多个私有包时，.npmrc 的配置会出现冲突。

如果只有一个私有包，配置很简单。但如果有两个或更多同属一个 scope 的包，例如：

@dkvirus/pkg1
@dkvirus/pkg2

在 .npmrc 中需要分别配置：

@dkvirus:registry=https://gitlab.com/api/v4/projects/<pkg1_project_id>/packages/npm/
//gitlab.com/api/v4/projects/<pkg1_project_id>/packages/npm/:_authToken=<pkg1_access_token>
@dkvirus:registry=https://gitlab.com/api/v4/projects/<pkg2_project_id>/packages/npm/
//gitlab.com/api/v4/projects/<pkg2_project_id>/packages/npm/:_authToken=<pkg2_access_token>

由于 @dkvirus 这个 scope 相同，后一个配置会覆盖前一个，导致始终只有一个配置生效。

解决方法主要有两种

方法一：使用 Gitlab 组（Groups）级配置

如果这些项目归属于同一个 Gitlab 组（Group），可以用组级配置替代项目级配置。
这样即使未来添加 @dkvirus/pkg3、@dkvirus/pkg4 等更多包，也无需改动配置。

@dkvirus:registry=https://gitlab.com/api/v4/groups/<group_id>/-/packages/npm/
//gitlab.com/api/v4/groups/<group_id>/-/packages/npm/:_authToken=<group_access_token>

注意：Gitlab Free 版本不支持创建 Groups Access Token，需要升级到 Premium 或 Ultimate 版本。如果是自建 Gitlab 实例则不受此限制。

方法二：修改私有包的 scope

手动将每个包的 scope 改为不同的值，例如：
• 将 @dkvirus/aaa 改为 @dkvirus-aaa/aaa
• 将 @dkvirus/bbb 改为 @dkvirus-bbb/bbb

这种方法较为繁琐，每新增一个包都需要设定一个独特的 scope 值，对于有代码整洁需求的人来说并不友好。

对比一下：

整齐统一的 scope 命名：

@dkvirus/aaa
@dkvirus/bbb
@dkvirus/ccc

修改后显得杂乱的 scope 命名：

@dkvirus-aaa/aaa
@dkvirus-bbb/bbb
@dkvirus-ccc/ccc

综合来看，如果条件允许，推荐使用方法一（组级配置），它更优雅且便于长期维护。

↶ 返回首页 ↶