三种搭建npm仓库的方法

2019-12-19 16:18:02

参考地址 在5分钟内搭建企业内部私有npm仓库

下面通过三种方法来搭建公司私有npm仓库,每种方式都有自己的优势。

Node.js >= 6.11.3,我的Node版本:node v8.2.1
Linux or OSX,我的系统版本:CentOS Linux release 7.2.1511 (Core)

教程归档在我的Github中欢迎修正和Star

cnpm搭建

安装

npm install -g --build-from-source cnpmjs.org cnpm sqlite3# 如果报错或者警告通过下面方式安装npm install -g --unsafe-perm --verbose --build-from-source cnpmjs.org cnpm sqlite3

如果安装不流畅通过下面形式安装:

npm install -g --build-from-source \
  --registry=https://registry.npm.taobao.org \
  --disturl=https://npm.taobao.org/mirrors/node \
  cnpmjs.org cnpm sqlite3

如果报警告或者安装错误,请添加参数--unsafe-perm --verbose

启动并配置服务

管理员:myname,othername
范围:my-company-name,other-name
默认端口:7001-registry, 7002-web

启动服务

$ nohup cnpmjs.org start --admins='myname,othername' \
  --scopes='@my-company-name,@other-name' &

设置注册地址

将cnpm默认注册地址更改为私有注册地址

cnpm set registry http://localhost:7001

登录cnpm

$ cnpm login
Username: myname
Password: ***
Email: (this IS public) test@test.com

包上传到私有仓库

新建项目

$ cd /tmp
$ mkdir helloworld && cd helloworld
$ cnpm init
name: (helloworld) @my-company-name/helloworldversion: (1.0.0)

{  "name": "@my-company-name/helloworld",  "version": "1.0.0",  "description": "my first scoped package",  "main": "index.js",  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"
  },  "author": "",  "license": "ISC"}

上传到私有仓库

$ cnpm publish
+ @my-company-name/helloworld@1.0.0

查看预览包

浏览器中预览

open http://localhost:7002/@my-company-name/helloworld

使用cnpm预览

cnpm info

安装

所有公共包都可直接使用cnpm安装

cnpm install hotkeys-js

通过verdaccio搭建

verdaccio 是一个轻量级的私有npm代理注册。(sinopia fork)

安装

# 使用 npm 安装npm install -g npm# 使用 yarn 安装yarn global add verdaccio

启动服务

verdaccio >> verdaccio.log 2>&1 & # 后台启动并写入日志# Verdaccio doesn't need superuser privileges. Don't run it under root.# warn --- config file  - /root/.config/verdaccio/config.yaml# warn --- http address - http://localhost:4873/ - verdaccio/2.3.6verdaccio --listen 4000 --config ./config.yaml # 指定配置启动

添加用户/登录

npm adduser --registry http://localhost:4873

上传私有包

npm publish --registry http://localhost:4873

本地配置注册地址

npm config list -l # 查看默认配置# 将默认地址 https://registry.npmjs.org/ 改成私有地址npm set registry http://localhost:4873# 如果您使用HTTPS,请添加适当的CA信息#(“null”表示从操作系统获取CA列表)$ npm set ca null

Git仓库当私有npm

这个方法得益于,npm提供的的丰富安装方法。通过下面方法安装:

npm i -S git+ssh://git@git.showgold.cn:npm/hello.git

npm install -S git+ssh://git@github.com:npm/npm.git#v1.0.27npm install -S git+ssh://git@github.com:npm/npm#semver:^5.0npm install -S git+https://isaacs@github.com/npm/npm.git
npm install -S git://github.com/npm/npm.git#v1.0.27

⚠️ 上面安装需要注意:你的工程一定是在某一个组下面建立,方便管理,在生成你的包的时候package.json中的name一定要带上范围

建立一个私有模块

# 假设你建立了一个Git仓库,先克隆下来git clone http://git.your-inc.com/companyfe/hello-private.git# 生成 `package.json` 配置, 注意限定 `@scope` 范围npm init --scope=companyfe# 提交到仓库git push origin master

⚠️ 将得到如下依赖,注意:

name字段必须限定范围,一般为 GitLab group 的名字, 例如 @companyfe, 那么 name 为: @companyfe/hello-private
private 设为 true 防止将私有模块上传到公网上去,需要手动设置一下。
{  "name": "@companyfe/hello-private",  "version": "1.0.1",  "description": "",  "main": "index.js",  "private":true,  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"
  },  "author": "kenny wang <wowohoo@qq.com> (http://wangchujiang.com)",  "license": "ISC"}

安装使用私有模块

跟安装开源的模块一样, 使用 npm install 安装依赖即可. 私有模块会安装在 @scope 的子文件夹中, 例如: node_modules/@companyfe/hello-private.

# 基础安装npm i -S git+ssh://git@git.your-inc.com/companyfe/hello-private.git# 带版本信息的,必须通过 git 打 tagnpm i -S git+ssh://git@git.your-inc.com/companyfe/hello-private.git#v1.2.0

将得到如下依赖

{  "name": "helloworld",  "version": "1.0.0",  "description": "",  "main": "index.js",  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"
  },  "dependencies": {    "@companyfe/hello-private": "git+ssh://git@git.your-inc.com/companyfe/hello-private.git#v1.2.0"
  },  "author": "kenny wang <wowohoo@qq.com> (http://wangchujiang.com)",  "license": "ISC"}

使用私有模块

var hello = require('@companyfe/hello-private');

优劣势

不好的地方是,使用 npm update 是无法更新私有模块,想更新只能重新安装一次。好处是不用搭建服务。


  • 2019-11-21 18:13:08

    如何在vue单页应用中使用百度地图

    百度开发者平台已经封装了基于vue的地图组件,详细使用,请参考官网: https://dafrok.github.io/vue-baidu-map/#/zh/start/installation 网上有一些是直接在index.html页面全部引用的,本人强烈反对此种使用方式,因为我们项目是组件化的单页应用,强行引入多页应用的开发方式,会破坏整个项目的框架,严重影响性能。有些甚至还在vue单页应用中引入jquery,感觉这都是一些反人类的骚操作,不到万不得已,不建议使用。

  • 2019-11-25 17:04:10

    Throttle 和 Debounce 的本质及一个简单的实现

    Throttle,Debounce 就不把这两个词翻译成中文了,直接解释他们的概念。实际上这两个东西本质上是一样的,作用都是「为了避免某个『事件』在『一个较短的时间段内』内连续被触发从而引起的其对应的『事件处理函数』不必要的连续执行」。那么区别在哪呢?

  • 2019-11-25 17:05:44

    js实现 throttle 和 debounce,节流,防抖详解

    throttle 节流:drag改变浏览器大小,触发onresize函数,实现拖动每过1秒输出一次,不足1秒,1秒后输出一次。多用于高频操作,如抢票、抢购等,无论点击多少次,只固定间隔执行一次,以减轻压力。debounce防抖:drag改变浏览器大小,触发onresize函数,实现拖动停顿1秒输出。多用于输入框,当某一次输入后停顿满n秒才会去触发远程搜索。

  • 2019-11-25 17:37:01

    百度地图GeoUtils示例

    百度地图JavaScript开源库,是一套基于百度地图API二次开发的开源的代码库。目前提供多个lib库,帮助开发者快速实现在地图上添加Marker、自定义信息窗口、标注相关开发、区域限制设置、几何运算、实时交通、检索与公交驾车查询、鼠标绘制工具等功能。