ノートブック・セッションの作成

データ・サイエンス・ノートブック・セッションを作成して、カスタマイズ可能なコンピュート、ストレージおよびネットワーク構成を使用する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の使用時にストレージ・マウントを設定します。

ストレージ・マウントの設定

  1. 選択したコンパートメントに移動します。
  2. OCIファイル・ストレージ・サービスの下に、エクスポートとともにファイル・システムを作成します。
  3. 既存のマウント・ターゲットを選択するか、新しいマウント・ターゲットを作成します。
    ファイル・システムがあり、エクスポートおよびマウント・ターゲットが作成されています。
  4. カスタム・ネットワーキングを設定します。
    新しいサブネットを作成することも、既存のサブネットを使用することもできます。マウント・ターゲットとノートブックが同じサブネットで構成されていることを確認します。
  5. ファイル・ストレージのVCNセキュリティ・ルールの構成で指定されているとおりに使用されるサブネットのセキュリティ・リスト・ルールを構成します。
    ノート

    ファイル・システムをマウントする前に、マウント・ターゲットとの間のネットワーク・トラフィックを許可するように、VCNサブネットにセキュリティ・ルールを構成する必要があります。セキュリティ・ルールは、サブネット・セキュリティ・リスト、ネットワーク・セキュリティ・グループ内、または両方の組合せを使用して設定できます。詳細は、ファイル・ストレージに対するVCNセキュリティ・ルールの構成を参照してください。
    • TCPポート111、2048、2049および2050とUDPポート111および2048へのステートフル・イングレス
    • TCPソース・ポート111、2048、2049および2050とUDPソース・ポート111のステートフル・エグレス

OCIオブジェクト・ストレージの使用

OCIオブジェクト・ストレージの使用時にストレージ・マウントを設定します。

オブジェクト・ストレージのストレージ・マウントでは、リソース・プリンシパル・ベースの認可を使用して、ノートブックと必要なバケット間で通信します。

ノートブックにデフォルトのネットワーク・オプションを使用するには、追加のネットワーク・ルールを構成する必要なく、管理対象エグレスが機能します。

ノートブックにカスタム・ネットワーク・オプションを使用するには、さらにいくつかのネットワーク設定が必要です。

ストレージ・マウントの設定

  1. VCNを選択して、サービス・ゲートウェイを作成します。
  2. 必要なプライベート・サブネットの場合は、ルート表構成にService Gatewayを追加します。
  3. 必要なサブネットのセキュリティ・リストのエグレス・ルールを変更して、リージョナルOracleネットワーク内のすべてのサービスへのトラフィックを許可します。

コンソール、CLIまたはAPIの使用

  • ブロック・ボリューム・サイズの決定に役立つように、ノートブック・セッションのブロック・ボリュームでのデータおよびファイルの永続化を確認することをお薦めします。

    1. 「プロジェクト」リスト・ページで、ノートブック・セッションを作成するプロジェクトを選択します。リスト・ページまたはプロジェクトの検索に関するヘルプが必要な場合は、プロジェクトのリストを参照してください。
    2. プロジェクトの詳細ページで、「ノートブック・セッション」を選択します。
    3. 「ノートブック・セッションの作成」を選択します。
      「ノートブック・セッションの作成」ページが開きます。

    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など)は指定できません。

      ノート

      カスタム・ネットワーキングを使用している場合:
      1. VCNにサービス・ゲートウェイを作成します。
      2. プライベート・サブネットのルート表構成の場合は、サービス・ゲートウェイを追加します。
      3. 必要なサブネットのセキュリティ・リストのエグレス・ルールを変更して、ネットワーク内のすべてのサービスへのトラフィックを許可します。
    • ランタイム構成(オプション): カスタム環境変数(キーと値のペア)および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操作を実行して、ノートブック・セッションを作成します。