Azkaban安装与配置

爱被打了一巴掌 2023-05-21 08:44 7阅读 0赞

### **1.1 为什么需要工作流调度系统** ###

1）一个完整的数据分析系统通常都是由大量任务单元组成：  
  shell 脚本程序，java 程序，mapreduce 程序、hive 脚本等。  
2）各任务单元之间存在时间先后及前后依赖关系。  
3）为了很好地组织起这样的复杂执行计划，需要一个工作流调度系统来调度执行。  
  例如，我们可能有这样一个需求，某个业务系统每天产生 20G 原始数据，我们每天都要对其进行处理，处理步骤如下所示：  
  （1）通过 Hadoop 先将原始数据同步到 HDFS 上；  
  （2）借助 MapReduce 计算框架对原始数据进行计算，生成的数据以分区表的形式存储到多张 Hive 表中；  
  （3）需要对 Hive 中多个表的数据进行 JOIN 处理，得到一个明细数据 Hive 大表；  
  （4）将明细数据进行复杂的统计分析，得到结果报表信息；  
  （5）需要将统计分析得到的结果数据同步到业务系统中，供业务调用使用。  
如下图所示：

![format_png][]

### **1.2 常见工作流调度系统** ###

>   **1）简单的任务调度**：直接使用 linux 的 crontab 来定义。  
>   **2）复杂的任务调度**：开发调度平台或使用现成的开源调度系统，比如 Ooize、Azkaban、Cascading、Hamake 等。

### **1.3 各种调度工具特性对比** ###

下面的表格对上述四种 hadoop 工作流调度器的关键特性进行了比较，尽管这些工作流调度器能够解决的需求场景基本一致，但在设计理念，目标用户，应用场景等方面还是存在显著的区别，在做技术选型的时候，可以提供参考。

![format_png 1][]

### **1.4 Azkaban 与 Oozie 对比** ###

对市面上最流行的两种调度器，给出以下详细对比，以供技术选型参考。总体来说，Ooize 相比 Azkaban 是一个重量级的任务调度系统，功能全面，但配置使用也更复杂。如果可以不在意某些功能的缺失，轻量级调度器 Azkaban 是很不错的候选对象。  
详情如下：  
**1）功能**  
  两者均可以调度 mapreduce，pig，java，脚本工作流任务  
  两者均可以定时执行工作流任务  
**2）工作流定义**  
  Azkaban 使用 Properties 文件定义工作流  
  Oozie 使用 XML 文件定义工作流  
**3）工作流传参**  
  Azkaban 支持直接传参，例如`${input}`  
  Oozie 支持参数和 EL 表达式，例如`${fs:dirSize(myInputDir)}`    
**4）定时执行**  
  Azkaban 的定时执行任务是基于时间的  
  Oozie 的定时执行任务基于时间和输入数据  
**5）资源管理**  
  Azkaban 有较严格的权限控制，如用户对工作流进行读/写/执行等操作  
  Oozie 暂无严格的权限控制  
**6）工作流执行**  
  Azkaban 有两种运行模式，分别是 solo server mode(executor server 和 web server 部署在同一台节点)和 multi server mode(executor server 和 web server 可以部署在不同节点)  
  Oozi e作为工作流服务器运行，支持多用户和多工作流  
**7）工作流管理**  
  Azkaban 支持浏览器以及 ajax 方式操作工作流  
  Oozie 支持命令行、HTTP REST、Java API、浏览器操作工作流

## **二、Azkaban** ##

Azkaban 是由 Linkedin 开源的一个批量工作流任务调度器。用于在一个工作流内以一个特定的顺序运行一组工作和流程。Azkaban 定义了一种 KV 文件格式来建立任务之间的依赖关系，并提供一个易于使用的 web 用户界面维护和跟踪你的工作流。  
它有如下功能特点：  
  1）Web 用户界面  
  2）方便上传工作流  
  3）方便设置任务之间的关系  
  4）调度工作流  
  5）认证/授权(权限的工作)  
  6）能够杀死并重新启动工作流  
  7）模块化和可插拔的插件机制  
  8）项目工作区  
  9）工作流和任务的日志记录和审计  
