分布式任务调度系统Akkaflow介绍

akkaflow

简介

akkaflow是一个基于akka架构上构建的分布式高可用ETL工作流调度工具，可以把任务分发在集群中不同的节点上并行执行，高效利用集群资源，支持时间及任务混合触发；提供多种节点类型。其中工作流由xml文件，并且提供一套完整的基于Shell的操作命令集，简洁易用，长期稳定运行，可作为构建数据仓库、或大数据平台上的调度工具。
用户提交的xml工作流定义文件，满足触发条件后，系统会触发执行工作流；实例运行产生的各类数据将被记录并提供用户查看与进一步操作，其中

简单的前端操作页面详见演示地址，演示账号密码分别为admin/admin，机器配置为（1内核,1G内存）
工作流定义文档详见这里，目前支持行动节点类型有以下，可进一步扩展功能

行动节点类型	节点功能简述
`<sql/>`	sql执行节点，目前支持Hive、Mysql、Oracle、Impala数据库。
`<transfer/>`	数据传输节点，目前支持Mysql、Oracle、Hive、本地文件、hdfs文件之间的数据行传输。
`<metadata/>`	元数据配置节点（库表注释配置），可通过血缘表自动配置目标表元数据，亦可显式配置。
`<script/>`	脚本代码执行节点，支持各类型脚本，bash、python、perl、scala等。
`<file-executor/>`	脚本文件远程执行节点，把master机器上的脚本文件及附件分发到目标worker机器上执行。
`<file-monitor/>`	文件监控节点，监控本地或hdfs文件数量及大小。
`<data-monitor/>`	数据监控节点，可监控数据库记录数，文件行数，文件大小等不同类型数据。
`<email/>`	自定义邮件节点，可以以html形式自定义邮件内容，发送目标邮箱。

使用示例点击这里
基于shell命令集操作文档详见下面使用章节

整个akkaflow架构目前包含有四个节点角色：Master、Master-Standby、Worker、Http-Server，每个角色可以独立部署于不同机器上，支持高可用。

节点角色关系图

Master 活动主节点，调度触发工作流实例，分发子任务
Master-Standby 热备份主节点，当主节点宕机，立刻切换为活动主节点
Worker 任务节点，可部署在多个机器上，运行主节点分发过来的任务，并反馈运行结果。
Http-Server http服务节点，提供http API查看操作当前akkaflow系统。

Aaron Swartz

部署

1、打包

可以直接在这里下载akkaflow-x.x.zip，这是已经打包好的程序包
可以把工程check out下来，用sbt-native-packager进行编译打包(直接运行sbt dist)

2、安装

安装环境：Linux系统（UTF8编码环境）或MacOS、jdk1.8或以上、MySQL5.7或以上
设置好JAVA_HOME环境变量

3、目录说明

sbin 存放用户操作命令，如启动节点命令等
lib 存放相关jar包
logs 存放相关日志
config 存放相关配置文件
xmlconfig 存放示例工作流文件，系统启动时会自动载入

4、安装步骤 (伪分布式部署)：

解压到/your/app/dir
准备一个mysql数据库，（如数据库名称为wf，用户密码分别为root/root）
准备一个邮箱账户（推荐用网易邮箱），支持smtp方式发送邮件。
修改配置文件 config/application.conf中以下部分（基本修改数据库以及邮件配置项就可以了）

  mysql {   //用mysql来持久化数据
    user = "root"
    password = "root"
    jdbc-url = "jdbc:mysql://localhost:3306/wf?autoReconnect=true"
    is-enabled = true
  }
  email {   //告警邮箱设置
    hostname = "smtp.163.com"
    smtp-port = 465  //smtp端口，可选
    auth = true
    account = "15018735011@163.com"
    password = "******"
    charset = "utf8"
    is-enabled = true
  }
  extra {  //hdfs集群配置
    hdfs-uri = "hdfs://quickstart.cloudera:8020"
  }

启动角色（独立部署模式）
其中，当前伪分布部署，是把master、worker、http-servers在同一台机器的不同端口启动
执行: ./standalone-startup
查看启动日志
启动时会在终端打印日志，另外，日志也追加到./logs/run.log中，tail一下日志，看下启动时是否有异常，无异常则表示启动成功。
查看进程
启动完后，使用jps查看进程

2338 HttpServer
2278 Worker
2124 Master

注意：akkaflow工作流定义可以存放于xmlconfig下，akkaflow启动时，会自动并一直扫描xmlconfig下面的文件，生成对应的worflow提交给Master，所以工作流文件，也可以放到该目录中，安装包下的xmlconfig/example下有工作流定义示例。

5、关闭集群

执行./sbin/stop-cluster, 关闭集群系统

命令使用

1、角色节点操作命令

standalone模式启动：sbin/standalone-startup(该模式下会启动master、worker、http-server)
master节点启动：sbin/master-startup
worker节点启动：sbin/worker-startup
http_server节点启动：sbin/httpserver-startup
master-standby节点启动：sbin/master-standby-startup
关闭集群：sbin/stop-cluster

2、akkaflow操作命令集

命令集入口

kentdeMacBook-Pro:sbin kent$ ./akka
   _     _     _            __  _
  / \   | | __| | __ __ _  / _|| |  ___ __      __
 / _ \  | |/ /| |/ // _` || |_ | | / _ \\ \ /\ / /
/ ___ \ |   < |   <| (_| ||  _|| || (_) |\ V  V /
/_/   \_\|_|\_\|_|\_\\__,_||_|  |_| \___/  \_/\_/

【使用】
  akka [ front| instance| workflow| util]
【说明】
  akkaflow调度系统命令入口。
  1、akka front 调度系统首页
  2、akka instance 工作流实例操作命令集，详见该命令
  3、akka workflow 工作流操作命令集，详见该命令
  4、akka util 辅助操作命令集，详见该命令
【示例】
  akka front
  akka instance -info -log 574de284 (查看某实例)
  akka workflow -kill 574de284 (杀死某运行中的实例)

命令集合列表

Aaron Swartz

注意: 除了节点启动命令，把工作流定义的xml文件放在xmlconfig目录下，可自动扫描添加对应工作流或调度器，也可以用命令提交.

任务实例告警邮件