原文连接:https://xcoder.in/2016/07/09/lets-cnpm-base-deploy/javascript
本章会介绍 CNPM 的基础部署方法。前端
该文章所对应的 cnpm 目标版本为 v2.12.2,上下浮动一些兼容的版本问题也都不是特别大。java
想要部署 CNPM,你须要作如下的一些准备。node
部署的宿体,如服务器、云主机、本身的电脑等;mysql
数据库,支持 MySQL、PostgreSQL、MariaDB,若是使用 SQLite 则无需准备;git
Git 客户端(推荐)。github
首先在本地选择一个目录,好比我将它选择在 /usr/app
,而后预想 CNPM 的目录为 /usr/app/cnpm
,那么须要在终端 $ cd /usr/app
。web
接下去执行 Git 指令将 CNPM 克隆到相应目录。sql
$ git clone https://github.com/cnpm/cnpmjs.org.git
Windows 用户也能够用相似 Cygwin、MinGW、Powershell 甚至直接是 Command 等来运行 Git。shell
固然也能够直接下载一些 GUI 工具来克隆,如 SourceTree。
跑到 CNPM 的 Release 页面,选择相应的版本下载,好比这里会选择 v2.12.2 版。
下载完毕后将文件夹解压到相应目录便可。
安装依赖其实就是一个 npm install
,不过 CNPM 把该指令已经写到 Makefile 里面了,因此直接执行下面的命令就行了。
$ make install
固然万一你是 Windows 用户或者不会 make
,那么仍是要用 npm install
。
$ npm install --build-from-source --registry=https://registry.npm.taobao.org --disturl=https://npm.taobao.org/mirrors/node
新建一份 config/config.js
文件,而且写入以下的骨架:
'use strict'; module.exports = { };
在这里面输入你须要的键值对。
这里将会列举一些经常使用的配置项,其他的一些配置项请自行参考 config/index.js 文件。
enableCluster
:是否启用 cluster-worker 模式启动服务,默认 false
,生产环节推荐为 true
;
registryPort
:API 专用的 registry 服务端口,默认 7001
;
webPort
:Web 服务端口,默认 7002
;
bindingHost
:监听绑定的 Host,默认为 127.0.0.1
,若是外面架了一层本地的 Nginx 反向代理或者 Apache 反向代理的话推荐不用改;
sessionSecret
:session 用的盐;
logdir
:日志目录;
uploadDir
:临时上传文件目录;
viewCache
:视图模板缓存是否开启,默认为 false
;
enableCompress
:是否开启 gzip 压缩,默认为 false
;
admins
:管理员们,这是一个 JSON Object
,对应各键名为各管理员的用户名,键值为其邮箱,默认为 { fengmk2: 'fengmk2@gmail.com', admin: 'admin@cnpmjs.org', dead_horse: 'dead_horse@qq.com' }
;
logoURL
:Logo 地址,不过对于我这个已经把 CNPM 前端改得面目全非的人来讲已经忽略了这个配置了;
adBanner
:广告 Banner 的地址;
customReadmeFile
:实际上咱们看到的 cnpmjs.org 首页中间一大堆冗长的介绍是一个 Markdown 文件转化而成的,你能够设置该项来自行替换这个文件;
customFooter
:自定义页脚模板;
npmClientName
:默认为 cnpm
,若是你有本身开发或者 fork 的 npm 客户端的话请改为本身的 CLI 命令,这个应该会在一些页面的说明处替换成你所写的;
backupFilePrefix
:备份目录;
database
:数据库相关配置,为一个对象,默认若是不配置将会是一个 ~/.cnpmjs.org/data.sqlite
的 SQLite;
db
:数据的库名;
username
:数据库用户名;
password
:数据库密码;
dialect
:数据库适配器,可选 "mysql"
、"sqlite"
、"postgres"
、"mariadb"
,默认为 "sqlite"
;
hsot
:数据库地址;
port
:数据库端口;
pool
:数据库链接池相关配置,为一个对象;
maxConnections
:最大链接数,默认为 10
;
minConnections
:最小链接数,默认为 0
;
maxIdleTime
:单条连接最大空闲时间,默认为 30000
毫秒;
storege
:仅对 SQLite 配置有效,数据库地址,默认为 ~/.cnpmjs/data.sqlite
;
nfs
:包文件系统处理对象,为一个 Node.js 对象,默认是 [fs-cnpm]() 这个包,而且配置在 ~/.cnpmjs/nfs
目录下,也就是说默认全部同步的包都会被放在这个目录下;开发者可使用别的一些文件系统插件(如上传到又拍云等),又或者本身去按接口开发一个逻辑层,这些都是后话了;
registryHost
:暂时还未试过,我猜是用于 Web 页面显示用的,默认为 r.cnpmjs.org
;
enablePrivate
:是否开启私有模式,默认为 false
;
若是是私有模式则只有管理员能发布包,其它人只能从源站同步包;
若是是非私有模式则全部登陆用户都能发布包;
scopes
:非管理员发布包的时候只能用以 scopes
里面列举的命名空间为前缀来发布,若是没设置则没法发布,也就是说这是一个必填项,默认为 [ '@cnpm', '@cnpmtest', '@cnpm-test' ]
,据苏千大大解释是为了便于管理以及让公司的员工自觉按需发布;更多关于 NPM scope 的说明请参见 npm-scope;
privatePackages
:就如该配置项的注释所述,出于历史包袱的缘由,有些已经存在的私有包(可能以前是用 Git 的方式安装的)并无以命名空间的形式来命名,而这种包原本是没法上传到 CNPM 的,这个配置项数组就是用来加这些例外白名单的,默认为一个空数组;
sourceNpmRegistry
:更新源 NPM 的 registry 地址,默认为 https://registry.npm.taobao.org
;
sourceNpmRegistryIsCNpm
:源 registry 是否为 CNPM,默认为 true
,若是你使用的源是官方 NPM 源,请将其设为 false
;
syncByInstall
:若是安装包的时候发现包不存在,则尝试从更新源同步,默认为 true
;
syncModel
:更新模式(不过我以为是个 typo
),有下面几种模式能够选择,默认为 "none"
;
"none"
:永不一样步,只管理私有用户上传的包,其它源包会直接从源站获取;
"exist"
:定时同步已经存在于数据库的包;
"all"
:定时同步全部源站的包;
syncInterval
:同步间隔,默认为 "10m"
即十分钟;
syncDevDependencies
:是否同步每一个包里面的 devDependencies
包们,默认为 false
;
badgeSubject
:包的 badge 显示的名字,默认为 cnpm
;
userService
:用户验证接口,默认为 null
,即无用户相关功能也就是没法有用户去上传包,该部分须要本身实现接口功能并配置,如与公司的 Gitlab 相对接,这也是后话了;
alwaysAuth
:是否始终须要用户验证,即使是 $ cnpm install
等命令;
httpProxy
:代理地址设置,用于你在墙内源站在墙外的状况。
下面给出一个样例配置:
module.exports = { enableCluster: true, database: { db: "snpm", username: "username", password: "password", dialect: "mysql", host: "127.0.0.1", port: 3306 }, enablePrivate: false, admins: { xadillax: "i@2333.moe" }, syncModel: "exist", nfs: require('upyun-cnpm').create({ bucket: "your bucket", oprator: "your id", password: "your secret" }), scopes: [ '@cheniu', '@souche', '@souche-f2e' ], badgeSubject: 'snpm', privatePackages: [ 'snpm' ] };
上面的配置包文件系统层用的是 upyun-cnpm 插件,须要在 CNPM 源码根目录执行
$ npm install --save -d upyun-cnpm这个时候你的
package.json
就有更改与源 Repo 不一致了,若是是 Git 克隆的用户在之后升级更新系统的时候稍稍注意一下可能的冲突便可。
下面给出几个官方的 NFS 插件:
upyun-cnpm:包本体存在又拍云的插件;
fs-cnpm:包本体存在本地的插件;
sfs-client:包本体存在 SFS(Simple FIle Store)插件;
qn-cnpm:包本体存在七牛的插件;
oss-cnpm:包本体存在阿里云 OSS 的插件。
之后官方若是有一些新的插件进来,这里可能不会更新了,请自行去 NFS Storage Wrappers 获取最新的 NFS 插件们。
若是你使用的是 SQLite 的话,数据库是自动就行了的,能够忽略该步。
其它数据库须要自行导入初始数据库结构。
初始数据库脚本在 docs/db.sql 里面,你能够用一些 GUI 工具将数据导入,也能够直接进入命令行导入。
好比你用的是 MySQL,就能够在本机操做 MySQL。
$ mysql -u yourname -p mysql> use cnpmjs; mysql> source docs/db.sql
搞好配置以后就能够直接启动服务了。
最简单的办法也是我如今正在用的方法就是直接用 node
执行一下入口文件就行了。
$ node dispatch.js
其实我是在 tmux 里面执行上面的指令的。
官方的其它一些指令,好比你能够用 NPM 的 script 来运行。
$ npm run start
在 CNPM 里面,npm script 还有下面几种指令
npm run dev
:调试模式启动;
npm run test
:跑测试;
npm run start
:启动 CNPM;
npm run status
:查看 CNPM 启动状态;
npm run stop
:中止 CNPM。