Rocky Linux 9にJupyterLabをインストールする方法

Jupyterは、インタラクティブコンピューティングとデータサイエンスのための無料でオープンソースのWebアプリケーションです。

Jupyterはすべてのプログラミング言語をサポートし、JupyterLabのような複数のソフトウェアを提供します。JupyterLabは、機能豊富でタブ付きのマルチノートブック編集環境を提供し、Notebookは軽量で簡素化されたノートブック作成を提供します。Qtconsoleなどもあります。

このガイドでは、Rocky Linux 9サーバーにJupyterLabをインストールする手順をステップバイステップで説明します。JupyterLabをインストールし、JupyterLabの認証を有効にし、Nginxをリバースプロキシとして設定します。

前提条件

このガイドを完了するには、以下のものを用意してください：

• Rocky Linux 9サーバー。
• sudo権限を持つ非rootユーザー。
• 状態が許可の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を設定しました。