1、节点和服务
在下图所示的服务端系统中,每个Skynet进程(操作系统进程)都称为一个节点,每个节点都可以开启数千个Lua服务,每个服务都是一个Actor。不同节点可以部署在不同的物理机上,提供分布式集群的能力。
在上图中,我们开启了3个节点和5个服务的服务端系统。
拓展:其实Skynet的强项主要是在于单个节点内的并行运算,对于分布式集群,它只提供一些基础设施。在Skynet引擎中,分布式程序要处理很多异常情况。
2、Skynet的目录结构
Skynet的目录结构如下图所示:
目录/文件 | 说明 |
3rd | 存放第三方的代码,如Lua、jemalloc等 |
examples | 范例:KV数据库范例的部分服务(如main服务、simpledb服务)位于该目录下 |
luaclib | 用C语言编写的程序库,如bson解析、md5解析等 |
lualib | 用Lua编写的程序库 |
lualib-src | lualib目录下,库文件的源码 |
service | 包含Skynet内置的一些服务,比如KV数据库范例用到的launcher、gate |
cservice | 存放内置的用C语言编写的服务 |
service-src | cservice目录下,程序的源码 |
skynet-src | 使用C写的Skynet核心代码 |
test | 测试代码:如果遇到某些不懂的功能,可以参考该目录下的代码 |
3、启动流程
下图展示了Skynet的启动流程。图中①②③步由引擎完成,用户只需在配置文件中指定主服务即可,之后就可以从主服务开始编写程序了。
4、配置文件
Skynet提供了很多配置项,可以打开配置文件examples/config查看它的内容:
include "config.path"
-- preload = "./examples/preload.lua" -- run preload.lua before every lua service run
thread = 8
logger = nil
logpath = "."
harbor = 1
address = "127.0.0.1:2526"
master = "127.0.0.1:2013"
start = "main" -- main script
bootstrap = "snlua bootstrap" -- The service for bootstrap
standalone = "0.0.0.0:2013"
-- snax_interface_g = "snax_g"
cpath = root.."cservice/?.so"
-- daemon = "./skynet.pid"
这个配置文件实际上就是一段 lua 代码,通常,我们以 key = value 的形式对配置项赋值。skynet 在启动时,会读取里面必要的配置项,并将暂时用不到的配置项以字符串形式保存在 skynet 内部的 env 表中。这些配置项可以通过 skynet.getenv
获取。
主要配置项 | 说明 |
thread | 启动多少个工作线程,通常不要将它配置超过你实际拥有的 CPU 核心数。 |
bootstrap | skynet 启动的第一个服务以及其启动参数。默认配置为 snlua bootstrap,即启动一个名为 bootstrap 的 lua 服务。通常指的是 service/bootstrap.lua 这段代码。 |
cpath | 用C编写的服务模块的位置,通常指 cservice 下那些 .so 文件。如果你的系统的动态库不是以 .so 为后缀,需要做相应的修改。这个路径可以配置多项,以 ; 分割。 |
start | 这是 bootstrap 最后一个环节将启动的 lua 服务,也就是你定制的 skynet 节点的主程序。默认为 main ,即启动 main.lua 这个脚本。这个 lua 服务的路径由下面的 luaservice 指定。 |
harbor | 可以是 1-255 间的任意整数。一个 skynet 网络最多支持 255 个节点。每个节点有必须有一个唯一的编号。如果 harbor 为 0 ,skynet 工作在单节点模式下此时 master 和 address 以及 standalone 都不必设置。 |
次要配置项 | 说明 |
logger | 它决定了 skynet 内建的 skynet_error 这个 C API 将信息输出到什么文件中。如果 logger 配置为 nil ,将输出到标准输出。你可以配置一个文件名来将信息记录在特定文件中。 |
logpath | 配置一个路径,当你运行时为一个服务打开 log 时,这个服务所有的输入消息都会被记录在这个目录下,文件名为服务地址。 |
address | 当前 skynet 节点的地址和端口,方便其它节点和它组网。注:即使你只使用一个节点,也需要开启控制中心,并额外配置这个节点的地址和端口。 |
master | 指定 skynet 控制中心的地址和端口,如果你配置了 standalone 项,那么这一项通常和 standalone 相同。 |
standalone | 如果把这个 skynet 进程作为主进程启动(skynet 可以由分布在多台机器上的多个进程构成网络),那么需要配置standalone 这一项,表示这个进程是主节点,它需要开启一个控制中心,监听一个端口,让其它节点接入。 |
在第一行的代码中我们可以看到include "config.path",我们在目录中找到这个文件并打开它:
root = "./"
luaservice = root.."service/?.lua;"..root.."test/?.lua;"..root.."examples/?.lua;"..root.."test/?/init.lua"
lualoader = root .. "lualib/loader.lua"
lua_path = root.."lualib/?.lua;"..root.."lualib/?/init.lua"
lua_cpath = root .. "luaclib/?.so"
snax = root.."examples/?.lua;"..root.."test/?.lua"
配置项 | 说明 |
luaservice | lua 服务代码所在的位置。可以配置多项,以 ; 分割。 |
lualoader | 用哪一段 lua 代码加载 lua 服务。通常配置为 lualib/loader.lua ,再由这段代码解析服务名称,进一步加载 lua 代码。snlua 会将下面几个配置项取出,放在初始化好的 lua 虚拟机的全局变量中。具体可参考实现。 |
lua_path | 将添加到 package.path 中的路径,供 require 调用。 |
lua_cpath | 用C 语言编写的程序库(.so 文件)的路径 |
snax | 用 snax 框架编写的服务的查找路径。 |
Skynet提供了很多功能,有些功能还提供多种实现方法,因此配置项较多。读者可以打开https://github.com/cloudwu/skynet/wiki/Config查看详细说明。