ノートブックランタイムの拡張—ArcGIS Notebook Server

ArcGIS Notebook Server は 2 つのノートブックランタイム (Python モジュールのコレクション) を備えています。これらのランタイムは、コンテナーイメージを通じてノートブックユーザーに提供され、サーバーサイトで実行される各コンテナーに適用されます。

Standard および Advanced のノートブックランタイムには、どちらも ArcGIS API for Python および各種 Python モジュールが含まれており、データサイエンス、空間解析、コンテンツ管理に使用できます。 Advanced ランタイムには ArcPy も含まれます。

使用可能な Python ライブラリのリストをご参照ください。

これら 2 つのランタイムに含まれていないモジュールや、特定のバージョンのモジュールが必要となる場合もあります。 ArcGIS Notebook Server では、次の方法でその他の Python モジュールにアクセスできます。

ノートブックセッションで Python モジュールをインストールします。これにより、そのノートブックでモジュールを使用できるようになります。
Esri コンテナーイメージを拡張し、カスタムランタイムに Python ライブラリを追加で含めます。作成したコンテナーイメージにより、拡張したランタイムをサイト内のすべてのノートブック作成者が使用できるようになります。

セッション中のモジュールのインストール

ノートブック作成者は、conda または pip パッケージ管理システムを使用することで、ノートブックセッション中に使用可能なランタイムのどちらにも含まれていない Python モジュールまたはモジュールのバージョンを作成できます。 ArcGIS Notebook Server ではモジュールの管理に conda が使用されるため、conda の使用をお勧めします。ただし、pip でしか使用できない Python モジュールもあります。

この方法では、ノートブックセッションの間に目的のモジュールをインストールします。ノートブックが閉じられるか、ユーザーに属するコンテナーが終了されると、そのモジュールは使用できなくなります。この方法でモジュールをインストールするには、conda または pip チャンネルへのインターネット接続が必要です。

注意:

conda および pip はどちらも 2 つのノートブックランタイムに含まれています。そのため、インストールする必要はありません。

たとえば、セッション中に scrapy パッケージをインストールするには、使用しているパッケージ管理システムに応じて、次のどちらかのコマンドでノートブックセルを実行します。

conda パッケージ管理システムの使用

!conda install --yes scrapy

pip パッケージ管理システムの使用

!pip install scrapy

作業を行っているノートブックランタイムでバージョンの異なる Python モジュールを使用するには、バージョン番号をコマンドで指定します。

新しいパッケージを使用できるようにするには、conda または pip コマンドの実行後にカーネルを再起動する必要があります。

たとえば、バージョン 1.5 の特定のパッケージが 2 つのノートブックランタイムで使用できる場合に、バージョン 1.6 で導入されたツールを使用する必要があるとします。ノートブックセッションでバージョン 1.6 のパッケージを使用できるようにするには、使用しているパッケージ管理システムに応じて、次のいずれかのコマンドでノートブックセルを実行します。

conda パッケージ管理システムの使用

!conda install --yes <package name>==1.6

pip パッケージ管理システムの使用

!pip install <package name>==1.6

カスタムコンテナーイメージの構築

ノートブックランタイムに永続的な変更を加えるには、サイトにカスタムコンテナーイメージを構築します。管理権限を必要とする次のワークフローにより、カスタムイメージが作成され、それを使用できるよう ArcGIS Notebook Server を構成します。

2 つのノートブックランタイム (Standard か Advanced) のどちらかを開始点として使用します。カスタムランタイムの構築が完了したら、サイト内の新しいランタイムとして登録できます。

ArcGIS Notebook Server をインストールして構成します。
管理者として ArcGIS Notebook Server Administrator Directory にサインインします。
URL の形式は、https://notebookserver.domain.com:11443/arcgis/admin/ です。
[notebooks] > [runtimes] の順にクリックし、カスタムイメージ用に拡張するノートブックランタイムを選択します。
ランタイムのリソースページで、このランタイムの imageId 値をメモします。この値は次のステップに含めます。

目的の Python モジュールをカスタムイメージに追加する Dockerfile を作成します。

Dockerfile は、Docker コンテナーイメージを構築する指示をまとめたシンプルなテキストファイルです。ベストプラクティスの情報については、Dockerfile のドキュメントをご参照ください。

この例では、Advanced ノートブックランタイムに、データ視覚化の Python パッケージ graphviz を追加します。 Dockerfile の次のコードブロックは、imageId 値を使用して Advanced ランタイムにアクセスし、ランタイム内に graphviz をインストールするよう Docker に指示します。 conda clean コマンドは、ファイルサイズを削減する際のお勧めの方法です。

# Specify the existing notebook runtime imageId as FROM
FROM aa7a1a346e5b

# Use RUN to issue a command to install, then clean
RUN conda install graphviz \
  && conda clean -y -a

この例では、Oracle クライアントライブラリを含むカスタムランタイムを作成します。

## Using a Dockerfile to build a custom notebook runtime that includes Oracle client
FROM <replace with imageId of standard or advanced container image>

## Switch to root user for installing OS level packages. 
USER root

## Combine OS level statements for Docker image efficiency
RUN apt-get update && \
        apt-get install -y alien
