コンテナー エンジンおよび ArcGIS Notebook Server
Docker コンテナー割り当てソフトウェアは ArcGIS Notebook Server で使用されます。
Docker ソフトウェア
ArcGIS Notebook Server では Docker コンテナー割り当てソフトウェアを使ってセキュリティーを提供し、ノートブック作成者のリソースを隔離します。 仮想マシンとは異なり、コンテナーは仮想化されたオペレーティング システムです。コンピューターの各コンテナーには隔離環境にすべての OS コンポーネントがあります。 ArcGIS Notebook Server はサイトの各ユーザーにコンテナーを個別に提供します。 各ユーザーはランタイムごとにコンテナーを 1 つ所有し、ユーザーは自分のコンテナーでだけノートブックを実行できます。
ArcGIS Notebook Server を使う前に、各 ArcGIS Notebook Server コンピューターに独立したサードパーティー ソフトウェア コンポーネントである Docker をインストールする必要があります。
Docker コンテナー イメージ
インストール前に My Esri からソフトウェア ダウンロードと認証ファイルを取得したら、ArcGIS Notebooks 専用の 2 つの Docker コンテナー イメージも提供されます。 これらのコンテナー イメージによって、ノートブック ユーザーに必要なランタイム (Python モジュールの特定のコレクション) が提供されます。
Esri では Standard と Advanced の 2 つの Docker コンテナー イメージを提供しています。 これら 2 つのコンテナー イメージにはシステム ツールとライブラリーだけでなく、コンテナーを適切に構成するためのさまざまな設定が含まれています。 また、ノートブック ランタイムも含まれています。Standard コンテナー イメージには Standard ノートブック ランタイムがあり、Advanced コンテナー イメージには Advanced ランタイムがあります。
Standard ランタイムでは、ArcGIS Notebooks で ArcGIS API for Python のコードとサードパーティー モジュールを使うことができます。 Advanced ランタイムには Standard イメージのすべてのモジュールと、ArcPy および関連ライブラリーがあります。
Advanced ライセンスがある場合は、My Esri から両方のコンテナー イメージをダウンロードしてインストールしてください。 Standard イメージと Advanced イメージに含まれる Python モジュールは 利用可能な Python ライブラリー に一覧されています。
Advanced ランタイムを使ってノートブックを使用するには、Advanced Notebooks 権限を含む役割をポータルでユーザーに割り当てる必要があります。 ユーザーが初めてノートブックを開くと、Advanced コンテナー イメージが適用されたコンテナーが起動します。
Advanced Notebooks 権限を持つノートブック作成者は、Standard ランタイムを使用するノートブックを指定 することもできます。 これにより、ユーザーは自分が作成したノートブックを Standard ランタイムにしかアクセスできないユーザーと共有することができます。 ユーザーが初めてこの操作を行うと、2 番目のコンテナーが起動して Standard コンテナー イメージが読み込まれます。
デフォルトでは、コンテナーには一定量の RAM と、一定数の CPU コア共有が割り当てられます。 これらのデフォルト リソースの制限は、次に示すように、コンテナーによって実行されるランタイムで決定されます。
Standard ランタイムは、コンテナーあたり 1 CPU コアと 4 GB の RAM を割り当てます。
Advanced ランタイムは、コンテナーあたり 2 CPU コアと 6 GB の RAM を割り当てます。
ArcGIS Notebook Server 管理者は、サイトで作業を行っているノートブック作成者の数と、各作成者が使用しているランタイムを監視する必要があります。 これらの条件によっては、ArcGIS Notebook Server に対して設定したリソースの制約を変更する 必要があるか、変更を検討します。
Docker のエディション
Docker には 2 つのエディションがあります。 Docker および Mirantis Container Runtime (旧称: Docker Engine-Enterprise)。 いずれのエディションも機能的に完成されているとされています。
注意:
Docker のバージョンと価格の詳細については、Docker FAQ をご参照ください。
各 ArcGIS Notebook Server コンピューターに Docker または Mirantis Container Runtime をインストールしておく必要があります。 Docker のインストールと構成の詳細は、ArcGIS Notebook Server への Docker のインストール をご参照ください。
注意:
ArcGIS Notebook Server は、コンピューター上にインストールされたいずれかのエディションの Docker でのみ機能します。 複数コンピューターのサイトでエディションを混在させることはできません。
ノートブック ランタイムとコンテナー イメージ
コンテナーは通常、初回起動時には空の状態です。 コンテナーが正常に動作するのに必要なシステム ライブラリー、ツール、および構成は、コンテナー イメージ ファイルから提供されます。 コンテナー イメージは、起動プロセスの一部としてコンテナーに適用されます。
ヒント:
クラウド ソフトウェアを配置したことがあれば、空の仮想コンピューターと動作させるのに必要なコード、ツール、および設定を提供するコンピューター イメージに慣れているでしょう。 コンテナー イメージは、コンテナーの空の仮想 OS のように動作します。
Esri では、ArcGIS Notebook Server 向けに 2 種類のコンテナー イメージを用意しています。 それぞれのコンテナー イメージには、Python リソースを ArcGIS Notebooks で利用できるようにするノートブック ランタイムが含まれています。 ランタイムごとに、これらのライブラリーと従属ライブラリーのリスト (各 Python ライブラリーの特定バージョンを含む) がパッケージ化されています。
ArcGIS Notebook Server には、[Standard] (ArcGIS API for Python と他の Python モジュールを含む) および [Advanced] (上記に加えて ArcPy も含む) という 2 つのランタイムがあり、対応するコンテナー イメージの一部としてノートブックで利用できます。
ライセンスに応じて、Standard のコンテナー イメージか、Standard コンテナー イメージと Advanced コンテナー イメージの両方を受け取ることができます。
コンテナーを起動すると、Esri から受け取った 2 つのコンテナー イメージのうちの 1 つがコンテナーに適用されます。 適用されるランタイムとイメージは、次のようにポータル内のノートブック作成者の権限によって異なります。
作成者にノートブックの作成と編集権限を付与されている場合、その作成者のコンテナーは Standard コンテナー イメージに読み込まれます。 これらの作成者が開くすべてのノートブックでは Standard ランタイムが使用されます。
[高度なノートブック] 権限も付与されている作成者のコンテナーには Advanced コンテナー イメージが読み込まれます。 これらの作成者のノートブックのデフォルト ノートブック ランタイムは Advanced ランタイムです。 ただし、これらの作成者には 個々のノートブックのランタイムを指定する オプションも用意されているので、ノートブックで Standard ランタイムまたは Advanced ランタイムをどちらも使用できます。
ArcGIS Notebook Server は、Windows のコンテナー エンジン オプションとして、バイナリーから Mirantis Container Runtime または Docker Engine を使用する Windows コンテナーと互換性があります。
Windows 向けのコンテナー エンジン
他の ArcGIS Notebook Server のデプロイと同様に、ArcGIS Notebook Server と Windows コンテナーは、サーバーのオペレーティング システムにインストールされ、構成されてから ArcGIS Enterprise ポータルとフェデレートされます。 加えて、Web Adaptor を ArcGIS Notebook Server ソフトウェアの前に配置できます。
ArcGIS Notebook Server では、ノートブック作成者の環境を分離するために、コンテナーと呼ばれる仮想化オペレーティング システムが使用されます。 その結果、コンテナーを使用することで、各作成者はサーバー リソースのサブセットを使用できるようになり、自分の作業やリソース使用状況が他のユーザーに干渉することがなくなります。
これらのコンテナーは、サードパーティー製のコンテナー エンジン (バイナリーからの Mirantis Container Runtime または Docker Engine のいずれか) によって割り当てられて管理されます。 ArcGIS Notebook Server をインストールする前に、コンテナー エンジンをインストールする必要があります。 ArcGIS Notebook Server は、インストール後にそのコンテナー エンジンで機能するように構成する必要があります。
ArcGIS Notebook Server は、サイトのそれぞれのノートブック作成者にランタイムあたり 1 つのコンテナーを割り当て、作成者はそのコンテナー内でのみ作業できます。 ノートブックの実行時に使用する計算リソースが他の作成者のコンテナーに影響することはありません。
対応する権限を持つポータル メンバーが最初のノートブックを開くと、コンテナーが ArcGIS Notebook Server サイト上で起動します。 ノートブックとコンテナー間のこのセッションは、ノートブックの実行時間を通して継続します。
ArcGIS Notebook Server は、複数のコンピューターを 1 つのサイトに結合することができます。 複数コンピューター構成のコンピューターは同一になるように構成する必要があり、コンピューターごとに ArcGIS Notebooks を実行できます。
ノートブック ランタイムと Windows コンテナー イメージ
ArcGIS Notebook Server 向けに単一の Windows コンテナー イメージが提供されています。 このコンテナー イメージには、Python リソースを ArcGIS Notebooks で使用可能にする Standard および Advanced ノートブック ランタイムが含まれます。 それぞれのランタイムで利用可能なライブラリーの詳細については、利用可能な Python ライブラリー をご参照ください。
Standard と Advanced の 2 つの ArcGIS Notebook Server ランタイムは、コンテナー イメージの一部としてノートブックで使用できます。 ライセンスとユーザー権限に応じて、Standard ランタイム、または Standard と Advanced 両方のランタイムを使用できます。
ArcGIS Notebook Server サイトの Windows コンテナーは、プロセスと Hyper-V という 2 種類のランタイム分離モードをサポートしています。 これらのモードの詳細については、Microsoft の 分離モード ドキュメントをご参照ください。 Hyper-V による分離を使用するようにサイトを構成する場合は、Hyper-V の役割をコンピューターにインストールする必要があります。 Windows Server に Hyper-V をインストールする 方法の詳細については、Microsoft のドキュメントをご参照ください。
注意:
Windows コンテナーを Hyper-V で使用するときに実行可能なコンテナーの数には制限があります。詳細については、Microsoft のコンテナーに関するよくある質問 をご参照ください。
コンテナーが起動されると、Esri から提供された Windows コンテナー イメージがそのコンテナーに適用されます。 ランタイムは、ArcGIS Notebook Server で構成されたライセンスとノートブック作成者の権限によって異なります。
注意:
torch ライブラリーまたは Python ライブラリー (torch が従属ライブラリーになっている) をインポートすると、WinError 1455 が発生する可能性のある既知の制限があります。 詳細については、「よくある問題と解決策」をご参照ください。
Windows システムの前提条件と制約
Windows コンテナーを使用して ArcGIS Notebook Server を Windows コンピューターに配置する場合には、考慮すべき前提条件と制約がいくつかあります。
Mirantis Container Runtime の要件
Mirantis Container Runtime を操作する場合、以下に注意してください:
現在、Mirantis Container Runtime は Windows Server 2022 のみをサポートしています。
ArcGIS Notebook Server と Mirantis Container Runtime を複数のコンピューター上にデプロイする場合、ワークスペース ディレクトリー用にレプリケーション (DFS) を構成する必要がなくなりました。 ワークスペース ディレクトリーは、Mirantis Container Runtime でドライブにマウントされるパスとして共有できます。