ノートブック・セッションの作成
データ・サイエンス・ノートブック・セッションを作成して、カスタマイズ可能なコンピュート、ストレージおよびネットワーク構成を使用するJupyterLabインタフェースにアクセスします。
開始する前に
ランタイム構成を使用するには、使用するカスタム環境変数およびGitリポジトリURLを指定します。
ノートブック・セッションが再アクティブ化されると、ノートブック・セッションのネットワーク構成を変更できません。ノートブック・セッションがデフォルト・ネットワークを使用するように構成されている場合、ノートブック・セッションを非アクティブ化してから、再アクティブ化するときにカスタム・ネットワーキングを選択することはできません。
Oracle管理機能を使用するためのネットワーキング設定
ノートブック、ノートブック・ライフサイクル・スクリプト、AIクイック・アクション、環境エクスプローラおよびサンプル・ノートブック内のOracle管理機能を使用するには、ノートブック・サブネットにOCIオブジェクト・ストレージへのアクセス権限が必要です。
ノートブックの「デフォルト・ネットワーキング」を選択した場合、ノートブック・サブネットはオブジェクト・ストレージにアクセスできます。「カスタム・ネットワーキング」を選択した場合は、サービス・ゲートウェイまたはNat Gatewayのいずれかを使用してObject Storageアクセスを設定する必要があります。サービス・ゲートウェイを設定して、すべてのサービスまたはリージョン固有のObject Storageにアクセスできます。詳細は、ネットワーキング・ドキュメントのサービス・ゲートウェイの作成およびサービス・ゲートウェイの概要を参照してください。または、パブリック・インターネット・アクセスを許可するようにNat Gatewayを設定できます。詳細は、ネットワーキング・ドキュメントのNat Gatewayを参照してください。
インターネット・ゲートウェイを使用する場合は、ノートブックを使用してパブリック・インターネットに接続できません。これは、インターネット・ゲートウェイが、その背後にあるリソースが、データ・サイエンス・ノートブックで使用しないパブリックIPを持つパブリック・サブネットであると想定しているためです。また、ノートブックはOracle管理機能への接続にも対応しません。
ストレージ・マウントの設定
ストレージ・マウントを使用するには、オブジェクト・ストレージ・バケットまたはOCI File Storage Service (FSS)マウント・ターゲットおよびエクスポート・パスが必要です。
FSSを使用するには、まずファイル・システムおよびマウント・ポイントを作成する必要があります。カスタム・ネットワーキング・オプションを使用して、マウント・ターゲットとノートブックが同じサブネットで構成されていることを確認します。特定のポートおよびプロトコルを使用してサブネットのセキュリティ・リスト・ルールを構成します。
サービス制限がfile-system-countおよびmount-target-countに割り当てられていることを確認します。
ノートブックのストレージ・マウントにオブジェクト・ストレージまたはファイル・ストレージ・サービス(FSS)を使用するようにポリシーを設定する必要があります。
OCIファイル・ストレージの使用
OCI File Storageの使用時にストレージ・マウントを設定します。
ストレージ・マウントの設定
OCIオブジェクト・ストレージの使用
OCIオブジェクト・ストレージの使用時にストレージ・マウントを設定します。
オブジェクト・ストレージのストレージ・マウントでは、リソース・プリンシパル・ベースの認可を使用して、ノートブックと必要なバケット間で通信します。
ノートブックにデフォルトのネットワーク・オプションを使用するには、追加のネットワーク・ルールを構成する必要なく、管理対象エグレスが機能します。
ノートブックにカスタム・ネットワーク・オプションを使用するには、さらにいくつかのネットワーク設定が必要です。
ストレージ・マウントの設定
- VCNを選択して、サービス・ゲートウェイを作成します。
-
必要なプライベート・サブネットの場合は、ルート表構成に
Service Gatewayを追加します。 - 必要なサブネットのセキュリティ・リストのエグレス・ルールを変更して、リージョナルOracleネットワーク内のすべてのサービスへのトラフィックを許可します。
コンソール、CLIまたはAPIの使用
ブロック・ボリューム・サイズの決定に役立つように、ノートブック・セッションのブロック・ボリュームでのデータおよびファイルの永続化を確認することをお薦めします。
1. 基本的な情報
オプションで、識別情報を変更します。
- コンパートメント: ノートブック・セッションを作成するコンパートメントを選択します。
- 名前(オプション): ノートブック・セッションの一意の名前を入力します(255文字の制限)。名前を指定しない場合、名前は自動的に生成されます。たとえば、
datasciencenotebooksession20200108222435です。 - タグ(オプション): ノートブック・セッションにタグを追加します。リソースを作成するアクセス許可がある場合、そのリソースにフリーフォーム・タグを適用するアクセス許可もあります。定義済タグを適用するには、タグネームスペースを使用する権限を持つ必要があります。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。
2. 構成
コンピュート・シェイプおよびネットワーク設定を指定します。
- シェイプ(オプション): 「シェイプの変更」を選択してコンピュート・シェイプを変更します。次に、「コンピュート・シェイプの選択」パネルの次のステップに従います。
- インスタンス・タイプの選択
- シェイプ・シリーズを選択します。
- サポートされているシリーズ内のコンピュート・シェイプのいずれかを選択します。リソースの使用方法に最適なシェイプを選択します。
- 選択したシェイプを展開して、OCPUおよびメモリーを構成します。
- OCPUの数
- メモリー量(GB): OCPUごとに、最大64 GBのメモリーと最大合計512 GBを選択します。許容されるメモリーの最小容量は、1GBまたはOCPUの数に一致する値のいずれか大きい方です。
- バースト可能なシェイプの有効化: バースト可能な仮想マシンを使用する場合に選択し、「OCPU当たりのベースライン使用率」で、通常使用するOCPUの割合を選択します。サポートされている値は、12.5%および50%です。(モデル・デプロイメントでは、50%の値のみがサポートされます。)
- 「シェイプの選択」を選択します。
- ブロック・ストレージ・サイズ: 使用するブロック・ストレージ・サイズを50 GBから10、 240 GB (10 TB)の間で入力します。値は1GB単位で変更できます。デフォルト値は100 GBです。
- ネットワーキング・タイプ: 関連するオプションを選択します。
-
デフォルト・ネットワーク - ワークロードは、セカンダリVNICを使用して、事前構成済のサービス管理VCNおよびサブネットにアタッチされます。提供されているこのサブネットは、NATゲートウェイを介したパブリック・インターネットへのエグレスおよびサービス・ゲートウェイを介した他のOracle Cloudサービスへのアクセスを許可します。
パブリック・インターネットおよびOCIサービスのみにアクセスする必要がある場合は、このオプションを使用することをお薦めします。ネットワーキング・リソースの作成や、ネットワーキング権限のポリシーの書込みは不要です。
-
カスタム・ネットワーキング - リソース(ノートブック・セッションまたはジョブ)に使用するVCNおよびサブネット(指定されたコンパートメントから)を選択します。
パブリック・インターネットへのエグレス・アクセスには、NATゲートウェイへのルートを持つプライベート・サブネットを使用します。
使用するVCNまたはサブネットが表示されない場合は、別のコンパートメントを選択します。
重要
ファイル・ストレージ・マウントを使用するには、カスタム・ネットワークを選択する必要があります。VCNおよびサブネットは、マウント・ターゲットの作成に使用されたものと同じである必要があります。
ノート
ノートブック・セッションが再アクティブ化されると、ノートブック・セッションのネットワーク構成を変更できません。ノートブック・セッションがデフォルト・ネットワークを使用するように構成されている場合、ノートブック・セッションを非アクティブ化してから、再アクティブ化するときにカスタム・ネットワーキングを選択することはできません。 -
- エンドポイント・タイプ: 関連するオプションを選択します。
- パブリック・エンドポイント - VCNの外部から管理対象インスタンス内のデータ・アクセス。
- プライベート・エンドポイント - ノートブック・セッションに使用するVCN、サブネットおよびプライベート・エンドポイント(指定されたコンパートメントから)を選択します。
3. 追加設定
オプションで、ストレージ・マウント、実行時構成およびタグを追加します。
- ファイル・ストレージ・マウント(オプション): 「ファイル・ストレージ・マウントの追加」を選択し、次の情報を入力します。
- コンパートメント: マウントするターゲットを含むコンパートメントを選択します。
- マウント・ターゲット: 使用するマウント・ターゲット。
- エクスポート・パス: 使用するエクスポート・パス。
- 宛先パスおよびディレクトリ: 記憶域のマウントに使用するパスを入力します。
パスは英数字で始める必要があります。宛先ディレクトリは、指定されたストレージ・マウント全体で一意である必要があります。使用できる文字は、英数字、ハイフン( - )およびアンダースコア( _ )です。
/opc/storage-directoryなどのフルパスを指定できます。/storage-directoryなどのディレクトリのみが指定されている場合は、デフォルトの/mntディレクトリの下にマウントされます。/binや/etcなど、OS固有のディレクトリは指定できません。
- オブジェクト・ストレージ・マウント(オプション): 「オブジェクト・ストレージ・マウントの追加」を選択し、次の情報を入力します。
- コンパートメント: マウントするバケットが含まれるコンパートメントを選択します、
- バケット: 使用するバケットを選択します。
- オブジェクト名の接頭辞(オプション): オブジェクト名の接頭辞。接頭辞は英数字で始める必要があります。使用できる文字は、英数字、スラッシュ( / )、ハイフン( - )およびアンダースコア( _ )です。
- 宛先パスおよびディレクトリ: 記憶域のマウントに使用するパスを入力します。
パスは英数字で始める必要があります。宛先ディレクトリは、指定されたストレージ・マウント全体で一意である必要があります。使用できる文字は、英数字、ハイフン( - )およびアンダースコア( _ )です。
フル・パス(
/opc/storage-directoryなど)を指定できます。/storage-directoryなどのディレクトリのみが指定されている場合は、デフォルトの/mntディレクトリにマウントされます。OS固有のディレクトリ(/binや/etcなど)は指定できません。
ノート
カスタム・ネットワーキングを使用している場合:- VCNにサービス・ゲートウェイを作成します。
- プライベート・サブネットのルート表構成の場合は、サービス・ゲートウェイを追加します。
- 必要なサブネットのセキュリティ・リストのエグレス・ルールを変更して、ネットワーク内のすべてのサービスへのトラフィックを許可します。
- ランタイム構成(オプション): カスタム環境変数(キーと値のペア)およびGit設定を定義します。
- キーと値のペア: 「キーと値のペアの追加」を選択し、キーと値を入力します。最大30個のキー値ペアを追加できます。キーに名前を付けるには、キー値ペアの制約を参照してください。
- Git settings: 「Add Git setting」を選択して、公開GitリポジトリURLを入力します。最大3 Gitリポジトリを追加できます。Gitリポジトリ制約でURLの数とサイズを確認します。ヒント
ADSリポジトリの例を使用すると、ノートブックをJupyterLabで開くときに使用できるGitリポジトリをすばやく作成できます。https://github.com/oracle/accelerated-data-science.gitを参照してください。
- タグ(オプション): ノートブック・セッションにタグを追加します。リソースを作成するアクセス許可がある場合、そのリソースにフリーフォーム・タグを適用するアクセス許可もあります。定義済タグを適用するには、タグネームスペースを使用する権限を持つ必要があります。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。
4. レビューと作成
構成を確認し、「作成」を選択します。
「ノートブック・セッション」ページが開きます。ノートブック・セッションが正常に作成されると、ステータスは「アクティブ」になり、ノートブック・セッションをオープンできます。ノートブック・セッションの作成アクションは非同期で、作業リクエストを開始します。作業リクエストを使用すると、操作のステータスをトラッキングできます。
OCIでの作業リクエストの使用に関する一般的な情報は、作業リクエストを参照してください。
コンパートメントにノートブック・セッションを作成するには、oci data-science notebook-session createコマンドおよび必須パラメータを使用します:
oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>] ... [OPTIONS]CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。
CreateNotebookSession操作を実行して、ノートブック・セッションを作成します。