本文是用户Mark Wu近期在学习使用FlyFish源码的学习笔记，云智慧AIOps社区征得原作者同意后授权发布，本文使用的是FlyFish版本2.0，目前最新版本已更新到2.1

FlyFish代码结构

以下是代码的基本结构，使用的是基于MVC的thinkJS框架，但是通篇看下来，你是不是注意到，只看到了M(Model)和C(Controller)，唯独缺少View，所以View在哪？所以就带着这个问题继续学习下去。

thinkJS框架

view是如何生成的

adapter.js里面配置view模板的目录为view里面的html模板，模板引擎为nunjucks，配合extend里面引入的think-view使用。

/**
view adapter config
@type {Object}
*/
exports.view = {
type: 'nunjucks', // 这里指定默认的模板引擎是 nunjucks
common: {
viewPath: path.join(think.ROOT_PATH, 'view'),//模板文件的根目录
sep: '_',//Controller 与 Action 之间的连接符
extname: '.html'
},
nunjucks: {
handle: nunjucks
}
};

 

可以看到模板里面有两个 prefix、title变量，会引入加载页面所需静态资源。extend里面引入了think-view，通过 view 扩展，框架就支持渲染模板的功能，Controller 类上就有了 assign、display 等方法，引入model(think.app) 支持模型功能，会添加方法 think.Model、think.model、ctx.model、controller.model、service.model。

 

// extend.js
const view = require('think-view');
const model = require('think-model');
const session = require('think-session');
const cache = require('think-cache');

module.exports = [
session,
cache,
view, // make application support view
model(think.app),
];

 

router里面配置路由规则，以/pw/开头的get请求会指向web模块的view控制器下index的一个叫platform的action；

// router.js
module.exports = [
// 代理平台的静态页面
[/^\/pw\/(.*)/i, '/web/view/index/platform', 'get'],
[/^\/proxyDataHub\/(.*)/i, 'web/proxy', 'rest'],
];

// web/controller/view/index.js
module.exports = class extends think.Controller {
platformAction() {
this.assign('prefix', this.config('platformPrefix', undefined, 'web').replace(/\/$/, ''));
this.assign('title', this.config('indexTitle', undefined, 'web').replace(/\/$/, ''));
return this.display();
}
};

platformAction会根据配置以及模块改变prefix、title变量的值，这样view模板就能正确加载静态资源。同时middleware也配置默认模块为web，默认控制器action为platformAction

...
//路由操作
{
handle: 'router',
enable: true, //是否开启该中间件
options: {
defaultModule:'web', // 默认模块
defaultController: 'view/index', // 默认控制器
defaultAction: 'platform', // 默认action
}
},
...

 

数据流

API请求数据流如下图所示

服务端建议：可以适当增加Workers数量，以增加服务端稳定性，一个Worker出现问题后，Master会停止它，然后fork一个新的Worker出来。

部署问题

在使用飞鱼2.0的过程中，遇到了很多部署方面的问题，这里我挑几个典型的记录一下

 

Q：服务器上部署docker容器，本地访问飞鱼平台，发现登录地址请求是127.0.0.1的地址；

A：按照部署流程仔细检查了一下，发现配置文件www/static/solution_platform_web/config/ENV.production.js没有正确配置。

 

Q：docker容器部署起来，做添加大屏操作的时候报错ER_NO_SUCH_TABLE: Table 'flyfish.visual_screen_tag_view' doesn't exist, SQL: SHOW COLUMNS FROM visual_screen_tag_view；

A：检查发现数据库没有启动。

 

Q：code-server 下面 ，grpc安装失败，一起没有成功；

A：切换成cnpm源后成功，其实也可以试试使用yarn进行安装；

 

写在最后

FlyFish发布2.1版本后，已经支持安装包一件部署方式，极大缩减了部署流程，具体如下所示

# CentOS 7.5/7.6 x86-64
# 须使用root账户
mkdir -p /data/app/
cd /data/app/

git clone -b main http://github.com/CloudWise-OpenSource/FlyFish.git FlyFish
or
git clone -b main http://gitee.com/CloudWise/fly-fish.git FlyFish

cd /data/app/FlyFish
bash flyfish.sh install

# 一键卸载
bash flyfish.sh uninstall

# 一键更新
# FlyFish-2.1.1 升级至 FlyFish-2.1.2
git checkout main
git pull origin main

bash flyfish.sh update

作者简介

Mark Wu（ 吴银波 ）云智慧前端工程师，精通javascript、css、React、Vue、Webpack、ThreeJS等前端技术栈，致力于云智慧大屏产品及飞鱼开源社区服务，拥有丰富的前端性能优化和开源项目经验。

关于FlyFish