内容简介:CPM 是一套轻量且基础功能完善的私有Node包管理源。它是基于 clusic 的 rex 架构开发,拥有进程负载均衡的特点。它主要提供一整套简易安装模式,用户只需要clone此项目到本地,修改config文件夹下的文件即可运行。它的数据源基于mysql数据库和redis缓存(支持redis集群),能够有效提高NPM包的下载速度。它还拥有自定义用户系统接入的功能,让企业可以自主接入自己的用户体系,同时可以根据用户的scopes来确定用户提交私有包的权限。详细请移步这里CPM搭建的前提条件是:
CPM 是一套轻量且基础功能完善的私有Node包管理源。它是基于 clusic 的 rex 架构开发,拥有进程负载均衡的特点。它主要提供一整套简易安装模式,用户只需要clone此项目到本地,修改config文件夹下的文件即可运行。它的数据源基于 mysql 数据库和 redis 缓存(支持redis集群),能够有效提高NPM包的下载速度。它还拥有自定义用户系统接入的功能,让企业可以自主接入自己的用户体系,同时可以根据用户的scopes来确定用户提交私有包的权限。
文档
详细请移步这里
预览
搭建
CPM搭建的前提条件是:
- Nodejs >= 8.0.0
- MySQL >= 5.6.16
- Redis 无限制
请先搭建好以上的环境。
下载
我们需要从 Github 下载我们的程序。
$ git clone https://github.com/cevio/cpm.git 复制代码
请下载稳定的master分支,其他分支仅开发使用,不建议下载。下载完毕后打开 database.sql
文件,创建mysql数据库。
依赖
安装必要的依赖,以便我们可以验证程序是否可以启动。
$ npm i -g @clusic/cli pm2 $ cd cpm $ npm i 复制代码
@clusic/cli
是clusic架构的开发工具。
开发调试
$ npm run dev 复制代码
安装完毕依赖,我们即可以启动程序。但是你会发现报错,因为我们没有指定用户验证体系。
Error: You should setup your own `UserService` first at module.exports (/Users/shenyunjie/code/mzftech/cpm/app.bootstrap.js:7:11) at WorkerService.createService (/Users/shenyunjie/code/mzftech/cpm/node_modules/@clusic/rex/lib/app.js:106:15) at process._tickCallback (internal/process/next_tick.js:68:7) at Function.Module.runMain (internal/modules/cjs/loader.js:744:11) at startup (internal/bootstrap/node.js:285:19) at bootstrapNodeJSCore (internal/bootstrap/node.js:739:3) 复制代码
请不要紧张,这是非常正常的。
修改配置
配置有两个地方需要修改:
- config/config.{env}.js
{env}
表示你的环境变量,一般开发是config.development.js
,生产环境是config.production.js
。你可以自由修改参数配置。注意registryHost
属性必须修改为你自己的http://127.0.0.1:7002
,否则下载包会报错,如果上线后,请直接修改为你的域名,比如http://npm.example.com
。 - config/plugin.{env}.js
{env}
同上。一般是用来配置插件的数据,这里我们需要根据环境不通来修改mysql
和redis
的数据配置。注意,redis如果需要支持集群模式,请将redis的配置下面的options
编程一个等价数据结构的数组即可。
完成上面修改后,我们仅需要支持下用户即可。
用户体系
用户体系分两个函数需要实现:
Login() User()
我们需要运行命令:
$ clusic add authorization --service 复制代码
程序的 app/service/
下面会自动创建一个文件叫 authorization.js
,这个文件就是我们的用户体系文件。
为了测试启动,我们可以直接复制下面代码来快速创建用户体系函数:
const { ContextComponent } = require('@clusic/method'); module.exports = class AuthorizationService extends ContextComponent { constructor(ctx) { super(ctx); } async Login(account, password) { return { account: account, name: account, email: account + '@cpm.com', avatar: 'https://i.loli.net/2017/08/21/599a521472424.jpg', scopes: ['@' + account, '@html5', '@node'], extra: {} } } async User(account) { return { account: account, name: account, email: account + '@cpm.com', avatar: 'https://i.loli.net/2017/08/21/599a521472424.jpg', scopes: ['@' + account, '@html5', '@node'], extra: {} } } }; 复制代码
保存后,你可以在项目根目录下通过以下命令启动查看:
$ npm run dev 复制代码
打开 http://127.0.0.1:7002
即可看到我们的页面。恭喜你,那么你可以使用CPM了。
命令支持
CPM支持以下的命令组合:
$ npm login --registry=http://npm.test.cn $ npm logout --registry=http://npm.test.cn $ npm install (with no args, in package dir) --registry=http://npm.test.cn $ npm install [<@scope>/]<name> --registry=http://npm.test.cn $ npm install [<@scope>/]<name>@<tag> --registry=http://npm.test.cn $ npm install [<@scope>/]<name>@<version> --registry=http://npm.test.cn $ npm install [<@scope>/]<name>@<version range> --registry=http://npm.test.cn $ npm install <git-host>:<git-user>/<repo-name> --registry=http://npm.test.cn $ npm install <git repo url> --registry=http://npm.test.cn $ npm install <tarball file> --registry=http://npm.test.cn $ npm install <tarball url> --registry=http://npm.test.cn $ npm install <folder> --registry=http://npm.test.cn $ npm update [-g] [<pkg>...] --registry=http://npm.test.cn $ npm uninstall [<@scope>/]<pkg>[@<version>]... [-S|--save|-D|--save-dev|-O|--save-optional|--no-save] --registry=http://npm.test.cn $ npm publish [<tarball>|<folder>] [--tag <tag>] [--otp otpcode] [--dry-run] --registry=http://npm.test.cn $ npm unpublish [<@scope>/]<pkg>[@<version>] --registry=http://npm.test.cn $ npm whoami [--registry <registry>] --registry=http://npm.test.cn $ npm owner add <user> [<@scope>/]<pkg> --registry=http://npm.test.cn $ npm owner rm <user> [<@scope>/]<pkg> --registry=http://npm.test.cn $ npm owner ls [<@scope>/]<pkg> --registry=http://npm.test.cn $ npm deprecate <pkg>[@<version>] <message> --registry=http://npm.test.cn $ npm view [<@scope>/]<name>[@<version>] --registry=http://npm.test.cn $ npm dist-tag add <pkg>@<version> [<tag>] --registry=http://npm.test.cn $ npm dist-tag rm <pkg> <tag> --registry=http://npm.test.cn $ npm dist-tag ls [<pkg>] --registry=http://npm.test.cn $ npm access public [<package>] --registry=http://npm.test.cn $ npm access restricted [<package>] --registry=http://npm.test.cn 复制代码
对于内部私有包而言,这些命令已经足够使用,如果需要扩展,可以自行扩展,或者在 Github 上提Issue给我,我酌情考虑添加升级。
简化命令
在每个命令后面写上 --registry=http://npm.test.cn 比较繁琐,那么我们可以自己生成一个命令叫cpm简化它。你可以通过yeoman 开始创建你们的CPM命令:
const childProcess = require('child_process'); const argv = process.argv.slice(2); argv.push('--registry=http://npm.test.cn'); childProcess.spawn('npm', argv, { stdio: 'inherit' }); 复制代码
请修改上面的 http://npm.test.cn
为你自己的服务地址。
原理是在我们通过 cpm
命令代替 npm
命令的时候,在命令的最末尾加上一个 --registry=http://npm.test.cn
指向我们的 Registry。
我们完全可以用 cpm
代替掉 npm
了。比如
$ cpm login $ cpm install vue $ cpm publish 复制代码
其他简化命令的方法有很多,你可以下载 npm install nrm -g
等来切换。
深入用户体系
上面有一串测试用的代码,我们来剖析下。不论是 Login
还是 User
函数都返回如下的数据结构:
string string string string array
至于 extra
是额外参数,可以随意传,作用在web界面上。而 scope
,你可以通过自己的逻辑代码给不同用户提供可以上传的 scopes
作用域。
scopes作用域作用结果都是在用户执行 cpm login
后生效。如果你改动过代码,需要用户重新登录生效。
上线
上线生成环境需要将 production
配置完整才能上线,上到服务器后运行命令:
$ npm run start 复制代码
更新
考虑到一般企业拥有自己的gitlab,当然会clone一份到自己的仓库,所以请在clone后执行 rm -rf .git
,清除源仓库的引用。你可以提交本程序到你自己的仓库。更新的时候只需要运行
npm run update 复制代码
执行完毕这个命令,我们会从github上将master分支的代码通过zip包模式下载,覆盖到本地,当然这是全量覆盖的。由于您的git仓库的存在,所以可以对比出修改了哪些文件,你可以revert或者自己处理非app/下的文件内容,一般都是配置。然后修改提交上线即可。
如果是在线上,当然是 git pull
拉去你已经本地更新好的文件,然后通过命令:
$ npm run restart 复制代码
以上所述就是小编给大家介绍的《CPM - 轻量的NPM私有源程序搭建》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!
猜你喜欢:本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
JUnit Recipes中文版
陈浩等译 / 电子工业 / 2006-9 / 69.00元
《JUnit Recipes中文版:程序员实用测试技巧》主要介绍了在Java开发中使用JUnit进行单元测试的各种方法、原则、技巧与实践。本书出自开发一线专家之手,本着实用的原则,涵盖各类Java开发中应用JUnit的实用技巧,内容丰富、全面深入;无论对于需要应用JUnit进行单元测试的一线Java开发人员,还是JUnit入门、进阶者,本书都是一本不可多得的实用指南。这本书介绍了大量的JUnit实......一起来看看 《JUnit Recipes中文版》 这本书的介绍吧!