Rocky Linux 9에 JupyterLab 설치하는 방법

Jupyter는 대화형 컴퓨팅 및 데이터 과학을 위한 무료 오픈 소스 웹 애플리케이션입니다.

Jupyter는 모든 프로그래밍 언어를 지원하며, 기능이 풍부하고 탭이 있는 다중 노트북 편집 환경을 제공하는 JupyterLab, 경량화되고 단순화된 노트북 작성 도구인 Notebook, Qtconsole 등 여러 소프트웨어를 제공합니다.

이 가이드에서는 Rocky Linux 9 서버에 JupyterLab을 설치하는 단계별 지침을 보여줍니다. JupyterLab을 설치하고, JupyterLab 인증을 활성화한 후, Nginx를 리버스 프록시로 설정합니다.

필수 조건

이 가이드를 완료하려면 다음을 준비해야 합니다:

• Rocky Linux 9 서버.
• sudo 권한이 있는 비루트 사용자.
• 상태가 허용된 SELinux.

종속성 설치

JupyterLab을 설치하기 전에 Rocky Linux 서버에 종속성을 설치해야 합니다. 여기에는 Pip, Node.js 및 개발 도구가 포함됩니다. 또한 리버스 프록시를 위해 Nginx도 설치합니다.

시작하려면 아래 명령어를 실행하여 시스템에 개발 패키지를 설치합니다.

sudo dnf -y groupinstall development

그런 다음, 아래 명령어를 사용하여 Pip, Node.js 및 Nginx를 설치합니다.

sudo dnf install -y python3-pip nodejs nginx

설치가 완료되면 다음 단계로 진행합니다.

Python 가상 환경 설정

이 예제에서는 일반 사용자로 JupyterLab을 설치하고 실행합니다. 따라서 sudo 권한이 있는 사용자를 준비했는지 확인하십시오.

아래 명령어를 사용하여 사용자로 로그인합니다.

su - user

새로운 ~/project 디렉토리를 만들고 그 안으로 이동합니다. 그런 다음, 새로운 Python 가상 환경 venv를 생성합니다.

mkdir -p ~/project; cd ~/project  
python3 -m venv venv

venv 가상 환경이 생성되면 아래 명령어를 사용하여 활성화할 수 있습니다.

source venv/bin/activate

여기서 프롬프트는 (venv) alice@hostname과 같이 변경되어야 하며, 이는 Python 가상 환경이 활성화되었음을 의미합니다.

JupyterLab 설치

이제 Python 가상 환경을 생성했으므로 JupyterLab을 설치할 준비가 되었습니다. 이 섹션에서는 JupyterLab을 설치하고, JupyterLab 구성을 생성하고, 비밀번호 인증을 설정한 후 JupyterLab을 확인합니다.

JupyterLab을 설치하려면 아래 pip3 명령어를 실행합니다.

pip3 install jupyter

설치가 시작되면 다음과 같은 출력이 표시됩니다:

설치가 완료되면 아래 명령어를 실행하여 Jupyter 바이너리 파일을 찾고 JupyterLab 버전을 확인합니다.

which jupyter  
jupyter --version

Python 가상 환경에 위치한 JupyterLab 바이너리 파일을 찾을 수 있어야 하며, JupyterLab 버전은 4.1.1입니다.

다음으로, 아래 Jupyter 명령어를 실행하여 Jupyter 서버 구성을 생성하고 비밀번호 인증을 설정합니다.

jupyter server --generate-config  
jupyter server password

비밀번호를 입력하라는 메시지가 표시되면 새 비밀번호를 입력하고 반복합니다.

다음으로, 아래 명령어를 실행하여 JupyterLab을 생성하고 덮어쓰기를 요청할 때 y를 입력합니다. 그런 다음 JupyterLab 구성을 확인합니다.

jupyter lab --generate-config  
jupyter lab --show-config

아래와 같이 비밀번호 인증이 해시되고 JupyterLab의 경로 위치에 접근할 수 있어야 합니다.

이제 아래 명령어를 실행하여 JupyterLab을 위해 포트 8888을 열 수 있습니다. 그런 다음, 로컬 IP 192.168.5.120에서 JupyterLab을 시작하고 IP 주소를 변경해야 합니다.

sudo firewall-cmd --add-port=8888/tcp  
jupyter lab --ip 192.168.5.120

시작되면 다음과 유사한 출력이 표시됩니다:

