Debian9でPython3を使用してJupyterNotebookをセットアップする方法
序章
Jupyter Notebook は、Webアプリケーションとしてインタラクティブコンピューティング用のコマンドシェルを提供します。 このツールは、Python、Julia、R、Haskell、Rubyなどのいくつかの言語で使用できます。 多くの場合、データの操作、統計モデリング、機械学習に使用されます。
このチュートリアルでは、Debian9サーバーから実行するようにJupyterNotebookを設定する方法と、ノートブックに接続して使用する方法について説明します。 Jupyterノートブック(または単にノートブック)は、Jupyter Notebookアプリによって作成されたドキュメントであり、コンピューターコードと、再現可能な調査の提示と共有に役立つリッチテキスト要素(段落、方程式、図、リンクなど)の両方が含まれています。
このガイドの終わりまでに、リモートサーバーで実行されているJupyterNotebookを使用してPython3コードを実行できるようになります。
前提条件
このガイドを完了するには、基本的なファイアウォールを備えた新しいDebian 9サーバーインスタンスと、sudo権限が設定された非rootユーザーが必要です。 Debian 9 を使用した初期サーバー設定ガイドを実行することで、これを設定する方法を学ぶことができます。
ステップ1—PipおよびPythonヘッダーをインストールする
プロセスを開始するには、Debianリポジトリから必要なすべてのアイテムをダウンロードしてインストールします。 Pythonパッケージマネージャーを使用します pip
少し後で追加のコンポーネントをインストールします。
最初にローカルを更新する必要があります apt
パッケージインデックスを作成し、パッケージをダウンロードしてインストールします。
- sudo apt update
次に、インストールします pip
およびPythonヘッダーファイル。Jupyterの依存関係の一部で使用されます。
- sudo apt install python3-pip python3-dev
Debian 9(「Stretch」)にはPython3.5がプリインストールされています。
これで、JupyterをインストールするPython仮想環境のセットアップに進むことができます。
ステップ2—Jupyter用のPython仮想環境を作成する
これで、Python 3、そのヘッダーファイル、および pip
準備ができたら、Python仮想環境を作成して管理を容易にすることができます。 この仮想環境にJupyterをインストールします。
これを行うには、最初ににアクセスする必要があります virtualenv
指図。 これをインストールできます pip
.
アップグレード pip
次のように入力してパッケージをインストールします。
- sudo -H pip3 install --upgrade pip
- sudo -H pip3 install virtualenv
と virtualenv
インストールすると、環境の形成を開始できます。 プロジェクトファイルを保持できるディレクトリを作成して移動します。
- mkdir ~/myprojectdir
- cd ~/myprojectdir
プロジェクトディレクトリ内で、次のように入力してPython仮想環境を作成します。
- virtualenv myprojectenv
これにより、というディレクトリが作成されます myprojectenv
あなたの中で myprojectdir
ディレクトリ。 内部には、Pythonのローカルバージョンとのローカルバージョンがインストールされます pip
. これを使用して、Jupyter用の分離されたPython環境をインストールおよび構成できます。
Jupyterをインストールする前に、仮想環境をアクティブ化する必要があります。 次のように入力すると、次のように入力できます。
- source myprojectenv/bin/activate
プロンプトが変化して、Python仮想環境内で操作していることを示します。 次のようになります。 (myprojectenv)user@host:~/myprojectdir$
.
これで、Jupyterをこの仮想環境にインストールする準備が整いました。
ステップ3—Jupyterをインストールします
仮想環境をアクティブにして、ローカルインスタンスのJupyterをインストールします。 pip
:
注:仮想環境がアクティブ化されたとき(プロンプトが (myprojectenv)
その前に)、使用する pip
それ以外の pip3
、Python3を使用している場合でも。 ツールの仮想環境のコピーには常に名前が付けられます pip
、Pythonのバージョンに関係なく。
- pip install jupyter
この時点で、Jupyterの実行に必要なすべてのソフトウェアが正常にインストールされています。 これで、ノートブックサーバーを起動できます。
ステップ4—JupyterNotebookを実行する
これで、JupyterNotebookを実行するために必要なものがすべて揃いました。 実行するには、次のコマンドを実行します。
- jupyter notebook
JupyterNotebookのアクティビティのログが端末に印刷されます。 Jupyter Notebookを実行すると、特定のポート番号で実行されます。 最初に実行するノートブックは通常、ポートを使用します 8888
. Jupyter Notebookが実行されている特定のポート番号を確認するには、JupyterNotebookを起動するために使用したコマンドの出力を参照してください。
Output[I 21:23:21.198 NotebookApp] Writing notebook server cookie secret to /run/user/1001/jupyter/notebook_cookie_secret
[I 21:23:21.361 NotebookApp] Serving notebooks from local directory: /home/sammy/myprojectdir
[I 21:23:21.361 NotebookApp] The Jupyter Notebook is running at:
[I 21:23:21.361 NotebookApp] http://localhost:8888/?token=1fefa6ab49a498a3f37c959404f7baf16b9a2eda3eaa6d72
[I 21:23:21.361 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[W 21:23:21.361 NotebookApp] No web browser found: could not locate runnable browser.
[C 21:23:21.361 NotebookApp]
Copy/paste this URL into your browser when you connect for the first time,
to login with a token:
http://localhost:8888/?token=1fefa6ab49a498a3f37c959404f7baf16b9a2eda3eaa6d72
(ドロップレットではなく)ローカルのDebianコンピューターでJupyter Notebookを実行している場合は、表示されたURLに移動するだけで、JupyterNotebookに接続できます。 ドロップレットでJupyterNotebookを実行している場合は、次のセクションで概説するように、SSHトンネリングを使用してサーバーに接続する必要があります。
この時点で、SSH接続を開いたままにしてJupyter Notebookを実行し続けるか、SSHトンネリングを設定したらアプリを終了して再実行することができます。 シンプルに保ち、JupyterNotebookプロセスを停止しましょう。 SSHトンネリングが機能するようになったら、再度実行します。 Jupyter Notebookプロセスを停止するには、を押します CTRL+C
、 タイプ Y
、ヒット ENTER
確認するために。 以下が表示されます。
Output[C 21:28:28.512 NotebookApp] Shutdown confirmed
[I 21:28:28.512 NotebookApp] Shutting down 0 kernels
次に、ノートブックにアクセスできるようにSSHトンネルを設定します。
ステップ5—SSHトンネリングを使用してサーバーに接続する
このセクションでは、SSHトンネリングを使用してJupyterNotebookWebインターフェースに接続する方法を学習します。 Jupyter Notebookはサーバー上の特定のポート( :8888
, :8889
など)、SSHトンネリングを使用すると、サーバーのポートに安全に接続できます。
次の2つのサブセクションでは、1)MacまたはLinuxおよび2)WindowsからSSHトンネルを作成する方法について説明します。 ローカルコンピュータのサブセクションを参照してください。
MacまたはLinuxでのSSHトンネリング
MacまたはLinuxを使用している場合、SSHトンネルを作成する手順は、SSHを使用してリモートサーバーにログインする手順と似ていますが、 ssh
指図。 このサブセクションでは、 ssh
正常にトンネリングするコマンド。
SSHトンネリングは、新しいローカルターミナルウィンドウで次のSSHコマンドを実行することで実行できます。
- ssh -L 8888:localhost:8888 your_server_username@your_server_ip
The ssh
コマンドはSSH接続を開きますが、 -L
ローカル(クライアント)ホストの指定されたポートが、リモート側(サーバー)の指定されたホストおよびポートに転送されることを指定します。 これは、2番目のポート番号で実行されているものはすべて(例: 8888
)サーバー上で最初のポート番号に表示されます(例: 8888
)ローカルコンピュータ上。
オプションでポートを変更します 8888
別のプロセスですでに使用されているポートの使用を避けるために選択したものの1つに。
server_username
あなたのユーザー名です(例: 作成したサーバー上のsammy)と your_server_ip
サーバーのIPアドレスです。
たとえば、ユーザー名の場合 sammy
およびサーバーアドレス 203.0.113.0
、コマンドは次のようになります。
- ssh -L 8888:localhost:8888 sammy@203.0.113.0
実行後にエラーが表示されない場合 ssh -L
コマンドを使用すると、プログラミング環境に移動してJupyterNotebookを実行できます。
- jupyter notebook
URL付きの出力を受け取ります。 ローカルマシンのWebブラウザから、JupyterNotebookWebインターフェイスを次のURLで開きます。 http://localhost:8888
. トークン番号が含まれていることを確認するか、プロンプトが表示されたらトークン番号の文字列を入力します http://localhost:8888
.
WindowsとPuttyを使用したSSHトンネリング
Windowsを使用している場合は、Puttyを使用してSSHトンネルを作成できます。
まず、次のように、ホスト名としてサーバーのURLまたはIPアドレスを入力します。
次に、左ペインの下部にある SSH をクリックしてメニューを展開し、トンネルをクリックします。 ローカルマシンでJupyterにアクセスするために使用するローカルポート番号を入力します。 選ぶ 8000
他のサービスによって使用されるポートを回避し、宛先を次のように設定するには、またはそれ以上 localhost:8888
どこ :8888
JupyterNotebookが実行されているポートの番号です。
次に、追加ボタンをクリックすると、ポートが転送ポートリストに表示されます。
最後に、 Open ボタンをクリックして、SSH経由でサーバーに接続し、目的のポートをトンネリングします。 案内する http://localhost:8000
サーバー上で実行されているJupyterNotebookに接続するためのWebブラウザー(または選択したポート)。 トークン番号が含まれていることを確認するか、プロンプトが表示されたらトークン番号の文字列を入力します http://localhost:8000
.
ステップ6—JupyterNotebookを使用する
このセクションでは、JupyterNotebookの使用の基本について説明します。 現在JupyterNotebookを実行していない場合は、 jupyter notebook
指図。
これで、Webブラウザを使用して接続する必要があります。 Jupyter Notebookは非常に強力で、多くの機能を備えています。 このセクションでは、ノートブックの使用を開始するための基本的な機能のいくつかについて概説します。 Jupyter Notebookは、実行元のディレクトリ内のすべてのファイルとフォルダーを表示するため、プロジェクトで作業しているときは、必ずプロジェクトディレクトリから開始してください。
新しいノートブックファイルを作成するには、右上のプルダウンメニューから New > Python3を選択します。
これにより、ノートブックが開きます。 これで、セルでPythonコードを実行したり、セルをマークダウンに変更したりできます。 たとえば、上部のナビゲーションバーからセル>セルタイプ>マークダウンをクリックして、最初のセルを変更してマークダウンを受け入れます。 Markdownを使用してメモを記述できるようになりました。また、 LaTeX で記述された方程式を、 $$
シンボル。 たとえば、セルをマークダウンに変更した後、セルに次のように入力します。
# Simple Equation
Let us now implement the following equation:
$$ y = x^2$$
where $x = 2$
マークダウンをリッチテキストに変換するには、を押します CTRL+ENTER
、および次の結果が得られるはずです。
マークダウンセルを使用して、メモを作成し、コードを文書化できます。 その簡単な方程式を実装して、結果を出力してみましょう。 一番上のセルをクリックして、を押します ALT+ENTER
その下にセルを追加します。 新しいセルに次のコードを入力します。
x = 2
y = x**2
print(y)
コードを実行するには、を押します CTRL+ENTER
. 次の結果が表示されます。
これで、モジュールをインポートして、他のPython開発環境と同じようにノートブックを使用できるようになりました。
結論
おめでとう! これで、Jupyter Notebookを使用して、再現可能なPythonコードとメモをMarkdownで記述できるようになります。 インターフェイス内からJupyterNotebookのクイックツアーを取得するには、上部のナビゲーションメニューからヘルプ>ユーザーインターフェイスツアーを選択して詳細を確認してください。
ここから、時系列の視覚化と予測に関するシリーズを読むことに興味があるかもしれません。