likes
comments
collection
share

配置文件.npmrc优先级之在CI/CD工作流中私有NPM仓库使用

作者站长头像
站长
· 阅读数 38
.npmrc是npm运行时配置文件,简单点说.npmrc可以设置package.json中依赖包的安装来源既从哪里下载依赖包,也可以配置token秘钥方便从私有的NPM仓库拉取安装包;npm、cnpm、pnpm、yarn都是在干一件事用起来没啥大区别,据说现在最好用的就是pnpm,下面的操作中都可以用pnpm代替npm,前提需要安装了pnpm;在上线部署的CI/CD中配置的话,没有必要用pnpm,pnpm适用于本地开发;什么是CI/CD呢?其实就是流水线容器化部署,自动拉取代码自动打包自动部署这一套;

pnpm安装

# 全局安装pnpm,都说它好用就装上直接用呗
npm install -g pnpm

配置文件.npmrc优先级

电脑系统中可能会存在多个.npmrc文件,在我们安装依赖包时,npm会按照如下顺序读取配置文件,也就是优先级;

  1. 项目配置文件: /project/.npmrc
  2. 用户配置文件:~/.npmrc
  3. 全局配置文件:/etc/npmrc

配置.npmrc

.npmrc文件里面以key=value的格式进行配置;

1、国内镜像源,在国内用国内的源速度飞起;

中国镜像站
搜索地址:https://npmmirror.com/
registry地址:https://registry.npmmirror.com

2、使用私有仓库,阿里云效“制品仓库”免费提供私有NPM管理(如果使用其它私有操作基本一样);

使用私有仓库是原因大部分是有一些业务上的封装,从公司安全角度考虑不能使用公共仓库托管,使用了私有仓库不会影响原来公共源的拉取使用,私有仓库提供方(阿里云效)都给处理好了,我们也不用管;如果使用了私有仓库,但是没有配置好凭证,npm install 就会报错;
#访问链接,可以根据操作步骤提示操作
https://packages.aliyun.com/npm/npm-registry/guide
#设置镜像源,相当于在`~/.npmrc`文件中配置了镜像源,下面截图第一行
npm config set registry=https://packages.aliyun.com/*******/npm/npm-registry/
#登陆npm仓库并设置凭证
npm login
#输入阿里云效提供的用户名、密码和邮箱后,相当在`~/.npmrc`增加了私有访问令牌,下面截图第二行`_authToken`后面的值就是令牌token请妥善保管
//??????/:_authToken=0000-0000000-0000-0000

在CI/CD工作流中使用私有包

私有仓库配置完后,系统家目录下会创建好.npmrc配置文件“~/.npmrc”,但是如果是在CI/CD中使用配置文件最好是放在项目录下,项目目录下的配置文件优先级也最高;
# `请注意:这波操作相当于把你的秘钥token暴露在了项目目录下,是存在安全隐患的`
# 复制一下就好,就是把创建好的配置文件复制到自己的项目目录下
cp ~/.npmrc /project/

保护您的令牌

你的令牌可能有权读取专用包、代表你发布新包或更改用户或包设置;不要将令牌添加到版本控制中或以不安全的方式存储令牌;将其存储在密码管理器、云提供商的安全存储或 CI/CD 提供商的安全存储中;
# 编辑`.npmrc`文件,将`_authToken=`后面token用环境变量代替
//???????/:_authToken=${NPM_TOKEN}

# 使用`export`可以声明环境变量
export NPM_TOKEN=0000-0000000-0000-0000
# 实际开发是,每次都export一下也不现实,所以需要一劳永逸,写在`.zshrc`、`.bash_profile`

echo export NPM_TOKEN=0000-0000000-0000-0000 >> ~/.zshrc

CI/CD中的配置

配置文件.npmrc优先级之在CI/CD工作流中私有NPM仓库使用划重点:个人基本上等于免费使用,还有服务器资源赠送,免费的羊毛撸起来!网址:https://code-galaxy.net


  • 基于Galaxy的流水线配置如下,如果使用的是其它CI/CD工具,基本上类似;
  • Galaxy学习成本接近于0;

1、git-clone,克隆代码;2、depend-install,依赖安装;

npm install -g pnpm --registry=https://registry.npmmirror.com \
&& node -v \
&& npm -v \
&& pnpm -v \
&& export NPM_TOKEN=0000-0000000-0000-0000 \
&& pnpm install \
&& pnpm run build:dev

3、dockerfile-generator,生成Dockerfile;4、build-push-image,生成可以部署的镜像;