[리눅스] JupyterHub 설치 방법

 

---

리눅스 환경 (CentOS 7, Python3.8)에서 JupyterHub 설치 방법 공유합니다.

설치 전 Jupyter 용어 관련하여 간략하게 정리 하겠습니다.

 

Jupyter Notebook

• 대화형 Python Interpreter로 웹 환경에서 Python 코드 작성 및 실행하는 개발 환경(tool)

Jupyter Lab

• Jupyter Notebook의 차세대 버전으로 사용자 편의 기능들이 추가됨
• 다중창 지원, csv/pdf 등 파일도 열 수 있어서 대시보드처럼 사용 가능

JupyterHub

• 멀티 사용자 환경에서 Jupyter Notebook/Lab을 사용
  
  
  

📖 설치 방법

1. os 패키지 설치

yum install –y nodejs
yum install openssl

 

2. nodejs 패키지 설치

 ◾ 설치 과정 중 nodejs, npm 버전이 너무 낮아 계속 install 실패하여 최신 버전으로 설치 후 해결

npm install -g configurable-http-proxy

 

3. python 패키지 설치

pip3 install sudospawner
pip3 install jupyterlab

 

4. 계정/그룹 생성 및 권한 설정

useradd admin
passwd admin

groupadd jupyterhub
usermod -a -G jupyterhub admin

visudo
-----------------------------------------------------
Cmnd_Alias JUPYTER_CMD = /usr/local/bin/sudospawner
admin ALL=(%jupyterhub) NOPASSWD:JUPYTER_CMD
-----------------------------------------------------

 

 ◾ 사용자 추가

useradd user01
passwd user01
usermod -a -G jupyterhub user01

 

5. 설정 파일 생성 및 작성 (Ldap 설정 포함)

mkdir /etc/jupyterhub
chown admin:admin /etc/jupyterhub

cd /etc/jupyterhub
sudo -u admin /usr/local/bin/jupyterhub --generate-config

vi jupyterhub_config.py
-----------------------------------------------------------------------------------------------
c.JupyterHub.hub_connect_ip = '0.0.0.0'
c.JupyterHub.port = 8000
c.JupyterHub.spawner_class = 'sudospawner.SudoSpawner'
c.SudoSpawner.sudospawner_path = '/usr/local/bin/sudospawner'
c.Spawner.default_url = '/lab'
c.JupyterHub.extra_log_file = '/var/log/jupyterhub/jupyterhub.log'
c.Application.log_format = '[%(asctime)s,%(msecs).03d] [%(levelname)s] [%(name)s] %(message)s'
c.Application.log_level = 0

##Ldap Configuration
c.LDAPAuthenticator.server_address = 'adserver.hadoop.com'
c.LDAPAuthenticator.server_port = 389
c.LDAPAuthenticator.lookup_dn = False
c.LDAPAuthenticator.bind_dn_template = [
"CN={username},OU=Users,OU=BIGDATA,DC=HADOOP,DC=COM",
]
-----------------------------------------------------------------------------------------------

 

6. jupyterhub 실행 및 접속 확인 (http://localhost:8000)

jupyterhub -f /etc/jupyterhub/jupyterhub_config.py

 

 

 ◾ 실행 중 아래와 같은 에러가 발생한다면, sqlite-devel 패키지 설치 및 python 재설치가 필요

Error: No module named '_sqlite3'

1) Install the sqlite-devel package:
    yum install -y sqlite-devel

2) Recompile python from the source:
    ./configure
    make
    make altinstall

 

7. 정상 확인 후 서비스 등록 및 실행

vi /usr/lib/systemd/system/jupyterhub.service
-------------------------------------------------------------------------------
[Unit]
Description=Jupyterhub

[Service]
User=root
ExecStart=/usr/local/bin/jupyterhub -f /etc/jupyterhub/jupyterhub_config.py
-------------------------------------------------------------------------------

systemctl daemon-reload
systemctl start jupyterhub