環境テンプレートのカスタマイズ

作成した環境テンプレートの名前、説明、およびハードウェア構成を変更することができます。 Jupyter ノートブック環境テンプレートのソフトウェア構成は、conda チャネルを介して、または pip を使用してカスタマイズできます。 conda パッケージのリスト、pip パッケージのリスト、またはその両方の組み合わせを指定することができます。 conda パッケージを使用する場合は、パッケージの取得に使用できる追加の conda チャネル・ロケーションのリストを指定できます。

必要な権限

環境テンプレートをカスタマイズするには、プロジェクトで Admin または Editor の役割を持っている必要があります。

制約事項

既存の環境テンプレートの言語を変更することはできません。

作成したSpark環境テンプレートのソフトウェア構成をカスタマイズすることはできません。

作成した環境テンプレートをカスタマイズするには、以下のようにします。

1. プロジェクトの 管理 タブで、 環境 ページをクリックしてください。
2. Active Runtimes（アクティブなランタイム）セクションで、変更したい環境テンプレートに対してアクティブなランタイムがないことを確認します。
3. 環境テンプレートセクションで、カスタマイズしたい環境テンプレートをクリックします。
4. Pythonのテンプレートで、IPyWidgetsライブラリを使用してノートブックにスライダー、ボタン、ドロップダウン、テキストボックスなどのインタラクティブ要素を追加したい場合は、IPyWidgetsチェックボックスを選択します。
5. Juypterノートブック環境テンプレートの場合、パッケージを追加したい場合は、Createをクリックし、デフォルトで利用可能な標準パッケージに追加するライブラリを指定します。 カスタマイズを使用して、標準のソフトウェア構成に含まれているパッケージをアップグレードまたはダウングレードすることもできます。
6. パッケージのカスタマイズを追加していない場合は、ウィンドウを閉じて変更を適用します。 新しいパッケージを追加した場合は、[適用]をクリックする必要があります。

パッケージをカスタマイズする際に重要：

• カスタマイズによって環境テンプレートに追加したライブラリは、環境ランタイムが起動するたびに自動的にインストールされます。 このテンプレートを使用している他のプロジェクトメンバーも、このパッケージを使用することができます。 すでに実行されているノートブックのセルに追加されたカスタマイズは、他のノートブックと共有されないことに注意してください。
• パッケージをカスタマイズする前に、計画している変更が意図した効果を持つかどうかを確認してください。
  • conda は、特定のパッケージを実際にインストールすることなく、そのパッケージのインストールに必要な変更を報告できます。 これらの変更はノートブックから確認できます。 例えば、ライブラリー Plotly の場合は：
    • Python ノートブックでは、 !conda install --dry-run plotly と入力します
    • 「R」 ノートブックで、 print(system2("conda", args=c("install","--dry-run","r-plotly"), stdout=TRUE))と入力します
  • pip はパッケージをインストールします。 ただし、確認後にランタイムを再び再始動すると、パッケージが削除されます。 ここでも、ノートブックから変更を確認できます。 例えば、ライブラリー Plotly の場合は：
    • Python ノートブックでは、 !pip install plotly と入力します
    • 「R」 ノートブックで、 print(system2("pip", args="install plotly", stdout=TRUE))と入力します
• デフォルト・チャネルから conda を介して、または PyPI からをpip 介してパッケージを取得できる場合、推奨される方法は、デフォルト・チャネルから conda を介して取得することです。
• conda では、多数のパッケージをカスタマイズに追加する場合、メモリーを大量に消費する可能性があるパッケージをインストールするときに、依存関係チェックを実行します。 ランタイムの開始時に依存関係チェックを実行できるようにするため、十分な RAM がある環境を選択してください。
• 1 つの Conda チャネルからのパッケージのみが必要な場合に、不要な依存関係チェックを行わないようにするには、テンプレートのチャネル・リストからを defaults 削除してデフォルトのチャネルを除外し、 nodefaults を追加します。
• Anaconda のメイン・チャンネルに加えて、多くの 「R」パッケージが Anaconda の 「R」 チャンネルで見つかれます。 「R」 環境では、このチャネルは既にデフォルト・チャネルの一部であるため、個別に追加する必要はありません。
• pip を介してのみ、または conda を介してのみ、カスタマイズ・テンプレートにパッケージを追加する場合は、テンプレート内で dependencies がコメント化されていないことを確認する必要があります。
• パッケージ・バージョンを指定する場合は、 conda パッケージの単一 = と pip パッケージの == を使用します。 可能な限り、バージョン番号を指定してください。こうすると、インストールにかかる時間とメモリー消費量が大幅に減るためです。 バージョンを指定しない場合、パッケージ・マネージャーは使用可能な最新バージョンを選択するか、またはパッケージで使用可能なバージョンを保持する可能性があります。
• ノートブック拡張機能は事前にインストールされている必要があるため、任意のノートブック拡張機能をカスタマイズとして追加することはできません