下载地址：[http://azkaban.github.io/downloads.html][http_azkaban.github.io_downloads.html]

## **三、Azkaban 安装部署** ##

### **3.1 安装前准备** ###

1）将 Azkaban Web 服务器、Azkaban 执行服务器和 MySQL 拷贝到 hadoop102虚拟机的 /opt/software目录下

azkaban-web-server-2.5.0.tar.gz
    azkaban-executor-server-2.5.0.tar.gz
    azkaban-sql-script-2.5.0.tar.gz
    mysql-libs.zip

2）目前 azkaban 只支持 mysql，需安装 mysql 服务器，本文档中默认已安装好 mysql 服务器，并建立了 root用户，密码 root。

### **3.2 安装 azkaban** ###

1）在/opt/module/目录下创建 azkaban 目录

[duoduo@hadoop102 module]$ mkdir azkaban

2）解压 azkaban-web-server-2.5.0.tar.gz、azkaban-executor-server-2.5.0.tar.gz、azkaban-sql-script-2.5.0.tar.gz 到 /opt/module/azkaban 目录下

tar -zxvf azkaban-web-server-2.5.0.tar.gz -C /opt/module/azkaban/
    tar -zxvf azkaban-executor-server-2.5.0.tar.gz -C /opt/module/azkaban/
    tar -zxvf azkaban-sql-script-2.5.0.tar.gz -C /opt/module/azkaban/

3）对解压后的文件重新命名

mv azkaban-web-2.5.0/ server
    mv azkaban-executor-2.5.0/ executor

4）azkaban 脚本导入  
进入 mysql，创建 azkaban 数据库，并将解压的脚本导入到 azkaban 数据库。

mysql -uroot -p123456
    mysql> create database azkaban;
    mysql> use azkaban;
    mysql> source /opt/module/azkaban/azkaban-2.5.0/create-all-sql-2.5.0.sql

`注`：source 后跟 .sql 文件，用于批量处理 .sql 文件中的sql 语句。

### **3.2 创建 SSL 配置** ###

参考地址: http://docs.codehaus.org/display/JETTY/How+to+configure+SSL  
Keytool 是 java 数据证书的管理工具，使用户能够管理自己的公/私钥对及相关证书。  
　　-keystore 指定密钥库的名称及位置(产生的各类信息将不在 .keystore 文件中)  
　　-genkey 在用户主目录中创建一个默认文件 ".keystore"  
　　-alias 对我们生成的 .keystore 进行指认别名；如果没有默认是 mykey  
　　-keyalg 指定密钥的算法 RSA/DSA 默认是 DSA  
1）生成 keystore 的密码及相应信息的密钥库

[duoduo@hadoop102 hadoop-2.7.2]$ keytool -keystore keystore -alias jetty -genkey -keyalg RSA
    
    输入 keystore 密码：123456
    再次输入新密码: 123456
    您的名字与姓氏是什么？
      [Unknown]： 
    您的组织单位名称是什么？
      [Unknown]： 
    您的组织名称是什么？
      [Unknown]： 
    您所在的城市或区域名称是什么？
      [Unknown]： 
    您所在的州或省份名称是什么？
      [Unknown]： 
    该单位的两字母国家代码是什么
      [Unknown]：  CN
    CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=CN 正确吗？
      [否]：  y
    
    输入<jetty>的主密码
            （如果和 keystore 密码相同，按回车）： 
    再次输入新密码:

`注意`：密钥库的密码至少必须 6 个字符，可以是纯数字或者字母或者数字和字母的组合等等，密钥库的密码最好和 jetty 的密钥相同，方便记忆。

2）将 keystore 拷贝到 azkaban web 服务器根目录中

mv keystore /opt/module/azkaban/server/

### **3.3 时间同步配置** ###

先配置好服务器节点上的时区  
1）如果在 /usr/share/zoneinfo/ 这个目录下不存在时区配置文件 Asia/Shanghai，就要用 tzselect 生成。

[duoduo@hadoop102 Asia]$ tzselect
    Please identify a location so that time zone rules can be set correctly.
    Please select a continent or ocean.
     1) Africa
     2) Americas
     3) Antarctica
     4) Arctic Ocean
     5) Asia
     6) Atlantic Ocean
     7) Australia
     8) Europe
     9) Indian Ocean
    10) Pacific Ocean
    11) none - I want to specify the time zone using the Posix TZ format.
    #? 5
    Please select a country.
     1) Afghanistan          18) Israel            35) Palestine
     2) Armenia          19) Japan         36) Philippines
     3) Azerbaijan          20) Jordan            37) Qatar
     4) Bahrain          21) Kazakhstan        38) Russia
     5) Bangladesh          22) Korea (North)     39) Saudi Arabia
     6) Bhutan          23) Korea (South)     40) Singapore
     7) Brunei          24) Kuwait            41) Sri Lanka
     8) Cambodia          25) Kyrgyzstan        42) Syria
     9) China          26) Laos          43) Taiwan
    10) Cyprus          27) Lebanon           44) Tajikistan
    11) East Timor          28) Macau         45) Thailand
    12) Georgia          29) Malaysia          46) Turkmenistan
    13) Hong Kong          30) Mongolia          47) United Arab Emirates
    14) India          31) Myanmar (Burma)       48) Uzbekistan
    15) Indonesia          32) Nepal         49) Vietnam
    16) Iran          33) Oman          50) Yemen
    17) Iraq          34) Pakistan
    #? 9
    Please select one of the following time zone regions.
    1) Beijing Time
    2) Xinjiang Time
    #? 1
    The following information has been given:
        China
        Beijing Time
    Therefore TZ='Asia/Shanghai' will be used.
    Local time is now:    Wed Jun 14 09:16:46 CST 2017.
    Universal Time is now:    Wed Jun 14 01:16:46 UTC 2017.
    Is the above information OK?
    1) Yes
    2) No
    #? 1

