Dolphinscheduler集群部署
1、Dolphinscheduler部署背景-基础软件安装
- PostgreSQL (8.2.15+) or MySQL (5.7系列):两者任选其一即可,如 MySQL 则需要 JDBC Driver 5.1.47+
- JDK (1.8+):必装,请安装好后在 /etc/profile 下配置 JAVA_HOME 及 PATH 变量
- ZooKeeper (3.4.6+):必装
- pstree or psmisc:Mac OS必装pstree,Fedora/Red/Hat/CentOS/Ubuntu/Debian必装psmisc
- Hadoop (2.6+) or MinIO:选装,如果需要用到资源上传功能,可以选择上传到 Hadoop or MinIO 上
注意:DolphinScheduler本身不依赖 Hadoop、Hive、Spark,仅是会调用他们的 Client,用于提交对应的任务
2、集群部署规划
组件分布 | ds1 | ds2 | ds3 | ds4 | ds5 | ds6 |
---|---|---|---|---|---|---|
master | 1 | 1 | 0 | 0 | 0 | 0 |
worker | 0 | 0 | 0 | 1 | 1 | 1 |
alertServer | 0 | 1 | 0 | 0 | 0 | 0 |
apiServer | 1 | 0 | 0 | 0 | 0 | 0 |
install hosts | 1 | 1 | 0 | 0 | 1 | 1 |
single Yarnlp | 1 | 0 | 0 | 0 | 0 | 0 |
yarn Halps | 1 | 1 | 0 | 0 | 0 | 0 |
zk cluster | 1 | 1 | 1 | 0 | 0 | 0 |
dbhost | 1 | 0 | 0 | 0 | 0 | 0 |
3、下载二进制tar.gz包
- ds1作为主节点,创建 /opt/dolphinscheduler 做为安装部署目录,下载(下载地址)最新版的后端安装包(apache-dolphinscheduler-1.3.6-bin.tar.gz),上传 tar 包至创建的部署目录,解压。
# 创建部署目录,部署目录不要创建在 /root、/home 等高权限目录
mkdir -p /opt/dolphinscheduler
cd /opt/dolphinscheduler
# 解压缩
tar -zxvf apache-dolphinscheduler-1.3.8-bin.tar.gz -C /opt/dolphinscheduler
mv apache-dolphinscheduler-1.3.8-bin dolphinscheduler-bin
4、创建部署用户和hosts映射
- 在所有待部署Dolphinscheduler的机器上创建部署用户,需配置 sudo 免密。
# 用root登录后创建部署用户:dolphinscheduler
useradd dolphinscheduler
# 设置用户密码为:dolphinscheduler
echo "dolphinscheduler" | passwd --stdin dolphinscheduler
# 配置 sudo 免密
echo 'dolphinscheduler ALL=(ALL) NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
sed -i 's/Defaults requirett/#Defaults requirett/g' /etc/sudoers
注意:
- 因为 Dolphinscheduler 是以 sudo -u {linux-user} 切换不同 linux 用户的方式实现多租户运行作业,所以部署用户需有 sudo 权限,而且免密
- 若 /etc/sudoers 文件中有 “Default requiretty” 行,需注释
- 若使用资源上传功能,需在 HDFS 或者 MinIO 上给部署用户dolphinscheduler分配读写权限
5、配置hosts映射和ssh打通及修改目录权限
- 在部署机 ds1 上配置所有待部署机器的 hosts,用 root 用户登录ds1
vi /etc/hosts
# add ip hostname
192.168.xxx.xxx ds1
192.168.xxx.xxx ds2
...
192.168.xxx.xxx ds5
注意:需注释 127.0.0.1 这行
- 同步 ds1 上的 /etc/hosts 到所有部署机器
for ip in ds2 ... ds5; # 请将此处 ds2 ... ds5 替换为自己要部署的机器的 hostname
do
sudo scp -r /etc/hosts $ip:/etc/ # 在运行中需要输入 root 密码
done
- 在 ds1 上,切换到部署用户并配置 ssh 本机免密登录
su dolphinscheduler;
ssh-keygen -t rsa -P '' -f ~/.ssh/id_rsa
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
注意:正常设置后,dolphinscheduler 用户在执行命令 ssh localhost 是不需要再输入密码
- 在 ds1 上,配置部署用户 dolphinscheduler ssh 打通到其他待部署的机器
su dolphinscheduler;
for ip in ds2 ds3 ... ds5; # 将 ds2 ds3 替换为要部署的机器的 hostname
do
ssh-copy-id $ip # 该操作执行过程中需要手动输入 dolphinscheduler 用户的密码
done
# 当然 通过 sshpass -p xxx ssh-copy-id $ip 就可以省去输入密码了
- 在 ds1 上,修改目录权限,使得部署用户对 dolphinscheduler-bin 目录有操作权限
sudo chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-bin
6、数据库初始化
- 进入数据库,默认数据库是 PostgreSQL,如选择 MySQL 的话,后续需添加 mysql-connector-java 驱动包到 DolphinScheduler 的 lib 目录,如下:
mysql -h192.168.xx.xx -P3306 -uroot -p
- 进入数据库命令行窗口后,执行数据库初始化命令,设置访问账号和密码。注: {user} 和 {password} 需要替换为具体的数据库用户名和密码
mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'%' IDENTIFIED BY '{password}';
mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'localhost' IDENTIFIED BY '{password}';
mysql> flush privileges;
-
创建表和导入基础数据
-
修改 conf 目录下 datasource.properties 中的下列配置
vi conf/datasource.properties
-
如果选择 MySQL,请注释掉 PostgreSQL 相关配置(反之同理),还需要手动添加 [ mysql-connector-java 驱动 jar ] 包到 lib 目录下,推荐mysql-connector-java-8.0.19.jar(兼容低版本),然后正确配置数据库连接相关信息
# postgre # spring.datasource.driver-class-name=org.postgresql.Driver # spring.datasource.url=jdbc:postgresql://localhost:5432/dolphinscheduler # mysql spring.datasource.driver-class-name=com.mysql.jdbc.Driver spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true 需要修改ip spring.datasource.username=xxx 需要修改为上面的{user}值 spring.datasource.password=xxx 需要修改为上面的{password}值
-
修改并保存完后,执行 script 目录下的创建表及导入基础数据脚本
sh script/create-dolphinscheduler.sh
注意: 如果执行上述脚本报 “/bin/java: No such file or directory” 错误,请在/etc/profile 下配置 JAVA_HOME 及 PATH 变量
7、修改运行参数
- 修改 conf/env 目录下的 dolphinscheduler_env.sh 环境变量(以相关用到的软件都安装在 /opt/soft 下为例)
export HADOOP_HOME=/opt/soft/hadoop
export HADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop
# export SPARK_HOME1=/opt/soft/spark1
export SPARK_HOME2=/opt/soft/spark2
export PYTHON_HOME=/opt/soft/python
export JAVA_HOME=/opt/soft/java
export HIVE_HOME=/opt/soft/hive
export FLINK_HOME=/opt/soft/flink
export DATAX_HOME=/opt/soft/datax/bin/datax.py
export PATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$FLINK_HOME/bin:$DATAX_HOME:$PATH
注: 这一步非常重要,例如 JAVA_HOME 和 PATH 是必须要配置的,没有用到的可以忽略或者注释掉
- 将 JDK 软链到 /usr/bin/java 下(仍以 JAVA_HOME=/opt/soft/java 为例)
sudo ln -s /opt/soft/java/bin/java /usr/bin/java
- 修改一键部署配置文件 conf/config/install_config.conf 中的各参数,特别注意以下参数的配置
# 这里填 mysql or postgresql
dbtype="mysql"
# 数据库连接地址
dbhost="192.168.xx.xx:3306"
# 数据库名
dbname="dolphinscheduler"
# 数据库用户名,此处需要修改为上面设置的 {user} 具体值
username="xxx"
# 数据库密码,如果有特殊字符,请使用 \ 转义,需要修改为上面设置的 {password} 具体值
password="xxx"
# Zookeeper 地址
zkQuorum="192.168.xx.xx:2181,192.168.xx.xx:2181,192.168.xx.xx:2181"
# 将 DS 安装到哪个目录,如: /opt/soft/dolphinscheduler,不同于现在的目录
installPath="/opt/local/dolphinscheduler"
# 使用哪个用户部署,使用第 3 节创建的用户
deployUser="dolphinscheduler"
# 邮件配置,以 163 邮箱为例
# 邮件协议
mailProtocol="SMTP"
# 邮件服务地址
mailServerHost="smtp.163.com"
# 邮件服务端口
mailServerPort="25"
# mailSender和 mailUser 配置成一样即可
# 发送者
mailSender="xxxx@163.com"
# 发送用户
mailUser="xxxx@163.com"
# 邮箱密码(授权码,详见邮箱告警配置文档)
mailPassword="xxx"
# TLS 协议的邮箱设置为 true,否则设置为 false
starttlsEnable="true"
# 开启 SSL 协议的邮箱配置为 true,否则为 false。注意: starttlsEnable 和 sslEnable 不能同时为 true
sslEnable="false"
# 邮件服务地址值,参考上面 mailServerHost
sslTrust="smtp.163.com"
# 业务用到的比如 sql 等资源文件上传到哪里,可以设置:HDFS,S3,NONE,单机如果想使用本地文件系统,请配置为 HDFS,因为 HDFS 支持本地文件系统;如果不需要资源上传功能请选择 NONE。强调一点:使用本地文件系统不需要部署 hadoop
resourceStorageType="HDFS"
# 如果上传资源保存想保存在 hadoop 上,hadoop 集群的 NameNode 启用了 HA 的话,需要将 hadoop 的配置文件 core-site.xml 和 hdfs-site.xml 放到安装路径的 conf 目录下,本例即是放到 /opt/soft/dolphinscheduler/conf 下面,并配置 namenode cluster 名称;如果 NameNode 不是 HA,则只需要将 mycluster 修改为具体的 ip 或者主机名即可
defaultFS="hdfs://mycluster:8020"
# 如果没有使用到 Yarn,保持以下默认值即可;如果 ResourceManager 是 HA,则配置为 ResourceManager 节点的主备 ip 或者 hostname,比如 "192.168.xx.xx,192.168.xx.xx";如果是单 ResourceManager 请配置 yarnHaIps="" 即可
yarnHaIps="192.168.xx.xx,192.168.xx.xx"
# 如果 ResourceManager 是 HA 或者没有使用到 Yarn 保持默认值即可;如果是单 ResourceManager,请配置真实的 ResourceManager 主机名或者 ip
singleYarnIp="yarnIp1"
# 资源上传根路径,主持 HDFS 和 S3,由于 hdfs支持本地文件系统,需要确保本地文件夹存在且有读写权限
resourceUploadPath="/data/dolphinscheduler"
# 具备权限创建 resourceUploadPath的用户
hdfsRootUser="hdfs"
# 在哪些机器上部署 DS 服务,本机选 localhost
ips="ds1,ds2,ds3,ds4"
# ssh 端口,默认22
sshPort="22"
# master 服务部署在哪台机器上
masters="ds1,ds2"
# worker 服务部署在哪台机器上,并指定此 worker 属于哪一个 worker 组,下面示例的 default 即为组名
workers="ds3:default,ds4:default"
# 报警服务部署在哪台机器上
alertServer="ds2"
# 后端 api 服务部署在在哪台机器上
apiServers="ds1"
特别注意:如果需要用资源上传到 Hadoop 集群功能, 并且 Hadoop 集群的 NameNode 配置了 HA 的话 ,需要开启 HDFS 类型的资源上传,同时需要将 Hadoop 集群下的 core-site.xml 和 hdfs-site.xml 复制到 /opt/dolphinscheduler/conf,非 NameNode HA 跳过次步骤
8、一键部署
- 切换到部署用户 dolphinscheduler,然后执行一键部署脚本
sh install.sh
注意:第一次部署的话,在运行中第 3 步 3,stop server 出现 5 次以下信息,此信息可以忽略
sh: bin/dolphinscheduler-daemon.sh: No such file or directory
- 脚本完成后,会启动以下 5 个服务,使用 jps 命令查看服务是否启动( jps 为 JDK 自带)
MasterServer ----- master服务
WorkerServer ----- worker服务
LoggerServer ----- logger服务
ApiApplicationServer ----- api服务
AlertServer ----- alert服务
如果以上服务都正常启动,说明自动部署成功
部署成功后,可以进行日志查看,日志统一存放于 logs 文件夹内
logs/
├── dolphinscheduler-alert-server.log
├── dolphinscheduler-master-server.log
|—— dolphinscheduler-worker-server.log
|—— dolphinscheduler-api-server.log
|—— dolphinscheduler-logger-server.log
9、登录系统
- 访问前端页面地址,接口 ip (自行修改) http://192.168.xx.xx:12345/dolphinscheduler,用户名密码:admin/dolphinscheduler123
10、启停服务
- 一键停止集群所有服务
sh ./bin/stop-all.sh
- 一键开启集群所有服务
sh ./bin/start-all.sh
- 启停 Master
sh ./bin/dolphinscheduler-daemon.sh start master-server
sh ./bin/dolphinscheduler-daemon.sh stop master-server
- 启停 Worker
sh ./bin/dolphinscheduler-daemon.sh start worker-server
sh ./bin/dolphinscheduler-daemon.sh stop worker-server
- 启停 Api
sh ./bin/dolphinscheduler-daemon.sh start api-server
sh ./bin/dolphinscheduler-daemon.sh stop api-server
- 启停 Logger
sh ./bin/dolphinscheduler-daemon.sh start logger-server
sh ./bin/dolphinscheduler-daemon.sh stop logger-server
- 启停 Alert
sh ./bin/dolphinscheduler-daemon.sh start alert-server
sh ./bin/dolphinscheduler-daemon.sh stop alert-server