cloudoll 是微服务的依赖类库,籍由此项目,可以迅速创建可伸缩的微服务,
cloudoll 同时提供了许多现成的工具解决实际项目中的各种问题。
使用方法:
npm i cloudoll --save
以下是一篇完整使用 cloudoll 编写微服务的入门文章。
本文章中一套完整的分布式微服务有如下三种角色:
-
微服务提供者:hello_word 及其所有的克隆体
-
微服务的注册中心:cloudeer-server-rest
-
消费者:wow
创建一个目录:hello_world,cd 进去之后输入命令行 npm init。
引入 cloudoll 包
npm i cloudoll --save
在项目根目录下创建一个入口文件 /index.js,代码内容如下:
require('cloudoll').KoaApplication();
创建文件 /api/open/hello.js
module.exports = {
world: function *() {
this.echo("你好世界。form port: " + process.env.port );
}
};
现在启动服务:
node index.js
现在访问一下试试
http://localhost:3000/open/hello/world
这部分可以使用 cloudoll-server 项目,相应的配置文件的节点更换成 tcp
从 git 上 下载源码:
git clone https://github.com/cloudoll/cloudoll-server-rest
进入到目录,进行 node 前戏工作 。
npm install
手工创建一个 /data 的目录用来存储数据。
运行:
node index.js
无需改动 cloudeer 任何代码。
打完收工!
好了,接下来,我们把第一步中写的程序变成可以被分布部署的微服务。
创建一个文件: /config/development.js
注意:在第一步创建的那个项目下哦,嫑搞错位置了。
内容如下:
module.exports = {
app_name : "hello_world",
my_host : "127.0.0.1",
debug : true,
port : 3000,
cloudeer :{
type : 'rest', //支持 'rest', 'tcp'
host : '127.0.0.1', //这个是注册中心的地址
port : 8801
},
};
其中 cloudeer 节点的配置会将这个应用变成分布式的微服务。
my_host 可以不用指定,他会寻找当前机器的内网地址。
现在重启一下咯。
现在访问注册中心看看:
和
这个时候注册中心应该列出了微服务实例和方法的列表。
好像很简单呀!
万里长征才走完第一步。
如果感兴趣请继续。
现在创建另一个微服务,步骤和前面的 hello_world 一样。
你可以直接拷贝过来。但需要改一些关键的地方。
修改配置文件: /config/development.js:
将 app_name 改成另一个, 现在改成 wow, 这样他才会变成另一个微服务。
修改端口 port 为 3002。
module.exports = {
app_name : "hello_world",
my_host : "127.0.0.1",
debug : true,
port : 3002,
cloudeer :{
type : 'rest', //支持 'rest', 'tcp'
host : '127.0.0.1',
port : 8801
},
};
修改 /api/open/hello.js 输出远程的调用结果。
module.exports = {
world: function *() {
var res = yield this.getCloudeer("hello_world", "/open/hello/world");
this.echo("来自远方的问候: " + res);
}
};
启动服务:
node index.js
看看控制台的输出 http 端口,类似下面的输出。
Koa Application 正在启动,尝试端口:3002
Koa Application 启动成功!端口: 3002
并在浏览器里看看 http://localhost:3002/open/hello/world
多次拷贝 hello_world 项目,更换 port 的值。注意 port 不要重复。
如果你有多个机器,可以使用多机部署,但需要调整正确的 ip 地址。
然后分别执行:
node index.js
现在你可以去并发执行 wow 的 /open/hello/world 了。
在浏览器中不断的刷新 http://localhost:3002/open/hello/world 就可以看到结果。
例子中用端口表示了他是从哪个微服务上访问过来的。