备注:自己在CentOS7.5下安装superset2.0成功。数据库以本地sqlite为准。Superset是由Python语言编写的Web应用,Superset2.0版本要求Python3.9的环境。
1、安装Miniconda
原因:conda是一个开源的包、环境管理器,可以用于在同一个机器上安装不同Python版本的软件包及其依赖,并能够在不同的Python环境之间切换,Anaconda包括Conda、Python以及一大堆安装好的工具包,比如:numpy、pandas等,Miniconda包括Conda、Python。
此处,我们不需要如此多的工具包,故选择MiniConda。
1)下载Miniconda(Python3版本)
下载地址:https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
2)安装Miniconda
(1)执行以下命令进行安装,并按照提示操作,直到安装完成。
[root@*************** software]# bash Miniconda3-latest-Linux-x86_64.sh
(2)在安装过程中,出现以下提示时,可以指定安装路径
[/root/miniconda3] >>> /opt/module/miniconda3
(3)出现以下字样,即为安装完成
3)加载环境变量配置文件,使之生效
[root@*************** software]# source ~/.bashrc
4)取消激活base环境
Miniconda安装完成后,每次打开终端都会激活其默认的base环境,我们可通过以下命令,禁止激活默认base环境。
[root@*************** software]# conda config --set auto_activate_base false
2、 创建Python3.9环境
1)配置conda国内镜像
[root@*************** software]# conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
[root@*************** software]# conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
[root@*************** software]# conda config --set show_channel_urls yes
2)创建superset环境并指定Python3.9
[root@*************** software]# conda create --name superset python=3.9
说明:conda环境管理常用命令
创建环境:conda create -n env_name
查看所有环境:conda info --envs
删除一个环境:conda remove -n env_name --all
3)激活superset环境
[root@*************** software]# conda activate superset
激活后效果如下图所示
说明:退出当前环境
(superset) [root@*************** software]# conda deactivate
4)执行python命令查看python版本
(superset) [root@*************** software]# python -V
3、Superset部署
[root@*************** software]# conda activate superset
1)安装依赖(之后操作均在superset环境下)
安装Superset之前,需安装以下所需依赖
(superset) [root@*************** software]$ sudo yum install -y gcc gcc-c++ libffi-devel python-devel python-pip python-wheel python-setuptools openssl-devel cyrus-sasl-devel openldap-devel
2)安装(更新)setuptools和pip
(superset) [root@*************** software]$ pip install --upgrade setuptools pip -i https://pypi.douban.com/simple/
说明:pip是python的包管理工具,可以和centos中的yum类比,该命令会把setuptools由65.5.0升级为65.6.0,之后执行superset db upgrade时可能会报错“cannot import name 'Log' from 'distutils.log'”,将setuptools降为65.5.0版本即可。
3)安装Supetset
(superset) [root@*************** software]$ pip install apache-superset==2.0.0 -i https://pypi.douban.com/simple/
说明:-i的作用是指定镜像,这里选择国内镜像
备注:如果遇到网络问题,可以反复执行,直至成功;
4)初始化Supetset数据库
(superset) [root@*************** software]$ superset db upgrade
该步骤可能遇到的问题:
(1)“Could not locate a Flask application. Use the 'flask --app' option, 'FLASK_APP' environment variable, or a 'wsgi.py' or 'app.py' file in the current directory.”
执行一下:export FLASK_APP=superset即可;
(2)“ImportError: cannot import name 'soft_unicode' from 'markupsafe'”
这是markupfile版本不兼容的问题,执行一下:python -m pip install markupsafe==2.0.1即可;
(3)ModuleNotFoundError: No module named 'werkzeug.wrappers.etag'
# 这个是在 superset 2.0 版本出现的bug,通过降低Werkzeug的版本解决
python -m pip uninstall -y Werkzeug
python -m pip install Werkzeug==2.0.3
(4)“TypeError: __init__() got an unexpected keyword argument 'unbound_message'”
# 这个是在 superset 2.0 版本出现的bug,需要降低Flask的版本到2.0.3
python -m pip uninstall -y Flask
python -m pip install Flask==2.0.3
(5)“ModuleNotFoundError: No module named 'wtforms.ext'”
# 这个是因为WTForms 3.0的版本去掉了ext,需要降低WTForms的版本到2.3.3
python -m pip uninstall -y WTForms
python -m pip install WTForms==2.3.3
(6)cannot import name 'Log' from 'distutils.log'
这是由于setuptools为65.6.0版本的原因,将setuptools降为65.5.0版本即可。pip install setuptools=65.5.0即可(也可以在上面升级setuptools和pip时不升级setuptools)
5)创建管理员用户
(superset)[root@*************** software]$ export FLASK_APP=superset
(superset)[root@*************** software]$ superset fab create-admin
说明:flask是一个python web框架,Superset使用的就是flask
6)Superset初始化
(superset) [root@*************** software]$ superset init
4、superset启动
1)安装gunicorn
(superset) [atguigu@hadoop102 ~]$ pip install gunicorn -i https://pypi.douban.com/simple/
说明:gunicorn是一个Python Web Server,可以和java中的TomCat类比
2)启动Superset
(1)确保当前conda环境为superset,及下图所示
(superset) [root@*************** software]$
(2)对外开放端口8080
/sbin/iptables -I INPUT -p tcp --dport 8080 -j ACCEPT
(3)启动
(superset) [root@*************** software]$ gunicorn --workers 5 --timeout 120 --bind 127.0.0.1:8080 "superset.app:create_app()" --daemon
说明:
--workers:指定进程个数
--timeout:worker进程超时时间,超时会自动重启
--bind:绑定本机地址,即为Superset访问地址
--daemon:后台运行
(4)登录Superset
访问http://IP地址:8080,并使用之前创建的管理员账号进行登录。
3)停止superset
停掉gunicorn进程
(superset) [atguigu@hadoop102 ~]$ ps -ef | awk '/superset/ && !/awk/{print $2}' | xargs kill -9
退出superset环境
(superset) [atguigu@hadoop102 ~]$ conda deactivate