Teradata Jupyter ExtensionsをJupyter Hubにデプロイする方法
概要
独自のJupyterHubクラスタをお持ちのお客様には、Teradata Jupyterエクステンションを既存のクラスタに統合するための2つのオプションがあります。
- Teradata Jupyter Dockerイメージの使用
- 既存のDockerイメージをカスタマイズして、Teradata 拡張機能を含める。
このページには、2 つのオプションに関する詳細な手順が記載されています。手順は、顧客の JupyterHub デプロイメントがKubernetes で JupyterHub をゼロから構築に基づいているという前提に基づいています。
Vantage のテストインスタンスが必要な場合は、 https://clearscape.teradata.com で無料でプロビジョニングできます
Teradata Jupyter Dockerイメージの使用
Teradata は jupyter/datascience-notebook 、イメージに基づいて構築された、すぐに実行できる Docker イメージを提供します。このイメージには、Teradata SQL カーネル、Teradata Python および R ライブラリとドライバ、および Teradata データベースとのやり取りの生産性を高めるための Jupyter 用の Teradata 拡張機能がバンドルされています。このイメージには、SQL カーネル、拡張機能、および Teradata ライブラリの使用方法を示すサンプル ノートブックも含まれています。
このイメージは以下のように使用することができます。
- ローカルのDockerコンテナで個人用Jupyter Notebookサーバを起動する
- JupyterHub を使用してチーム用の JupyterLab サーバーを実行する
ローカル Docker コンテナで個人用 JupyterLab サーバーを起動する手順については、 インストールガイドを参照してください。このセクションでは、顧客の既存の JupyterHub 環境で Teradata Jupyter Docker イメージを使用する方法に焦点を当てます。
Teradata Jupyter Dockerイメージをレジストリにインストールする
-
Vantage Modules for Jupyter ページに移動して Docker イメージをダウンロードします。これは
teradatajupyterlabext_VERSION.tar.gz
という形式の名前を持つ tarball です。 -
イメージをロードします。
- イメージをDockerレジストリにプッシュします。
シンプルにするために、読み込んだ画像の名前を変更することを検討するとよいでしょう。
JupyterHub で Teradata Jupyter Dockerイメージを使用する
- Teradata Jupyter Docker イメージを JupyterHub クラスターで直接使用するには、 JupyterHubのドキュメントの説明に従ってオーバーライド ファイルを変更します。
REGISTRY_URL
とVERSION
を上記の手順の適切な値に置き換えます。
- JupyterHub ドキュメントの説明に従って、クラス ターに変更を適用します。
複数のプロファイルを使用すると、ユーザーが JupyterHub にログインするときに使用するイメージを選択できるようになります。複数のプロファイルを構成する詳細な手順と例については、 JupyterHub ドキュメントを参照してください。
Teradata Jupyter Dockerイメージをカスタマイズする
Teradata Jupyter Dockerイメージにバンドルされていないパッケージやノートブックが必要な場合、Teradataイメージをベースイメー ジとして使用し、その上に新しいイメージをビルドすることをお勧めします。
以下は、Teradata イメージ上に構築され、追加のパッケージとノートブックを追加する Dockerfile の例です。Dockerfile を使用して新しい Docker イメージを構築し、そのイメージを指定されたレジストリにプッシュし、上記のようにオーバーライド ファイルを変更して新しいイメージをシングルユーザー イメージとして使用し、上記のようにクラスターに変更を適用します。 REGISTRY_URL
と VERSION
を適切な値に置き換えます。
既存のDockerイメージをカスタマイズして Teradata 拡張機能を含める
Teradata SQLカーネルとエクステンションは、現在使用している既存のイメージに含めることができます。
-
Vantage Modules for Jupyterページに移動して、圧縮された Teradata Jupyter 拡張機能パッケージ バンドルをダウンロードしてください。既存の Docker イメージが Linux ベースである場合は、ダウンロードの Linux バージョンを使用する必要があります。それ以外の場合は、使用しているプラットフォーム用のダウンロードを使用してください。
.zip
ファイルには、Teradata SQL カーネル、拡張機能、およびサンプル ノートブックが含まれています。 -
バンドル ファイルを作業ディレクトリに解凍します。
-
以下は、既存の Docker イメージに Teradata Jupyter 拡張機能を追加するための Dockerfile の例です。Dockerfile を使用して新しい Docker イメージを構築し、イメージを指定されたレジストリにプッシュし、上記のようにオーバーライド ファイルを変更して新しいイメージをシングルユーザー イメージとして使用し、変更をクラスターに適用します。
-
Teradata package for PythonとTeradata package for Rはオプションでインストールすることができます。詳細については、以下のページを参照してください。
さらに詳しく
ご質問がある場合やさらにサポートが必要な場合は、 コミュニティフォーラム にアクセスしてサポートを受けたり、他のコミュニティ メンバーと交流したりしてください。