前言:
很久没发博客,时间进入2022年,更加忙碌更加卷,其实平时积攒了不少笔记,但都没时间转化为博客
2022年主要核心是 vue3 + ts 开发,踩过很多坑,躺过很多雷,后续有空会陆续把 vue3 + ts 学习一些值得分享的内容写出来
创建群组
可以在这里查看群组
群组创建项目
每个项目就是一个独立npm包;这个很重要请记住!!!
项目的创建就比较随意了,不强制要求什么
项目ID等会要用要留意:
项目创建令牌
官网个人访问令牌详细说明:https://gitlab.com/help/user/profile/personal_access_tokens.md
允许以只读权限访问镜像仓库;(不勾选)
read_package_registry允许对包注册表进行只读访问;(要勾选,不勾选就无法上传更新代码)
write_package_registry允许对包注册表进行读写访问;(要勾选,不勾选就无法上传更新代码)
这个很重要只会出现一次,页面刷新后就没了,所以一定要记得保存下来
接下来到代码编写
在群组里拉取项目(怎么拉不用教了吧):
项目设置身份验证
官网教程:https://gitlab.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 文件
官网教程:https://gitlab.com/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 包
官网教程:https://gitlab.com/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包
设置群组包的下载地址: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
参考文章:
https://gitlab.com/help/user/packages/npm_registry/index.md
https://segmentfault.com/a/1190000005790827