2）拷贝该时区文件，覆盖系统本地时区配置

cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

3）集群时间同步

sudo date -s ‘2017-06-14 09:23:45’hwclock -w

### **3.4 配置文件** ###

#### **3.4.1 Web 服务器配置** ####

1）进入 azkaban web 服务器安装目录 conf 目录，打开 azkaban.properties 文件

pwd/opt/module/azkaban/server/conf
    vim azkaban.properties

2）按照如下配置修改 azkaban.properties 文件。

#Azkaban Personalization Settings
    #服务器 UI 名称，用于服务器上方显示的名字
    azkaban.name=Test
    #描述
    azkaban.label=My Local Azkaban
    #UI 颜色
    azkaban.color=#FF3601
    azkaban.default.servlet.path=/index
    #默认 web server 存放 web 文件的目录
    web.resource.dir=/opt/module/azkaban/server/web/
    #默认时区，已改为亚洲/上海，默认为美国/洛杉矶
    default.timezone.id=Asia/Shanghai
    
    #Azkaban UserManager class
    user.manager.class=azkaban.user.XmlUserManager
    #用户权限管理默认类（绝对路径）
    user.manager.xml.file=/opt/module/azkaban/server/conf/azkaban-users.xml
    
    #Loader for projects
    #global 配置文件所在位置（绝对路径）
    executor.global.properties=/opt/module/azkaban/executor/conf/global.properties
    azkaban.project.dir=projects
    
    #数据库类型
    database.type=mysql
    #端口号
    mysql.port=3306
    #数据库连接 IP
    mysql.host=hadoop102
    #数据库实例名
    mysql.database=azkaban
    #数据库用户名
    mysql.user=root
    #数据库密码
    mysql.password=123456
    #最大连接数
    mysql.numconnections=100
    
    # Velocity dev mode
    velocity.dev.mode=false
    
    # Azkaban Jetty server properties.
    # Jetty 服务器属性
    #最大线程数
    jetty.maxThreads=25
    #Jetty SSL 端口
    jetty.ssl.port=8443
    #Jetty 端口
    jetty.port=8081
    #SSL 文件名（绝对路径）
    jetty.keystore=/opt/module/azkaban/server/keystore
    #SSL 文件密码
    jetty.password=123456
    #Jetty 主密码与 keystore 文件相同
    jetty.keypassword=123456
    #SSL 文件名（绝对路径）
    jetty.truststore=/opt/module/azkaban/server/keystore
    #SSL 文件密码
    jetty.trustpassword=123456
    
    # Azkaban Executor settings
    executor.port=12321
    
    # mail settings
    mail.sender=
    mail.host=
    job.failure.email=
    job.success.email=
    
    lockdown.create.projects=false
    
    cache.directory=cache

