应用程序配置，如何配置Pomelo框架？
Pomelo可以配置各个组件的选项，加载配置文件，开启Pomelo的特性等，这些配置都是在game-server/app.js文件中进行的。实际上在Pomelo的应用中有两个app.js，一个是在game-server目录下，一个是在web-server目录下。game-server下的app.js是整个游戏服务器的入口和配置点。web-server下的app.js是Web服务器入口。
pomelo进程
pomelo框架是如何驱动的呢？
当应用启动后，使用pstree -au得到进程树，可发现pomelo start启动命令调用进程会创建子进程，子进程执行的是node app.js env=development，然后这个子进程又会创建更多子进程，这些子进程执行的跟原进程同样的文件，只是多个更多的参数。
$ cd game-server
$ pomelo start
$ pstree -au
pomelo start命令的进程直接创建的子进程实际是master服务器进程，由master服务器创建的子进程执行node <BasePath>/app.js env=development id=chat-server-1...命令则是由master服务器创建的子进程，这些子进程也就是应用服务器。这里所有的进程都是在一台主机上，所有会存在父子关系，也就是说master进程是其它应用服务器的父进程。如果各个进程分布在不同的物理主机上的话，pomelo默认会使用ssh方式远程启动相应的服务器，那么master进程与应用程序进程不会再是父子关系。
使用pomelo start命令后命令行工具pomelo会检查start后是否存在其它参数，比如是否需要daemon后台守护进程的形式启动，是否指定env环境等。若没有则会默认为其添加env=development环境参数后启动node.js进程。
node <BasePath>/app.js env=development
此时pomelo start命令就启动了app.js脚本
$ cat /lib/util/appUtils.js
var setEnv = function(app, args){
app.set(Constants.RESERVED.ENV, args.env || process.env.NODE_ENV || Constants.RESERVED.ENV_DEV, true);
};
使用pomelo start命令启动pomelo应用时，若没有传入--env参数则会先检查process.env.NODE_ENV环境变量是否设置。若没有设置则默认为development。若通过pomelo start --env production方式启动则env为production。
辅助命令
查看端口
$ netstat -tln
$ netstat -anp
搜索指定进程
$ netstat -anp | grep process_name
杀死指定PID的进程
$ kill -9 pid
游戏服务器启动流程
createApp创建应用实例app.configure()加载配置和默认component组件master服务器启动通过配置和启动参数启动其它服务器
$ vim game-server/app.js
//加载pomelo
let pomelo = require("pomelo");
//创建app实例
let app = pomelo.createApp();
//通过app这个上下文对框架的配置以及一些初始化操作
app.configure(<env>, <serverType>, function(){});
app.configure(...);
app.set(...);
app.route(...);
//启动应用
app.start();
例如：典型的启动文件包含内容
const pomelo = require('pomelo');
//创建应用实例
const app = pomelo.createApp();
//加载配置和组件
//app.configure(<env>, <serverType>, function(){});
//env:development|production
//serverType: master/gate/connector/...
app.configure("development|production", "connector", function(){
//过滤器配置
app.before(pomelo.filters.toobusy());//接口访问限制
app.filter(pomelo.filters.serial()); // 配置内置过滤器: serialFilter
app.filter(pomelo.filters.time()); //开启conn日志，对应pomelo-admin模块下conn request
app.rpcFilter(pomelo.rpcFilters.rpcLog());//开启rpc日志，对应pomelo-admin模块下rpc request
//启动系统监控
app.enable('systemMonitor');
//注册admin module
//enable systemMonotor后 注册的admin module才可使用
var onlineUser = require('./app/modules/onlineUser');
if (typeof app.registerAdmin === 'function') {
app.registerAdmin(onlineUser, {app: app});
}
//加载配置
app.loadConfig('mysql', app.getBase() + '/config/mysql.json');
//配置路由
app.route('chat', routeUtil.chat);
//配置代理
app.set('proxyConfig', {
cacheMsg: true,
interval: 30,
lazyConnection: true,
enableRpcLog: true
});
//远程配置
app.set('remoteConfig', {
cacheMsg: true,
interval: 30
});
//设置内部connector组件： 心跳时长 通信协议
app.set('connectorConfig',{
connector: pomelo.connectors.hybridconnector,
heartbeat: 30,
useDict: true,
useProtobuf: true,
handshake: function (msg, cb) {
cb(null, {});
}
});
//设置变量
app.set(key, value);
//加载用户自定义组件
//组件导出的都是工厂函数，app可自动识别，讲其自身作为opt参数传递给组件,方便访问app上下文。
app.load(helloWorldComponent, opt);
//使用插件
const statusPlugin = require('pomelo-status-plugin');
app.use(statusPlugin, {
status:{
host: '127.0.0.1',
port: 6379
}
});
//启动应用
app.start();
});
process.on('uncaughtException', function(err){
console.error('uncaughtException : ', err, err.stack());
});
Pemolo启动流程
应用初始化createApp
创建应用
- pomelo调用createApp()创建应用实例
const app = pomelo.createApp();
- pomelo的createApp调用中会调用app的init()方法完成对app的初始化
/**
* Create an pomelo application.
*
* @return {Application}
* @memberOf Pomelo
* @api public
*/
Pomelo.createApp = function (opts) {
var app = application;
app.init(opts);
self.app = app;
return app;
};
- app会使用appUtil提供的defaultConfiguration来完成自己的初始化配置
/**
* Initialize the server.
*
* - setup default configuration
*/
Application.init = function(opts) {
opts = opts || {};
this.loaded = []; // loaded component list
this.components = {}; // name -> component map
this.settings = {}; // collection keep set/get
var base = opts.base || path.dirname(require.main.filename);
this.set(Constants.RESERVED.BASE, base, true);
this.event = new EventEmitter(); // event object to sub/pub events
// current server info
this.serverId = null; // current server id
this.serverType = null; // current server type
this.curServer = null; // current server info
this.startTime = null; // current server start time
// global server infos
this.master = null; // master server info
this.servers = {}; // current global server info maps, id -> info
this.serverTypeMaps = {}; // current global type maps, type -> [info]
this.serverTypes = []; // current global server type list
this.lifecycleCbs = {}; // current server custom lifecycle callbacks
this.clusterSeq = {}; // cluster id seqence
appUtil.defaultConfiguration(this);
this.state = STATE_INITED;
logger.info('application inited: %j', this.getServerId());
};
- appUtil的defaultConfiguration会调用app的一些初始化方法，这些方法包括setEnv设置环境参数、loadMaster加载主服务器、loadServers加载应用服务器，parseArgs解析参数，configLogger配置日志。
/**
* Initialize application configuration.
*/
module.exports.defaultConfiguration = function(app) {
var args = parseArgs(process.argv);
setupEnv(app, args);
loadMaster(app);
loadServers(app);
processArgs(app, args);
configLogger(app);
loadLifecycle(app);
};
- setEnv操作会将当前的env设定为development
- loadMaster调用会加载maseter服务器的配置信息
- loadServers会加载所有的应用服务器配置信息
- parseArgs是一个关键性的操作，由于
pomelo start启动参数中仅仅指定了env，其它参数并未指定，此时pomelo认为目前启动的不是应用服务器而是master服务器。因此，当前进程将使用master的配置信息，并将自己的serverId、serverType等参数设置为master服务器所有的。实际上，对于应用服务器来说，如果启动的是应用服务器的话，node app.js后可带有更多参数，包括id、serverType、port、clientPort等，这些参数在parseArgs这一步将会被处理，从而确定当前服务器的ID、类型等其它必须的配置信息。
5.执行完上诉操作后app进入INITED已初始化状态，同时pomelo的createApp返回。
当pomelo的createApp()方法返回后在app.js中接下来会对app进行一系列的配置，比如调用app.set()设置上下文变量的值，app.route()调用配置路由等。
应用程序配置
app.js是运行Pomelo项目的入口，在app.js文件中首先会创建一个app实例，这个app作为整个框架的配置上下文来使用，用户可以通过这个上下文，设置一些全局变量，加载配置信息等操作。
configure
使用app.configure调用来配置
服务器的配置主要由configure()方法完成，完整的app.configure配置参数格式：
app.configure([env], [serverType], [function]);
| 参数 | 描述 |
|---|---|
| env | 运行环境，可设置为development、production、development|production。 |
| serverType | 服务器类型，设置后只会对当前参数类型服务器做初始化，不设置则对所有服务器执行初始化的function。比如gate、connector、chat... |
| function | 具体的初始化操作，内部可以些任何对框架的配置操作逻辑。 |
Application.configure = function (env, type, fn) {
var args = [].slice.call(arguments);
fn = args.pop();
env = type = Constants.RESERVED.ALL;
if(args.length > 0) {
env = args[0];
}
if(args.length > 1) {
type = args[1];
}
if (env === Constants.RESERVED.ALL || contains(this.settings.env, env)) {
if (type === Constants.RESERVED.ALL || contains(this.settings.serverType, type)) {
fn.call(this);
}
}
return this;
};
更多地可以在configure中针对不同的服务器、不同的环境，对框架进行不同的配置。这些配置包括设置一个上下文变量供应用使用，开启一些功能选项，配置加载一个自定义的组件component，针对不同的服务器，配置过滤器filter等配置操作。
loadConfig
例如：全局配置MySQL参数
$ vim game-server/config/mysql.json
{
"development":
{
"host": "127.0.0.1",
"port": "3306",
"username": "root",
"password": "root",
"database": "pomelo"
}
}
加载配置文件，用户通过loadConfig()加载配置文件后，加载后文件中的参数将会直接挂载到app对象上，可直接通过app对象访问具体的配置参数。
$ vim game-server/app.js
const path = require('path');
//全局配置
app.configure('production|development', function(){
//加载MySQL数据库
app.loadConfig("mysql", path.join(app.getBase(), "config/mysql.json"));
const host = app.get("mysql").host;//获取配置
console.log("mysql config: host = %s",host);
});
用户可以使用loadConfig()的调用加载任何JSON格式的配置文件，用于其它的目的，并能通过app进行访问。需要注意的是所有的JSON配置文件中都需要指定具体的模式，也就是development或production。
/**
* Load Configure json file to settings.
*
* @param {String} key environment key
* @param {String} val environment value
* @return {Server|Mixed} for chaining, or the setting value
* @memberOf Application
*/
Application.loadConfig = function(key, val) {
var env = this.get(Constants.RESERVED.ENV);
val = require(val);
if (val[env]) {
val = val[env];
}
this.set(key, val);
};
set/get
上下文变量存取是指上下文对象app提供了设置和获取应用变量的方法，签名为：
set 设置应用变量
app.set(name, value, [isAttach]);
| 参数 | 描述 |
|---|---|
| name | 变量名 |
| value | 变量值 |
| isAttach | 可选，默认为false，附加属性，若isAttach为true则将变量attach到app对象上作为属性。此后对此变量的访问，可直接通过app.name。 |
/**
* Assign `setting` to `val`, or return `setting`'s value.
*
* Example:
*
* app.set('key1', 'value1');
* app.get('key1'); // 'value1'
* app.key1; // undefined
*
* app.set('key2', 'value2', true);
* app.get('key2'); // 'value2'
* app.key2; // 'value2'
*
* @param {String} setting the setting of application
* @param {String} val the setting's value
* @param {Boolean} attach whether attach the settings to application
* @return {Server|Mixed} for chaining, or the setting value
* @memberOf Application
*/
Application.set = function (setting, val, attach) {
if (arguments.length === 1) {
return this.settings[setting];
}
this.settings[setting] = val;
if(attach) {
this[setting] = val;
}
return this;
};
例如：
app.set("name", "project_name");
const name = app.get("name);//project_name
app.set("name", name, true);
const name = app.name;
get 获取应用变量
app.get(name);
/**
* Get property from setting
*
* @param {String} setting application setting
* @return {String} val
* @memberOf Application
*/
Application.get = function (setting) {
return this.settings[setting];
};
例如：获取项目根目录，即app.js文件所在的目录。
const basepath = app.get("base");
// const basepath = app.getBase();
enable/disable
开发者可通过enable()/disable()方法来启用或禁用Pomelo框架的一些特性，并通过enabled()/disabled()方法来检查特性的可用状态。
例如：禁用及启用RPC调试日志并检查其状态
app.enabled("rpcDebugLog");//return true/false
app.disabled("rpcDebugLog");
app.enable("rpcDebugLog");
app.disable("rpcDebugLog");
例如：启用systemMonitor以加载额外模块
app.enable("systemMonitor");
route
route主要负责请求路由信息的维护，路由计算，路由结果缓存等工作，并根据需要切换路由策略，更新路由信息等。
/**
* Set the route function for the specified server type.
*
* Examples:
*
* app.route('area', routeFunc);
*
* var routeFunc = function(session, msg, app, cb) {
* // all request to area would be route to the first area server
* var areas = app.getServersByType('area');
* cb(null, areas[0].id);
* };
*
* @param {String} serverType server type string
* @param {Function} routeFunc route function. routeFunc(session, msg, app, cb)
* @return {Object} current application instance for chain invoking
* @memberOf Application
*/
Application.route = function(serverType, routeFunc) {
var routes = this.get(Constants.KEYWORDS.ROUTE);
if(!routes) {
routes = {};
this.set(Constants.KEYWORDS.ROUTE, routes);
}
routes[serverType] = routeFunc;
return this;
};
用户可自定义不同服务器的不同路由规则，然后进行配置即可。在路由函数中，通过最后的回调函数中返回服务器的ID即可。
$ vim game-server/app.js
//聊天服务器配置
app.configure("production|development", "chat",function(){
//路由配置
app.route("chat", function(session, msg, app, cb){
const servers = app.getServersByType("chat");
if(!servers || servers.length===0){
cb(new Error("can not find chat servers"));
return;
}
const val = session.get("rid");
if(!val){
cb(new Error("session rid is not find"));
return;
}
const index = Math.abs(crc.crc32(val)) % servers.length;
const server = servers[index];
cb(null, server.id);
});
//过滤配置
app.filter(pomelo.timeout());
});
filter
实际应用中，往往需要在逻辑服务器处理请求之前对用户请求做一些前置处理，当请求被处理后又需要做一些善后处理，由于这是一种常见的情形。Pomelo对其进行了抽象，也就是filter。在Pomelo中filter分为before filter和after filter。在一个请求到达Handler被处理之前，可以经过多个before filter组成的filter链进行一些前置处理，比如对请求进行排队，超时处理。当请求被Handler处理完成后，又可以通过after filter链进行一些善后处理。这里需要注意的是在after filter中一般只做一些清理处理，而不应该再去修改到客户端的响应内容。因为此时，对客户端的响应内容已经发送给了客户端。
filter链
filter分为before和after两类，每个filter都可以注册多个形成一个filter链，所有客户端请求都会经过filter链进行处理。before filter会对请求做一些前置处理，如检查当前玩家是否已经登录，打印统计日志等。after filter是进行请求后置处理的地方，比如释放请求上下文的资源，记录请求总耗时等。after filter中不应该再出现修改响应内容的代码，因为在进入after filter前响应就已经被发送给客户端。
配置filter
当一个客户端请求到达服务器后，经过filter链和handler处理，最后生成响应返回给客户端。handler是业务逻辑实现的地方，filter则是执行业务前进行预处理和业务处理后清理的地方。为了开发者方便，系统内建提供了一些filter。比如serialFilter、timerFilter、timeOutFilter等，另外，用户可以根据应用的需要自定义filter。
app.filter(pomelo.filters.serial());
如果仅仅是before filter，那么调用app.before。
/**
* Add before filter.
*
* @param {Object|Function} bf before fileter, bf(msg, session, next)
* @memberOf Application
*/
Application.before = function (bf) {
addFilter(this, Constants.KEYWORDS.BEFORE_FILTER, bf);
};
如果是after filter，则调用app.after。
/**
* Add after filter.
*
* @param {Object|Function} af after filter, `af(err, msg, session, resp, next)`
* @memberOf Application
*/
Application.after = function (af) {
addFilter(this, Constants.KEYWORDS.AFTER_FILTER, af);
};
如果即定义了before filter，又定义了after filter，可以使用app.filter调用。
/**
* add a filter to before and after filter
*
* @param {Object} filter provide before and after filter method.
* A filter should have two methods: before and after.
* @memberOf Application
*/
Application.filter = function (filter) {
this.before(filter);
this.after(filter);
};
用户可以自定义filter，然后通过app.filter调用，将其配置进框架。
filter对象
filter是一个对象，定义filter大致代码如下：
let Filter = function(){};
/**
* 前置过滤器
* @param msg 用户请求原始内容或经前面filter链处理后的内容
* @param session 若在后端服务器上则是BackendSession，若在前端服务器则是FrontendSession
* @param next
*/
Filter.prototype.before = function(msg, session, next){
};
/**
* 后置过滤器
* @param err 错误信息
* @param msg
* @param session
* @param resp 对客户端的响应内容
* @param next
*/
Filter.prototype.after = function(err, msg, session, resp, next){
};
module.exports = function(){
return new Filter();
};
服务器启动app.start()
当执行完用户编辑代码后，将会进入app.start()调用，它首先会加载默认的组件，对于master服务器来说加载的默认组件时master组件和monitor组件。
/**
* Start application. It would load the default components and start all the loaded components.
*
* @param {Function} cb callback function
* @memberOf Application
*/
Application.start = function(cb) {
this.startTime = Date.now();
if(this.state > STATE_INITED) {
utils.invokeCallback(cb, new Error('application has already start.'));
return;
}
var self = this;
appUtil.startByType(self, function() {
appUtil.loadDefaultComponents(self);
var startUp = function() {
appUtil.optComponents(self.loaded, Constants.RESERVED.START, function(err) {
self.state = STATE_START;
if(err) {
utils.invokeCallback(cb, err);
} else {
logger.info('%j enter after start...', self.getServerId());
self.afterStart(cb);
}
});
};
var beforeFun = self.lifecycleCbs[Constants.LIFECYCLE.BEFORE_STARTUP];
if(!!beforeFun) {
beforeFun.call(null, self, startUp);
} else {
startUp();
}
});
};
master组件的启动过程
master组件的启动过程
- app.start()方法首先会加载默认组件，由于没有指定服务器类型，此时会默认为master服务器类型，并获取master服务器的配置、加载master组件。
$ vim game-server/config/master.json
{
"development": {
"id": "master-server-1", "host": "127.0.0.1", "port": 3005
},
"production": {
"id": "master-server-1", "host": "127.0.0.1", "port": 3005
}
}
由于Master组件是以工厂函数的方式导出的，因此会创建master组件，master组件的创建过程中会创建MasterConsole，MasterConsole会创建MasterAgent，MasterAgent会创建监听Socket用来监听应用服务器的监控和管理请求。
Pomelo启动活动图
