ArcGIS Notebook Server (Linux コンテナー) 用のコンテナ― エンジンのインストール—ArcGIS Notebook Server

ArcGIS Notebook Server で必要な Docker コンテナー割り当てソフトウェアをダウンロード、インストール、構成する手順を次に示します。 Docker の概要と ArcGIS Notebook Server での使用方法については、「Docker と ArcGIS Notebook Server」をご参照ください。

Docker のエディション

Docker は Docker Desktop として利用できます。


オペレーティングシステム	Docker のエディション	ノートブックランタイム (コンテナー) イメージタイプ	その他の要件
Windows Server 2019 Standard および Datacenter Windows Server 2022 Standard および Datacenter	Windows バージョン 4.19.0 以降の Docker Desktop	Linux	Hyper-V は必須

注意:

Docker はサードパーティソフトウェアコンポーネントであり、このトピックでは、Docker をインストールする手順については詳しく説明していません。このインストール手順の詳細については、Docker サイトをご参照ください。

Docker Desktop のインストール

Docker Desktop をインストールするには、次の手順に従います。

Hyper-V Manager アプリケーションを検索して、Windows コンピューター上に Hyper-V がインストールされていることを確認します。インストールされていない場合は、インストールしてから次に進みます。手順については、Microsoft の次のドキュメントをご参照ください。
- OS が Windows Server 2022 または Windows Server 2019 の場合は、「Windows Server 上に Hyper-V ロールをインストールする」をご参照ください。
- OS が Windows 10 の場合は、「Windows 10 上に Hyper-V をインストールする」をご参照ください。
ArcGIS Notebook Server には、Docker Desktop for Windows (バージョン 4.19.0 以降) が必要です。
ブラウザーで、Docker Hub ストアの Docker Desktop (Windows) のダウンロードページに移動します。
既存の Docker Hub アカウントにサインインするか、新しいアカウントにサインアップします。
Docker Desktop ソフトウェアをダウンロードします。
[Docker for Windows Installer] をダブルクリックして実行します。
インストーラーの [Configuration] ダイアログボックスで、[Use WSL2 instead of Hyper-V] をオフにします。
完了したら、インストーラーを閉じます。
[スタート] メニューの [Docker Desktop] ボタンをクリックして、Docker を開始します。
次のいずれかの方法で、Docker が開始したことを確認します。
- Windows システムトレイの [Docker] アイコンのステータスを確認します (通常は画面の右下隅にあります)。
- [コマンドプロンプト] ウィンドウを開いて、次のコマンドを実行します。
```
docker version
docker run hello-world
```
  最初のコマンドは、コンピューター上の Docker のバージョンを表示します。2 番目のコマンドは、Docker がコンテナーイメージにアクセスして実行できることを確認します。

Docker の設定の構成

コンピューター上に Docker をインストールしたら、次のように設定を変更します。

一般設定の構成

Docker Remote API を使用します。これは、ポート 2375 を使用する必要があります。このポートは、ArcGIS Notebook Server によって内部でのみ使用され、外部からの使用に対しては保護する必要があります。

Windows システムトレイの [Docker] ボタンを右クリックして、[設定] をクリックします。
[General] ページで、[Expose daemon on tcp://localhost:2375 without TLS] チェックボックスをオンにします。
セキュリティに関する警告が表示されることがあります。このポートは内部で使用され、ポートへの外部アクセスは許可されていないことをシステム管理者が認識していることを確認します。
[Use the WSL2 based engine] をオフにします (オンになっている場合)。

デフォルトの Docker イメージのインストール場所の変更

デフォルトの Docker イメージのインストール場所を変更するには、次の手順を実行します。

Docker Desktop 設定を開きます。
[Resources] > [Advanced] の順にクリックします。
コンピューター上の選択したローカルディレクトリパスに Disk image location を設定します。

ファイル共有の設定

Docker コンテナーは、ワークスペースディレクトリとして構成されるローカルドライブ、またはノートブックサーバーのカスタムデータディレクトリにアクセスできる必要があります。最初のインストール中に以下の手順を実行して、[Run As] アカウントの認証情報が変更された場合や、[Run As] アカウント自体が変更された場合は、この手順を繰り返します。 ArcGIS Notebook Server のインストール中に新しいアカウントを作成する場合は、こちらの手順に戻ります。

Windows システムトレイの [Docker] ボタンを右クリックして、[設定] をクリックします。
[settings] メニューで、[Resources] > [File sharing] をクリックします。
ArcGIS Notebook Server ワークスペースまたはカスタムデータディレクトリに使用されるドライブまたはディレクトリパスを追加します。
注意:
現時点でワークスペースディレクトリもカスタムデータディレクトリも存在しない場合は (例: C:\arcgisnotebookserver)、この手順を実行する前に、ArcGIS Notebook Server サイトを作成するか、データディレクトリを登録します。
注意:
Docker for Windows は、Linux コンテナーと共有される Windows のローカルディレクトリにのみ対応しています。

詳細なリソースの構成

[Docker Desktop] settings パネルを使用すると、ArcGIS Notebook Server およびサーバーサイトで実行されるコンテナーで使用可能なリソースを制限できます。

Windows システムトレイの [Docker] ボタンを右クリックして、[設定] をクリックします。設定メニューから、[Resources] > [Advanced] をクリックします。
次の設定を変更します。
- [CPU] - コンピューターのコンテナーで使用可能な CPU コアの数。デフォルトでは、これは 2 コアに設定されます。この値は、コンピューターで使用可能なリソースとノートブックランタイムに対する CPU の制限セットに応じて更新できます。
- [Memory] - コンピューターのコンテナーで使用可能なメモリ量。デフォルトでは、これは 2 GB に設定されます。この値を、最低でも 6 GB に増やします。この値は、コンピューターで使用可能なリソースとノートブックランタイムに対するメモリの制限に応じて増やすことお勧めします。
- [Swap] - 前述の制限に到達したときに、コンテナーがメモリに対して使用できるディスク容量。
- [Disk image size] - ディスクイメージの大きさ。 Notebooks の Docker コンテナーイメージをインストールするとディスク容量不足のエラーになる場合は、この値を確認し、必要に応じて更新します。
- [Disk image location] - コンテナーおよびイメージが格納されているディレクトリ。
注意:
ノートブックランタイム用に構成された CPU やメモリを変更したときはいつでも、この手順を再実行できます。
設定したリソース制限に問題なければ、[Apply] をクリックします。

Docker コンポーネントがインストールされたら、コンピューターを再起動します。 Docker コンポーネントをインストールまたはアップグレードするたびに、コンピューターを再起動する必要があります。

これで、コンピューター上に ArcGIS Notebook Server をインストールする準備ができました。

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