2）web 服务器用户配置  
在 azkaban web 服务器安装目录 conf 目录，按照如下配置修改 azkaban-users.xml 文件，增加管理员用户。

<azkaban-users>
        <user username="azkaban" password="azkaban" roles="admin" groups="azkaban" />
        <user username="metrics" password="metrics" roles="metrics"/>
        <user username="admin" password="admin" roles="admin" />
        <role name="admin" permissions="ADMIN" />
        <role name="metrics" permissions="METRICS"/>
    </azkaban-users>

#### **3.4.2 执行服务器配置** ####

1）进入执行服务器安装目录 conf，打开 azkaban.properties

pwd/opt/module/azkaban/executor/
    vim azkaban.properties

2）按照如下配置修改 azkaban.properties 文件。

#Azkaban
    #时区
    default.timezone.id=Asia/Shanghai
    
    # Azkaban JobTypes Plugins
    #jobtype 插件所在位置
    azkaban.jobtype.plugin.dir=plugins/jobtypes
    
    #Loader for projects
    executor.global.properties=/opt/module/azkaban/executor/conf/global.properties
    azkaban.project.dir=projects
    
    database.type=mysql
    mysql.port=3306
    mysql.host=hadoop102
    mysql.database=azkaban
    mysql.user=root
    mysql.password=123456
    mysql.numconnections=100
    
    # Azkaban Executor settings
    #最大线程数
    executor.maxThreads=50
    #端口号(如修改，请与 web 服务中一致)
    executor.port=12321
    #线程数
    executor.flow.threads=30

### **3.5 启动执行服务器** ###

在执行服务器目录下执行启动命令

pwd/opt/module/azkaban/executor
    bin/azkaban-executor-start.sh

### **3.6 启动 web 服务器** ###

在 azkaban web 服务器目录下执行启动命令

pwd/opt/module/azkaban/server
    bin/azkaban-web-start.sh

`注意`：先执行 executor，再执行 web，避免 Web Server 会因为找不到执行器启动失败。  
jps 查看进程

3601 AzkabanExecutorServer
    5880 Jps
    3661 AzkabanWebServer

启动完成后，在浏览器(建议使用谷歌浏览器)中输入：  
https://服务器IP地址:8443，即可访问 azkaban 服务了。  
在登录中输入刚才新的户用名及密码，点击 login。

![format_png 2][]

登录之后的页面

![format_png 3][]

`注意`：访问的协议必须是 https，http 协议访问不了。

## **四 Azkaban 实战** ##

Azkaba 内置的任务类型支持 command、java。

### **4.1 Command 类型之单 job 工作流案例** ###

1）创建 job 描述文件

vim command.job
    #command.job
    type=command                                                    
    command=echo 'hello'

2）将 job 资源文件打包成zip文件

3）通过 azkaban 的 web 管理平台创建 project 并上传 job 压缩包  
首先创建 project

![format_png 4][]

上传 zip 包

![format_png 5][]

4）启动执行该 job

![format_png 6][]

### **4.2 Command 类型之多 job 工作流案例** ###

1）创建有依赖关系的多个 job 描述  
第一个 job：foo.job