이제 웹 브라우저를 열고 포트 8888이 있는 로컬 IP 주소(http://192.168.5.120:8888/)를 방문합니다. JupyterLab 로그인 페이지가 표시됩니다.

비밀번호를 입력하고 로그인을 누릅니다.

성공하면 다음과 같은 JupyterLab 대시보드가 표시됩니다:

마지막으로 터미널로 돌아가 Ctrl+c를 눌러 JupyterLab 프로세스를 종료합니다. 다음 단계에서는 JupyterLab을 systemd 서비스로 설정합니다.

JupyterLab을 Systemd 서비스로 실행

JupyterLab이 설치되었으므로 이제 JupyterLab을 위한 새로운 systemd 서비스를 생성합니다. 이를 통해 시스템 유틸리티를 통해 JupyterLab을 쉽게 관리할 수 있습니다. 또한 서비스를 활성화하여 부팅 시 JupyterLab을 시작할 수 있습니다.

이제 아래 nano 편집기 명령어를 실행하여 새로운 jupyterlab 서비스 /etc/systemd/system/jupyterlab.service를 생성합니다.

sudo nano /etc/systemd/system/jupyterlab.service

파일에 아래 구성을 추가하고 사용자 세부 정보를 자신의 사용자로 변경해야 합니다. 여기에는 Jupyter 프로그램의 바이너리 경로와 생성된 구성이 포함됩니다.

[Unit]  
Description=JupyterLab Service  
  
[Service]  
Type=simple  
PIDFile=/run/jupyter.pid  
ExecStart=/home/alice/project/venv/bin/jupyter lab --config=/home/alice/.jupyter/jupyter_lab_config.py  
User=alice  
Group=alice  
WorkingDirectory=/home/alice/project  
Restart=always  
RestartSec=10  
  
[Install]  
WantedBy=multi-user.target

완료되면 파일을 저장하고 종료합니다.

다음으로, 아래 명령어를 실행하여 systemd 관리자를 다시 로드하고 systemd 변경 사항을 적용합니다.

sudo systemctl daemon-reload

그런 다음, 아래 명령어를 사용하여 jupyterlab 서비스를 시작하고 활성화합니다.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

시작되면 아래 명령어를 실행하여 jupyterlab 서비스를 확인합니다.

sudo systemctl status jupyterlab

jupyterlab 서비스가 실행 중이면 다음과 같은 출력이 표시됩니다:

JupyterLab의 원격 액세스 구성

JupyterLab을 리버스 프록시 뒤에서 실행하려면 JupyterLab 설치에서 원격 액세스를 활성화해야 합니다. 기본 JupyterLab 구성 스크립트를 수정하고 거기에서 원격 액세스를 활성화해야 합니다.

아래 nano 편집기 명령어를 실행하여 JupyterLab 구성 스크립트 ~/.jupyter/jupyter_lab_config.py를 엽니다.

nano ~/.jupyter/jupyter_lab_config.py

매개변수 c.ServerApp.allow_remote_access의 주석을 제거하고 값을 True로 변경합니다. 이렇게 하면 JupyterLab 설치에서 리버스 프록시를 위한 원격 액세스가 활성화됩니다.

c.ServerApp.allow_remote_access = True

완료되면 파일을 저장하고 종료합니다.

다음으로, 아래 명령어를 실행하여 JupyterLab 서비스를 재시작하고 생성된 토큰을 확인합니다. 이 토큰은 리버스 프록시 아래에서 JupyterLab에 로그인하는 데 사용됩니다.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

서비스 로그 하단에서 JupyterLab 토큰을 확인할 수 있습니다.

Nginx 리버스 프록시 설정

이제 JupyterLab에서 원격 액세스를 허용했으므로 Nginx를 JupyterLab 설치를 위한 리버스 프록시로 구성할 준비가 되었습니다.

먼저, 아래 nano 편집기 명령어를 실행하여 새로운 Nginx 구성 /etc/nginx/conf.d/jupyterlab.conf를 생성합니다.

sudo nano /etc/nginx/conf.d/jupyterlab.conf

아래 구성을 삽입하고 도메인 이름을 로컬 JupyterLab 설치에 맞게 변경해야 합니다.

server {  
listen 80;  
server_name jupyterlab.howtoforge.local;  
  
access_log /var/log/nginx/howtoforge.local.access.log;  
error_log /var/log/nginx/howtoforge.local.error.log;  
  
location / {  
proxy_pass http://127.0.0.1:8888;  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header X-Real-IP $remote_addr;  
proxy_set_header Host $http_host;  
proxy_http_version 1.1;  
proxy_redirect off;  
proxy_buffering off;  
proxy_set_header Upgrade $http_upgrade;  
proxy_set_header Connection "upgrade";  
proxy_read_timeout 86400;  
}  
}

완료되면 파일을 저장하고 종료합니다.

이제 아래 명령어를 실행하여 Nginx 구문을 확인합니다. 성공하면 ‘syntax is ok - test is successful’라는 출력이 표시됩니다.

sudo nginx -t

다음으로, 아래 명령어를 사용하여 Nginx 서비스를 시작하고 활성화합니다.

sudo systemctl start nginx  
sudo systemctl enable nginx

Nginx가 시작되면 아래 명령어로 서비스를 확인합니다. Nginx 서비스가 실행 중인지 확인합니다.

sudo systemctl status nginx

마지막으로 아래 명령어를 실행하여 시스템에서 HTTP 포트를 열고 JupyterLab 설치로의 트래픽을 허용합니다.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

이로써 JupyterLab 설치가 리버스 프록시를 통해 접근 가능해야 합니다.

JupyterLab에 로그인

웹 브라우저에서 새 탭을 열고 JupyterLab 설치의 도메인 이름(http://jupyterlab.howtoforge.local/)을 방문합니다. 설치가 성공하면 JupyterLab 로그인 페이지가 표시됩니다.

페이지 하단으로 스크롤하여 JupyterLab 토큰을 붙여넣습니다. 그런 다음, JupyterLab 설치를 위한 새 비밀번호를 입력하고 로그인 및 새 비밀번호 설정을 누릅니다.

올바른 토큰이 있으면 JupyterLab 대시보드가 표시되고 비밀번호도 변경됩니다.

결론

축하합니다! Rocky Linux 9에 JupyterLab을 성공적으로 설치했습니다. JupyterLab을 설치하고, JupyterLab 인증을 구성했으며, JupyterLab 설치를 위한 Nginx를 리버스 프록시로 구성했습니다.