cloudoll
cloudark share tools
Last updated 10 months ago by cloudbeer .
Apache-2.0 · Repository · Bugs · Original npm · Tarball
$ cnpm install cloudoll 
SYNC missed versions from official npm registry.

cloudoll

cloudoll 是微服务的依赖类库,籍由此项目,可以迅速创建可伸缩的微服务,

cloudoll 同时提供了许多现成的工具解决实际项目中的各种问题。

使用方法:

npm i cloudoll --save

以下是一篇完整使用 cloudoll 编写微服务的入门文章。

从 0 开始创建一个微服务

0. 角色定义

本文章中一套完整的分布式微服务有如下三种角色:

  • 微服务提供者:hello_word 及其所有的克隆体

  • 微服务的注册中心:cloudeer-server-rest

  • 消费者:wow

1. 使用 cloudoll 创建 web 应用

创建一个目录: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

2. 运行注册服务 cloudoll-server-rest

这部分可以使用 cloudoll-server 项目,相应的配置文件的节点更换成 tcp

从 git 上 下载源码:

git clone https://github.com/cloudoll/cloudoll-server-rest

进入到目录,进行 node 前戏工作 。

npm install

手工创建一个 /data 的目录用来存储数据。

运行:

node index.js

访问 http://localhost:8801/view

无需改动 cloudeer 任何代码。

打完收工!

3. 分布式的微服务 hello_world

好了,接下来,我们把第一步中写的程序变成可以被分布部署的微服务。

创建一个文件: /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 可以不用指定,他会寻找当前机器的内网地址。

现在重启一下咯。

现在访问注册中心看看:

http://localhost:8801/view

http://localhost:8801/methods

这个时候注册中心应该列出了微服务实例和方法的列表。

好像很简单呀!

万里长征才走完第一步。

如果感兴趣请继续。

4. 创建另一个微服务(wow)并调用 hello_world 微服务

现在创建另一个微服务,步骤和前面的 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

5. 分布部署 hello_world

多次拷贝 hello_world 项目,更换 port 的值。注意 port 不要重复。

如果你有多个机器,可以使用多机部署,但需要调整正确的 ip 地址。

然后分别执行:

node index.js

6. 证明一下

现在你可以去并发执行 wow 的 /open/hello/world 了。

在浏览器中不断的刷新 http://localhost:3002/open/hello/world 就可以看到结果。

例子中用端口表示了他是从哪个微服务上访问过来的。

cloudoll has more...

请访问 cloudoc 项目阅读

Maintainers (1)
Downloads
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 1
Last Month 0
Dependencies (12)
Dev Dependencies (0)
None
Dependents (1)

Copyright 2014 - 2017 © taobao.org |