# foo.jobtype=command
    command=echo foo

第二个job：bar.job 依赖 foo.job

# bar.jobtype=command
    dependencies=foo
    command=echo bar

2）将所有 job 资源文件打到一个 zip 包中

![format_png 7][]

3）创建工程

![format_png 8][]

3）在 azkaban 的 web 管理界面创建工程并上传 zip 包

![format_png 9][]

4）启动工作流 flow  
(1)

![format_png 10][]

(2)

![format_png 11][]

(3)

![format_png 12][]

5）查看结果

![format_png 13][]

### **4.3 HDFS 操作任务** ###

1）创建 job 描述文件

# fs.jobtype=command
    command=/opt/module/hadoop-2.7.2/bin/hadoop fs -mkdir /azkaban

2）将 job 资源文件打包成 zip 文件

![format_png 14][]

3）通过 azkaban 的 web 管理平台创建 project 并上传 job 压缩包  
4）启动执行该 job  
5）查看结果

### **4.4 MapReduce 任务** ###

Mr 任务依然可以使用 command 的 job 类型来执行  
1）创建 job 描述文件，及 mr 程序 jar 包（示例中直接使用 hadoop 自带的 example jar）

# mrwc.jobtype=command
    command=/opt/module/hadoop-2.7.2/bin/hadoop jar hadoop-mapreduce-examples-2.7.2.jar wordcount /wordcount/input /wordcount/output

2）将所有 job 资源文件打到一个 zip 包中

![format_png 15][]

3）在 azkaban 的 web 管理界面创建工程并上传 zip 包  
4）启动 job

### **4.5 HIVE 脚本任务** ###

1）创建 job 描述文件和 hive 脚本  
（1）Hive脚本： test.sql

use default;
    drop table aztest;
    create table aztest(id int, name string) 
    row format delimited fields terminated by ',';
    load data inpath '/aztest/hiveinput' into table aztest;
    create table azres as select * from aztest;
    insert overwrite directory '/aztest/hiveoutput' select count(1) from aztest;

（2）Job描述文件：hivef.job

# hivef.jobtype=command
    command=/opt/module/hive/bin/hive -f 'test.sql'

2）将所有 job 资源文件打到一个 zip 包中  
3）在 azkaban 的 web 管理界面创建工程并上传 zip 包  
4）启动 job

[format_png]: /images/20230521/136773ec4cb94977a5e6aac995d3324a.png
[format_png 1]: /images/20230521/a3892de9a3c64bd2bb890047b1c03324.png
[http_azkaban.github.io_downloads.html]: http://azkaban.github.io/downloads.html
[format_png 2]: /images/20230521/6b775340c0774729978c9b1953415991.png
[format_png 3]: /images/20230521/852ef917387045dab1ca992c585787de.png
[format_png 4]: /images/20230521/3f02ecf9ece54a63b9ed7b7206d94d1b.png
[format_png 5]: /images/20230521/ad42f9232f5046349d06a94e8cd82fe9.png
[format_png 6]: /images/20230521/e4a29a8adae3494baa2355ba41f4db6e.png
[format_png 7]: /images/20230521/4978568595864dc694d2183ce17f9ce6.png
[format_png 8]: /images/20230521/2bcb7e324d4144088d2c655868fcb947.png
[format_png 9]: /images/20230521/a15d694106934ca9879aae32e81d4936.png
[format_png 10]: /images/20230521/bfdbd578a8cf49d785a0e30b284974a2.png
[format_png 11]: /images/20230521/183c891c458447acb6ca5119327c64b1.png
[format_png 12]: /images/20230521/415a561842dc4f1a9c39f6879830dd83.png
[format_png 13]: /images/20230521/ba779bc8befb4d4ca119ef83a163d380.png
[format_png 14]: /images/20230521/2b9ef1e854e44a1abe2390fe4d22a2d5.png
[format_png 15]: /images/20230521/00985a914fcd494a852602dd9f8e108c.png