Oracle Cloud Infrastructureドキュメント

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

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

ノートブックの作成

ノートブックを作成するステップ。

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

    1. プロジェクトの詳細ページで、「ノートブック・セッションの作成」を選択します。プロジェクトのリストの検索に関するヘルプが必要な場合は、プロジェクトのリストを参照してください。
    2. (オプション)ノートブック・セッションの一意の名前を入力します(255文字の制限)。名前を指定しない場合、名前は自動生成されます。たとえば、datasciencenotebooksession20200108222435です。
    3. (オプション)説明を入力します。
    4. (オプション)「シェイプの変更」を選択して、コンピュート・シェイプを変更します。その後、「コンピュートの選択」パネルの次のステップに従います。
      1. インスタンス・タイプの選択
      2. シェイプ・シリーズを選択します。
      3. シリーズでサポートされているコンピュート・シェイプのいずれかを選択します。
      4. リソースの使用方法に最適なシェイプを選択します。

        OCPUごとに、最大64 GBのメモリーと最大合計512 GBを選択します。許容されるメモリーの最小容量は、1GBまたはOCPUの数に一致する値のいずれか大きい方です。

      5. バースト可能な仮想マシンを使用している場合は、「バースト可能」を切り替えます。
        「OCPU当たりのベースライン使用率」で、通常使用するOCPUの割合を選択します。サポートされている値は、12.5%および50%です。
      6. 「シェイプの選択」を選択します。
    5. 使用するブロック・ストレージ・サイズを50 GBから10 240 GB (10 TB)の間で入力します。値は1GB単位で変更できます。デフォルト値は100 GBです。
    6. ネットワーク・タイプを構成するには、次のいずれかのオプションを選択します。

      • デフォルト・ネットワーク - ワークロードは、セカンダリVNICを使用して、事前構成済のサービス管理VCNおよびサブネットにアタッチされます。提供されているこのサブネットは、NATゲートウェイを介したパブリック・インターネットへのエグレスおよびサービス・ゲートウェイを介した他のOracle Cloudサービスへのアクセスを許可します。

        パブリック・インターネットおよびOCIサービスのみにアクセスする必要がある場合は、このオプションを使用することをお薦めします。ネットワーキング・リソースの作成や、ネットワーキング権限のポリシーの書込みは不要です。

      • カスタム・ネットワーク - リソースに使用するVCNおよびサブネット(ノートブック・セッションまたはジョブ)を選択します。

        パブリック・インターネットへのエグレス・アクセスには、NATゲートウェイへのルートを持つプライベート・サブネットを使用します。

        使用するVCNまたはサブネットが表示されない場合は、「コンパートメントの変更」を選択し、VCNまたはサブネットを含むコンパートメントを選択します。

        重要

        ファイル・ストレージ・マウントを使用するには、カスタム・ネットワーキングを選択する必要があります。VCNおよびサブネットは、マウント・ターゲットの作成に使用されたものと同じである必要があります。

      ノート

      ノートブック・セッションが再アクティブ化されると、ノートブック・セッションのネットワーク構成は変更できません。ノートブック・セッションがデフォルト・ネットワークを使用するように構成されている場合、ノートブック・セッションを非アクティブ化してから、再アクティブ化するときにカスタム・ネットワーキングを選択することはできません。

    7. エンドポイント・タイプを構成するには、次のいずれかのオプションを選択します:

      • パブリック・エンドポイント - VCNの外部から管理対象インスタンス内のデータ・アクセス。

      • プライベート・エンドポイント - ノートブック・セッションに使用するVCN、サブネットおよびプライベート・エンドポイントを選択します。

        「コンパートメントの変更」を選択して、VCN、サブネットまたはプライベート・エンドポイントを含むコンパートメントを選択します。

    8. (オプション)ストレージ・マウントを使用するには、+Addストレージ・マウントを選択します。
      ストレージマウントを使用する承認があることを確認します。
      1. ストレージ・マウント・タイプとして、OCI Object StorageまたはOCI File Storageを選択します。
      2. マウントするストレージ・リソースを含むコンパートメントを選択します。
      3. 次のいずれかを選択します:
        オブジェクト・ストレージ
        カスタム・ネットワーキングを使用している場合:
        1. VCNにサービス・ゲートウェイを作成します。
        2. プライベート・サブネットのルート表構成の場合は、サービス・ゲートウェイを追加します。
        3. 必要なサブネットのセキュリティ・リストのエグレス・ルールを変更して、ネットワーク内のすべてのサービスへのトラフィックを許可します。

        使用するバケット。

        オブジェクト名の接頭辞を追加できます。接頭辞は英数字で始める必要があります。使用できる文字は、英数字、スラッシュ( / )、ハイフン( - )およびアンダースコア( _ )です。

        File Storage

        使用するマウント・ターゲットおよびエクスポート・パス。ファイル・システムを作成する必要があります。既存のマウント・ターゲットを指定するか、新しいターゲットを作成します。

        ファイル・ストレージを使用するには、カスタム・ネットワークを使用する必要があります。

        サブネットのセキュリティ・リスト・ルールに従います。
        ノート

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

        ストレージは、指定されたマウントパスの下にマウントされます。パスは英数字で始める必要があります。宛先ディレクトリは、指定されたストレージマウント全体で一意である必要があります。使用できる文字は、英数字、ハイフン( - )およびアンダースコア( _ )です。

        /opc/storage-directoryなどのフルパスを指定できます。/storage-directoryなどのディレクトリのみが指定されている場合は、デフォルトの/mntディレクトリの下にマウントされます。/binや/etcなど、OS固有のディレクトリは指定できません。

      5. 「送信」を選択します。

        これらのステップを繰り返して、ノートブック・セッションに最大2つのストレージ・マウントを追加します。

    9. (オプション)「ランタイム構成」セクションを展開して、次のようにカスタム環境変数およびGit設定を定義します:

      • キーと値のペア - タブを選択し、キーと値で環境変数を入力します。キーに名前を付けるには、キー値ペアの制約を参照してください。

      • Git設定 - タブを選択し、最大3つのパブリックGitリポジトリURLを入力します。URLの数とサイズについては、Gitリポジトリの制約を確認してください。

        ヒント

        ADSリポジトリの例を使用すると、JupyterLabでノートブックを開いたときに使用できるGitリポジトリを迅速に作成できます。https://github.com/oracle/accelerated-data-science.gitを参照してください。

    10. (オプション)「タグ」セクションで、<resourceType>に1つ以上のタグを追加します。リソースの作成権限がある場合は、フリーフォーム・タグをそのリソースに適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後で適用できます。
    11. (オプション)作成直後にノートブック・セッションの詳細を表示するには、「「作成」をクリックして詳細ページを表示します。
    12. 「作成」を選択します。
    ノートブック・セッション・ページが開きます。ノートブック・セッションが正常に作成されると、ステータスは「アクティブ」になり、ノートブック・セッションを開くことができます。ノートブック・セッションの作成アクションは非同期で、作業リクエストを開始します。作業リクエストを使用すると、操作のステータスをトラッキングできます。OCIでの作業リクエストの使用の詳細は、作業リクエストおよび作業リクエストAPIを参照してください。

  • コンパートメントにノートブック・セッションを作成するには、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操作を実行して、ノートブック・セッションを作成します。