## Update the url below to the desired version of Oracle client.
RUN wget https://yum.oracle.com/repo/OracleLinux/OL8/oracle/instantclient/x86_64/getPackage/oracle-instantclient19.10-basic-19.10.0.0.0-1.x86_64.rpm
RUN alien -i oracle-instantclient19.10-basic-19.10.0.0.0-1.x86_64.rpm

## Installing libaio1 is required only for Notebook runtimes version 5 (10.9) or earlier.  
RUN apt-get install -y libaio1

## Switch back to arcgis user at end of the Dockerfile
USER arcgis

Dockerfile を、コンピューター上の、Dockerfile のみを格納する新しいフォルダー内に保存します。
Docker コマンドを使用し、新しいカスタムコンテナーイメージを構築します。
このイメージには、Dockerfile で指定された新しいランタイムが含まれます。ターミナルを開き、次の構文でコマンドを実行します:
```
docker build -t <name of my new runtime>:v1.0 -f <path to my Dockerfile> .
```
注意:
コマンド末尾には必ずピリオドを含めてください。
コマンドが実行されると、Docker が新しいコンテナーイメージを構築します。コマンド出力の最終行は Successfully built <imageId> になり、新しいイメージの省略形の ID 値が含まれます。 ArcGIS Notebook Server サイトには、完全な imageId 値を指定する必要があります。
ターミナルで次のコマンドを実行し、イメージの ID 値を取得します。
```
docker inspect <imageId>
```

これでカスタムイメージが構築され、完全な imageId 値を取得しました。次のセクションでは、この値を使用してカスタムイメージを ArcGIS Notebook Server サイトに登録します。

ArcGIS Server Manager への新しいランタイムの登録

10.8 以降、ArcGIS Notebook Server Manager を使用して、作成したカスタムランタイムを登録することができます。

管理者として ArcGIS Enterprise ポータルにサインインし、ArcGIS Notebook Server Manager を開きます。
[設定] ページを開き、[ランタイム] をクリックします。
[ランタイムの登録] をクリックして登録ダイアログボックスを開きます。

適切な値を指定して登録を完了します。


パラメーター	詳細
name (必須)	新しいランタイムを表す文字列 (たとえば、「Notebook Custom Runtime Python 3」)。
version (必須)	ベースの Docker イメージとして使用した、Esri 提供のランタイムのバージョン。レガシー: このパラメーターは、ArcGIS Notebook Server バージョン 10.9 で非推奨になりました。
imageId (必須)	新しい Docker イメージを構築したときに与えられる、そのイメージの完全な (短縮されていない) ID。
containerType (オプション)	有効な値は「Docker」のみです。
imagePullString (オプション)	該当なし
requiresAdvancedPrivileges (必須)	ランタイムが高度な権限を必要とする場合は、この値を true に設定します。値: true \| false
maxCPU (必須)	各コンテナーに使用される CPU ユニットの最大数。
maxMemory (必須)	各コンテナーに使用されるメモリの最大量。
maxMemoryUnit (必須)	[最大メモリ] パラメーターで指定された単位。
maxSwapMemory (オプション)	各コンテナーが [最大メモリ] 制限に達した場合に、各コンテナーに使用できるスワップメモリの最大量。
maxSwapMemoryUnit (オプション)	[最大スワップメモリ] パラメーターで指定された単位。
sharedMemory (オプション)	各コンテナーに使用できる共有メモリの量。
sharedMemoryUnit (オプション)	[共有メモリ] パラメーターで指定された単位。
dockerRuntime (オプション)	Linux 環境の GPU ランタイムに対してのみ適用されます。詳細
manifestFile (オプション)	このランタイムに付属する Python ライブラリのリストを含む、JSON 形式のファイルをアップロードします。
f (オプション)	デフォルトの応答形式。デフォルトの応答形式は、html です。値: html \| json \| pjson

注意:

manifest.json ファイルを作成するには、カスタムノートブックランタイムイメージがインストールされている ArcGIS Notebook Server コンピューターでターミナルを開き、次のコマンドを実行します。

ID=$(docker container run -d --rm -it -v /:/host <custom_runtime_image_ID> /bin/bash) && docker exec -it $ID /opt/conda/bin/conda list --json >> ~/manifest.json && docker kill $ID

準備ができたら、[保存] をクリックして新しいランタイムを登録します。
新しいノートブックを開いて、この更新内容をテストします。カスタムイメージに追加したモジュールやモジュールのバージョンが、ノートブックで使用できることを確認します。

ArcGIS Notebook Server サイトのランタイムを元の設定に戻すには、Administrator Directory の [Restore Factory Runtimes] 操作を実行します。この操作は https://notebookserver.domain.com:11443/arcgis/admin/notebooks/runtimes/restore から実行でき、サイトの現在のバージョンにおける初期状態のランタイムの復元のみが行われます。

このトピックへのフィードバック

セッション中のモジュールのインストール

注意:

カスタム コンテナー イメージの構築

注意:

ArcGIS Server Manager への新しいランタイムの登録

レガシー:

注意:

このトピックの内容

カスタムコンテナーイメージの構築