ワークスペースでコンピューティングインスタンスのターミナルにアクセスする

[アーティクル]
01/14/2024

自分のワークスペースでコンピューティングインスタンスのターミナルにアクセスして、次の操作を行います。

Git のファイルを使用してファイルのバージョン管理を行う。これらのファイルは、1 つのコンピューティングインスタンスに限定されるのではなく、自分のワークスペースファイルシステムに格納されます。
コンピューティングインスタンスにパッケージをインストールする。
コンピューティングインスタンスに追加のカーネルを作成する。

前提条件

Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Machine Learning ワークスペース。「ワークスペースリソースの作成」を参照してください。

ターミナルにアクセスする

ターミナルにアクセスするには:

Azure Machine Learning Studio で、ワークスペースを開きます。
左側にある [Notebooks](ノートブック) を選択します。
[Open terminal](ターミナルを開く) イメージを選択します。
コンピューティングインスタンスが実行されている場合、そのコンピューティングインスタンス用のターミナルウィンドウが表示されます。
コンピューティングインスタンスが実行されていない場合は、右側の [コンピューティング] セクションを使用して、コンピューティングインスタンスを開始または作成します。

上記の手順に加えて、次のようにしてターミナルにアクセスすることもできます。

RStudio または Posit Workbench (旧称 RStudio Workbench) (RStudio や Posit Workbench などのカスタムアプリケーションの追加に関する記事を参照): 左上にある [ターミナル] タブを選択します。
Jupyter ラボ: [Launcher] タブの見出し [Other] の下にある [Terminal] タイルを選択します。
Jupyter: [Files] タブの右上にある [New] > [Terminal] を選択します。
コンピューティングインスタンスの作成時に SSH アクセスを有効にした場合は、マシンに SSH 接続します。

ターミナルでのコピーと貼り付け

Windows: コピーの場合は Ctrl-Insert、貼り付けの場合は Ctrl-Shift-v または Shift-Insert を使用します。

Mac OS: コピーの場合は Cmd-c、貼り付けの場合は Cmd-v を使用します。

Firefox や IE ではクリップボードのアクセス許可が正しくサポートされない場合があります。

Git のファイルを使用してファイルのバージョン管理を行う

ターミナルからすべての Git 操作にアクセスします。すべての Git ファイルとフォルダーは、ワークスペースファイルシステムに格納されます。このストレージでは、自分のワークスペース内の任意のコンピューティングインスタンスからこれらのファイルを使用できます。

注意

すべての Jupyter 環境で表示されるように、 ~/cloudfiles/code/Users フォルダー以下の任意の場所にファイルとフォルダーを追加します。

Git を Azure Machine Learning ワークスペースと統合するには、「Azure Machine Learning との Git 統合」を参照してください。

パッケージをインストールする

ターミナルウィンドウからパッケージをインストールします。ノートブックの実行に使用するカーネルにパッケージをインストールします。既定のカーネルは python310-sdkv2 です。

または、Jupyter Notebook、RStudio、または Posit Workbench (旧称 RStudio Workbench) にパッケージを直接インストールすることもできます。

RStudio または Posit Workbench (RStudio や Posit Workbench などのカスタムアプリケーションの追加に関する記事を参照): 右下の [パッケージ] タブまたは左上の [コンソール] タブを使用します。
Python: インストールコードを追加して、Jupyter Notebook のセルで実行します。

Note

Python ノートブック内のパッケージ管理については、すべてのパッケージ (現在実行されているカーネルの外部のパッケージを含む) を参照する !pip または !conda ではなく、%pip または %conda マジック関数を使用して、現在実行中のカーネルにパッケージを自動的にインストールします

新しいカーネルを追加する

警告

コンピューティングインスタンスをカスタマイズしている間は、作成しなかった Conda 環境または Jupyter カーネルを削除しないでください。削除すると、Jupyter/JupyterLab 機能が破損します。

新しい Jupyter カーネルをコンピューティングインスタンスに追加するには、次のようにします。

ターミナルウィンドウを使用して、新しい環境を作成します。たとえば、次のコードでは newenv が作成されます。
```
conda create --name newenv
```
環境をアクティブにします。 newenv を作成した後の例を次に示します。
```
conda activate newenv
```
pip と ipykernel パッケージを新しい環境にインストールし、その conda 環境用のカーネルを作成します
```
conda install pip
conda install ipykernel
python -m ipykernel install --user --name newenv --display-name "Python (newenv)"
```

任意の使用可能な Jupyter カーネルをインストールできます。

新しい R カーネルをコンピューティングインスタンスに追加するには:

ターミナルウィンドウを使用して、新しい環境を作成します。たとえば、次のコードでは r_env が作成されます。
```
conda create -n r_env r-essentials r-base
```
環境をアクティブにします。 r_env を作成した後の例を次に示します。
```
conda activate r_env
```
新しい環境で R を実行します。
```
R
```

R プロンプトで IRkernel を実行します。

IRkernel::installspec(name = 'irenv', displayname = 'New R Env')

R セッションを終了します。
```
q()
```

新しい R カーネルが使用できるようになるまでに数分かかります。無効であるというエラーが表示された場合は、しばらくしてからやり直してください。

conda の詳細については、「Using R language with Anaconda」(Anaconda での R 言語の使用) を参照してください。 IRkernel の詳細については、「Native R kernel for Jupyter」(Jupyter のネイティブ R カーネル) を参照してください。

追加されたカーネルを削除する

警告

コンピューティングインスタンスをカスタマイズしている間は、作成しなかった Conda 環境または Jupyter カーネルを削除しないでください。

追加された Jupyter カーネルをコンピューティングインスタンスから削除するには、kernelspec と (必要に応じて) conda 環境を削除する必要があります。また、conda 環境を保持することも選択できます。 kernelspec は削除する必要があります。さもないと、カーネルが引き続き選択可能になり、予期しない動作が発生します。

kernelspec を削除するには:

ターミナルウィンドウを使用して、kernelspec を一覧表示して見つけます。
```
jupyter kernelspec list
```
kernelspec を削除し、UNWANTED_KERNEL を削除するカーネルに置き換えます。
```
jupyter kernelspec uninstall UNWANTED_KERNEL
```

conda 環境も削除するには:

ターミナルウィンドウを使用して、conda 環境を一覧表示して見つけます。
```
conda env list
```
conda 環境を削除し、ENV_NAME を削除する conda 環境に置き換えます。
```
conda env remove -n ENV_NAME
```

更新すると、行った変更がノートブックのビューにあるカーネルの一覧に反映されます。

ターミナルセッションを管理する

ターミナルタブが適切に閉じられていない場合、ターミナルセッションはアクティブなままになる可能性があります。アクティブなターミナルセッションが多すぎると、コンピューティングインスタンスのパフォーマンスに影響する可能性があります。

ターミナルツールバーの [アクティブなセッションの管理] を選択すると、すべてのアクティブなターミナルセッションの一覧が表示され、不要になったセッションがシャットダウンされます。

コンピューティングで実行されているセッションを管理する方法の詳細については、「ノートブックとターミナルセッションの管理」を参照してください。

警告

コンピューティングインスタンスのリソースを保持し、パフォーマンスを最適化するために、不要になったセッションを必ず閉じてください。

ワークスペースでコンピューティング インスタンスのターミナルにアクセスする