CentOS7にSupersetを構築する方法

構築要件

• Supersetは、VirtualEnvを使用して/var/superset配下に構築する。

• Supersetで通常使用されるデータベースはsqliteだが、MySQLに変更する。

  MySQL5.7をインストール&初期設定済みであるものとする。

• 使用するポートはデフォルトのままの8088。

インストール

関連ライブラリなど

• ライブラリ群をインストール

  terminal

   yum -y install git gcc gcc-c++ libffi-devel sqlite-devel openssl-devel cyrus-sasl-devel openldap-devel readline-devel
  

PyEnv & VirtualEnvインストール

• python環境はpyenv/virtualenvを通して構築する。

  terminal

   git clone https://github.com/yyuu/pyenv.git             /usr/local/src/pyenv
   git clone https://github.com/yyuu/pyenv-virtualenv.git  /usr/local/src/pyenv/plugins/pyenv-virtualenv	
   
   cat << \EOS > /etc/profile.d/pyenv.sh
   export PYENV_ROOT=/usr/local/src/pyenv
   export PATH=${PYENV_ROOT}/bin:${PATH}
   eval "$(pyenv init -)"
   eval "$(pyenv virtualenv-init -)"
   EOS
   	
   source /etc/profile.d/pyenv.sh
  

pythonインストール

• PyEnvを通して、Version 2.x.x/3.x.x(最新版はpyenv install --listで確認)をインストール。デフォルトは3.x.xにする。

  terminal

   source /etc/psourofile.d/pyenv.sh
   pyenv install --list
   pyenv install 2.7.13
   pyenv install 3.5.2
   pyenv install 3.6.0
   pyenv rehash
   pyenv global 3.6.0
  

• 確認

  terminal

   python --version
   
   Python 3.6.0
  

VirtualEnv環境構築

• /var/superset配下にVirtualEnv環境を構築

  terminal

   mkdir -p /var/superset
   cd /var/superset
   pyenv virtualenv 3.5.2 superset
   pyenv local superset
  

依存パッケージのインストール

• 必要なパッケージをインストール & 更新

  terminal

   cd /var/superset
   pip install --upgrade pip setuptools
  

supersetインストール

• pipからインストール

  terminal

   cd /var/superset
   pip install superset
  

初期設定

(スキップ可) 使用するDBをMariaDBに切り替える

以降の[...]は任意の値に置き換えること。

• MySQL develインストール

  terminal

   yum -y install mysql-community-devel --enablerepo=mysql57-community
  

• ドライバインストール

  terminal

   cd /var/superset
   pip install mysqlclient
  

• データベース作成

  terminal

   mysql -u root -p -e "DROP DATABASE IF EXISTS [database];CREATE DATABASE [database] DEFAULT CHARACTER SET utf8mb4;"
  

• ユーザー作成

   mysql -u root -p -e "GRANT ALL PRIVILEGES ON [database].* TO '[username]'@'[hostname]' IDENTIFIED BY '[password]' WITH GRANT OPTION;"
  

• 確認

  terminal

   mysql -u root -p -e "SHOW DATABASES;USE mysql;SELECT User,Host,Password FROM user";
  

• superset設定変更

  terminal

   cat << \EOS > /usr/local/src/pyenv/versions/3.5.2/envs/superset/bin/superset_config.py
   SQLALCHEMY_DATABASE_URI = 'mysql://[username]:[password]@[hostname]/[database]'
   EOS
  

adminユーザー作成

• 管理者ユーザーを作成する

  terminal

   cd /var/superset
   fabmanager create-admin --app superset --username admin --firstname admin --lastname user --email [e-mail] --password admin
  

データベースの初期化

• データベース初期化コマンドを実行

  terminal

   cd /var/superset
   superset db upgrade
  

(スキップ可) サンプルデータインポート

• サンプルデータ取込

  terminal

   cd /var/superset
   superset load_examples
  

ロール/パーミッション作成

• コマンド実行

  terminal

   cd /var/superset
   superset init
  

動作確認

起動

• 下記コマンドで実行する

  terminal

   cd /var/superset
   superset runserver -p 8088
  

確認

• ブラウザで http://[hostname]:8088 へアクセスし、下記画面が表示されればOK。

  

サービス化

• systemdで制御するよう設定する。

systemd設定

• Unit定義ファイルを作成

   cat << \EOS > /etc/systemd/system/superset.service
   [Unit]
   Description=superset
   After=network.target
   
   [Service]
   Type=simple
   EnvironmentFile=/etc/sysconfig/superset.conf
   WorkingDirectory=/var/superset
   ExecStart=/usr/local/src/pyenv/shims/superset runserver -p $PORT -w $WORKERS
   ExecReload=/bin/kill -HUP $MAINPID
   Restart=on-failure
   
   KillSignal=SIGINT
   
   [Install]
   WantedBy=multi-user.target
   EOS
  

• 設定ファイルを作成

  terminal

   cat << \EOS > /etc/sysconfig/superset.conf
   PORT=8088
   WORKERS=2
   EOS
  

• 確認

  terminal

   systemctl list-unit-files --type=service | grep superset
   
   superset.service                            disabled
  

• 自動起動設定

  terminal

   systemctl enable superset
   
   Created symlink from /etc/systemd/system/multi-user.target.wants/superset.service to /etc/systemd/system/superset.service.
  

サービス起動

起動

• systemctlで起動する

  terminal

   systemctl start superset
  

確認

• ブラウザで http://[hostname]:8088 へアクセスし、下記画面が表示されればOK。