Gitlab私有npm包构建
前言:
很久没发博客,时间进入2022年,更加忙碌更加卷,其实平时积攒了不少笔记,但都没时间转化为博客
2022年主要核心是 vue3 + ts 开发,踩过很多坑,躺过很多雷,后续有空会陆续把 vue3 + ts 学习一些值得分享的内容写出来
创建群组
可以在这里查看群组
群组创建项目 每个项目就是一个独立npm包;这个很重要请记住!!! 项目的创建就比较随意了,不强制要求什么 项目ID等会要用要留意:
项目创建令牌 官网个人访问令牌详细说明:http://gitlab.cms.syc/help/user/profile/personal_access_tokens.md 允许以只读权限访问镜像仓库;(不勾选) read_package_registry允许对包注册表进行只读访问;(要勾选,不勾选就无法上传更新代码) write_package_registry允许对包注册表进行读写访问;(要勾选,不勾选就无法上传更新代码)
这个很重要只会出现一次,页面刷新后就没了,所以一定要记得保存下来
接下来到代码编写 在群组里拉取项目(怎么拉不用教了吧):
项目设置身份验证 官网教程:https://gitlab.syc-cms.com/help/user/packages/npm_registry/index.md#use-the-gitlab-endpoint-for-npm-packages (基本都是私有公共项目不安全) 当项目是公共:则不需要身份验证。 当项目是私有:须通过包注册表进行身份验证 要进行身份验证,请使用以下方法之一: 使用个人访问令牌或部署令牌进行身份验证 要使用包注册表进行身份验证,您需要个人访问令牌或部署令牌。 项目级 npm 端点:群组内所有项目都可访问 实例级 npm 端点:只有项目自己能访问 本次教程只演示项目级 npm 端点,实例级 npm 端点基本不用 输入命令设置 npm 配置:npm config set -- '//gitlab.syc-cms.com/api/v4/projects/60/packages/npm/:_authToken' "这里填令牌" 1) 字段解释: 1.1) gitlab.syc-cms.com // 公司内部gitlab网址 1.2) 60 // 项目ID 1.3) 人访问令牌
项目根目录创建 .npmrc 文件 官网教程:http://gitlab.cms.syc/help/user/packages/npm_registry/index.md#project-level-npm-endpoint-1 输入以下内容:@syc-web-packages:registry=https://gitlab.cms.syc/api/v4/packages/npm/ 字段解释: 2.1) syc-web-packages // 群组名 2.2) gitlab.syc-cms.com // gitlab网站地址
发布 npm 包 官网教程:http://gitlab.cms.syc/help/user/packages/npm_registry/index.md#publish-an-npm-package 项目 package.json 文件 publishConfig 字段添加以下内容:"@syc-web-packages:registry":"https://gitlab.syc-cms.com/api/v4/projects/60/packages/npm/" 1) 字段解释: 1.1) publishConfig // 决定了我们发布包发布到哪里去,此时发布包就不是往 www.npmjs.com 了 1.2) syc-web-packages // 群组名 1.3) gitlab.syc-cms.com // gitlab网站地址 1.4) 60 // 项目ID 输入命令发布npm包到组:npm publish 每次发布包都要更新版本号: 在这里能看到刚才更新的包: 2) 关于403报错 线上有同名且版本号一致的包则无法上传,gitlab包策略是递增更新不覆盖旧版本,实际上也可以手动删除旧包然后再上传 以上就是npm包的生产上传过程,接下来就是到项目中下载npm包
下载npm包 官网教程:http://gitlab.cms.syc/help/user/packages/npm_registry/index.md#install-a-package 设置群组包的下载地址:npm config set @syc-web-packages:registry https://gitlab.syc-cms.com:8443/api/v4/packages/npm/ 设置群组令牌:npm config set -- '//gitlab.syc-cms.com:8443/api/v4/packages/npm/:_authToken' "群组令牌" 1) 字段解释: 1.1) syc-web-packages // 群组名 1.2) gitlab.syc-cms.com:8443 // gitlab网址:端口 1.3) mnsxssDZgo1X9xirE3TT // 群组令牌 根据群组内的包名下载npm包:npm install @syc-web-packages/test3 参考文章: http://gitlab.cms.syc/help/user/packages/npm_registry/index.md https://segmentfault.com/a/1190000005790827