Oracle Cloud Infrastructureドキュメント

コンダ環境の別のリージョンへのコピー

このチュートリアルでは、ノートブック・セッションにconda環境をインストールします。次に、同じconda環境を別のリージョンでホストする2つ目のノートブック・セッションにインストールするために必要なステップを実行します。

主なタスクは:

  • テナンシの2つの異なるリージョンに2つのバケットを作成します。
  • 各バケットをリージョン内のノートブック・セッションに登録します。
  • 1つ目のノートブック・セッションにconda環境をインストールします。
  • conda環境を公開します。(環境にアクセスできる任意のノートブック・セッションからインストールできるようにconda環境を準備します。)
  • 最初のノートブック・セッションから、公開されたconda環境を同じリージョンのバケットに追加します。
  • 公開されたconda環境をバケット間でコピーします。
  • 2つ目のリージョンのノートブック・セッションで、2つ目のバケットを使用してconda環境をインストールします。

詳細は、次を参照してください:

開始する前に

このチュートリアルを正常に実行するには、次が必要です:

要件

  • 支払済Oracle Cloud Infrastructure (OCI)アカウントまたはOracle Cloudプロモーションの新しいアカウント。無料Oracle Cloudプロモーションのリクエストおよび管理を参照してください。

  • MacOS、LinuxまたはWindowsコンピュータ。
  • データ・サイエンス・チュートリアル:
    • データ・サイエンス・テナンシの手動構成のすべてのステップを実行し、次のプロパティで2つのノートブック・セッションを作成します:
      • 作業のコンパートメントにdata-science-workを指定します。
      • 2つのリージョンにノートブック・セッションを作成します:
        • リージョンを変更するには、コンソールの上部のナビゲーション・バーでリージョンを選択し、新しいリージョン名をクリックします。たとえば、US West (Phoenix)からUS East (Ashburn)に切り替えます。
        • プロジェクトおよびノートブック・セッションに名前を付けます:
          • <region-1>: Initial Project およびmy-first-notebook-session
          • <region-2>: Second Project およびmy-second-notebook-session

1. バケットの作成

my-first-notebook-sessionおよびmy-second-notebook-sessionのconda環境を格納する2つのバケットを作成します。

2つのバケットの作成

<region-1>にバケットを作成し、<region-2>に別のバケットを作成します。

  1. ナビゲーション・メニューを開き、「ストレージ」を選択します。「Object Storage & Archive Storage」で、「Buckets」をクリックします
  2. 左側のナビゲーションの「リストのスコープ」で、data-science-workコンパートメントを選択します。
  3. 上部のナビゲーション・バーで、<region-1>を選択します。たとえば、US West (Phoenix)です。
  4. 「バケットの作成」を選択します。
  5. 次の情報を入力します:
    • 名前: bucket-1
    • 他のフィールドはデフォルト値のままにします。
      • デフォルト・ストレージ層:標準
      • 暗号化: Oracle管理キーを使用した暗号化
  6. 「作成」を選択します。
  7. バケットのリストで、bucket-1がプライベート可視性になっていることを確認します:
    バケットは、作成後に可視性を変更しないかぎりプライベートです。
  8. 上部のナビゲーション・バーで<region-1>を選択し、リージョンのリストから<region-2>を選択します。たとえば、US East (Ashburn)に切り替えます。
  9. 前のステップを繰り返して、<region-2>にbucket-2を作成します。
2つの異なるリージョンに2つのプライベート・バケットが正常に作成されました。
テナンシ・ネームスペースの取得

すべてのテナンシには、システム生成の一意の不変オブジェクト・ストレージ・ネームスペース名があります。このネームスペース名は、すべてのリージョンで同じです。このステップでは、このネームスペース名をコピーし、後でそれを使用してバケットをノートブック・セッションに登録します。

  1. ナビゲーション・メニューを開き、「ストレージ」を選択します。「Object Storage & Archive Storage」で、「Buckets」をクリックします
  2. 左側のナビゲーションの「リストのスコープ」で、data-science-workコンパートメントを選択します。
  3. 上部のナビゲーション・バーで、<region-2>を選択します。たとえば、US East (Ashburn)です。
  4. バケットのリストで、bucket-2を選択します。
  5. ネームスペースをノートパッドにコピーします: <tenancy-namespace>。
    ノート

    ネームスペース名は、テナンシ内で一意です。bucket-1とbucket-2が異なるテナントにある場合は、両方のバケットのネームスペース名をコピーします。

2. リージョン1でのConda環境の公開

ノートブック・セッションにconda環境をインストールします。次に、ノートブック・セッションからconda環境をバケットに公開します。

bucket-1の登録

bucket-1をmy-first-notebook-sessionに登録します。

  1. コンソールの上部のナビゲーション・バーで、<region-1>を選択します。
  2. 左側のナビゲーションの「リストのスコープ」で、data-science-workコンパートメントを選択します。
  3. ナビゲーション・メニューを開き、「分析とAI」を選択します。「機械学習」で、「データ・サイエンス」を選択します。
  4. プロジェクトのリストで、Initial Projectを選択します。
  5. my-first-notebook-sessionを選択し、「開く」をクリックします。
  6. 資格証明を入力して、JupyterLab対話型ノートブックにアクセスします。
  7. UIにランチャというタブがない場合は、「ファイル」、「新規ランチャ」の順にクリックします。
  8. ランチャの「その他」で、「ターミナル」アイコンを選択して新しいターミナル・セッションを開始します。
  9. ターミナルで、次のコマンドを入力します。

    <tenancy-namespace>を、「バケットの作成」セクションで収集した情報に置き換えます。

    odsc conda init -b bucket-1 -n <tenancy-namespace>
  10. 「ファイル」に移動し、「パスから開く...」を選択します。「オープン・パス」フィールドに、/condaと入力します。
  11. 前述のコマンドでバケットがノートブックに登録されたことを確認するには、condaフォルダでconfig.yamlをクリックし、次のコード・ブロックでbucket-1およびネームスペースを検索します: 
    auth_mode: resource_principal
bucket_info:
  name: bucket-1
  namespace: <tenancy-namespace>
pack_prefix: conda_environments
Conda環境のインストール

ノートブック・セッションに事前構築済のデータ・サイエンスconda環境をインストールします。

  1. my-first-notebook-sessionで、「ファイル」、「新規ランチャ」の順にクリックします。
  2. ランチャの「拡張機能」で、「環境エクスプローラ」アイコンを選択します。
  3. Conda環境のリストで、「Python 3.12上のCPU用一般機械学習」を展開します。
  4. Python 3.12上のCPU用一般機械学習をインストールするためのコマンドをコピーし、端末に貼り付けます: 
    odsc conda install -s generalml_p312_cpu_x86_64_v1

    バージョン番号は、1.0などデフォルトで表示される値のままにします。

  5. パッケージがインストールされていることを確認します: 
    odsc conda list -l
  6. 環境エクスプローラで、リフレッシュ・アイコンを選択します。
  7. 「インストール済Conda環境」リンクを選択します。
  8. Conda環境のリストで、Python 3.12上のCPU用一般機械学習がリストされていることを確認します。
  9. 次に、「ファイル」、「新規ランチャ」の順に選択します。「カーネル」セクションで、公開されたconda環境であるPython 3.12上のCPUの一般的な機械学習をアイコンとしてリストします。
<region-1>のノートブック・セッションにconda環境が正常にインストールされました。
Conda環境の公開

ノートブック・セッションに登録されたバケットにconda環境を公開します。

  1. my-first-notebook-sessionの環境エクスプローラで、「インストールされたCda環境」を選択します。
  2. 「Python 3.12上のCPU用一般機械学習」を展開します。
  3. Python 3.12上のCPU用一般機械学習を公開するためのコマンドをコピーします:
  4. Python 3.12上のCPU用一般機械学習を公開するコマンドをコピーし、ノートブック・セッション内のターミナルにパブリッシュ・コマンドをペーストして、[Enter]をクリックします。 
    odsc conda publish -s generalml_p312_cpu_x86_64_v1
  5. 「環境エクスプローラ」で、「リフレッシュ」を選択します。
  6. 「公開されたConda環境」リンクを選択します。
  7. Conda環境のリストで、Python 3.12上のCPU用一般機械学習がリストされていることを確認します。
<region-1>のバケットにconda環境が正常に公開されました。

3. リージョン2へのバケットのコピー

公開されたconda環境をbucket-1からbucket-2にコピーします。

バケットのコンテンツのコピー

公開されたconda環境は、オブジェクトとしてbucket-1に格納されます。このオブジェクトをbucket-2にコピーします。

  1. ナビゲーション・メニューを開き、「ストレージ」を選択します。「Object Storage & Archive Storage」で、「Buckets」をクリックします
  2. 左側のナビゲーションの「リストのスコープ」で、data-science-workコンパートメントを選択します。
  3. 上部のナビゲーション・バーで、<region-1>を選択します。たとえば、US West (Phoenix)です。
  4. bucket-1を選択します。
  5. 「オブジェクト」で、conda_environments、cpu、General Machine Learning for CPUs on Python 3.12、1.0の順に展開してgeneralml_p312_cpu_x86_64_v1にアクセスします。
  6. generalml_p312_cpu_x86_64_v1の「アクション」メニュー(3つのドット)を選択し、「コピー」をクリックします。
  7. 次の情報を入力します:
    • 宛先ネームスペース: <tenancy-namespace>
    • 宛先リージョン: <region-2>(US East (Ashburn)など)。
    • 宛先バケット: bucket-2
    • 宛先オブジェクト名: ディレクトリ構造を維持するためにデフォルトの文字列のままにします。
    • 他のフィールドはデフォルト値のままにします。
      • 宛先ストレージ層: (空白のまま)
      • 上書きルール: 宛先オブジェクトの上書き
  8. 「オブジェクトのコピー」を選択します。
  9. 正しいIAMポリシー・ステートメントがないという警告セクションが表示された場合は、「ステートメントの追加を試行」を選択します。 
    Allow service objectstorage-<region-1> to manage object-family in compartment data-science-work

    この警告メッセージが表示されない場合は、次の3つのステップをスキップします。

  10. 「IAMポリシーの追加」パネルで、デフォルトのままにします。
    • 名前: console-iam-policy-<timestamp>
    • 説明: <timestamp>でコンソールによって作成されたIAMポリシー・ステートメント
    • ルート・コンパートメントへのポリシー・ステートメントの追加:選択されていません
    • ポリシー・ステートメント: 
      Allow service objectstorage-<region-1> to manage object-family in compartment data-science-work
  11. (オプション)他のリージョンのオブジェクトのコンパートメントへのコピーを許可するには、「IAMポリシーの追加」パネルの「ポリシー・ステートメント」セクションに、次のポリシーを追加します
    ノート

    他のリージョンのオブジェクトをコンパートメントにコピーできるようにするには、「IAMポリシーの追加」パネルの「ポリシー・ステートメント」セクションに、次のポリシーを追加します: 
    allow service objectstorage-<region_name> to manage object-family in compartment data-science-work
    <region_name>変数の値の例を次に示します。
    • objectstorage-us-phoenix-1
    • objectstorage-us-ashburn-1
    • objectstorage-eu-frankfurt-1
    • objectstorage-uk-london-1
    • objectstorage-ap-tokyo-1

    ここで、object-storage-<region_name> にはソース・バケットが含まれ、コピー操作が実行されます。

    リージョン名の完全なリストについては、リージョンと可用性ドメインの表を参照してください。

    オブジェクトを他のリージョンにコピーする方法の詳細は、サービス権限を参照してください。

  12. 「作成」を選択します。
  13. 「Policies added successfully」というメッセージが表示されるまで待ちます。
  14. 「オブジェクトのコピー」を選択します。
  15. 「作業リクエストの詳細」ダイアログで、「ステータス」に「完了」と「完了率」が100%と表示されていることを確認します。次に、ダイアログを閉じます。
2つ目のバケットでのコンテンツの検証

公開されたconda環境がオブジェクトとしてbucket-2に格納されていることを確認します。

  1. 上部のナビゲーション・バーで、<region-2>を選択します。たとえば、US East (Ashburn)です。
  2. bucket-2を選択します。
  3. 「オブジェクト」で、conda_environments、cpu、General Machine Learning for CPUs on Python 3.12、1.0の順に展開してgeneralml_p312_cpu_x86_64_v1にアクセスします。
bucket-1からbucket-2に、公開されたconda環境が正常にコピーされました。

4. リージョン2へのConda環境のインストール

2つ目のリージョンのノートブック・セッションにbucket-2を登録します。次に、ノートブック・セッションにconda環境をインストールして表示します。

bucket-2の登録

bucket-2を<region-2>のmy-second-notebook-sessionに登録します。

  1. コンソールの上部のナビゲーション・バーで、region-2を選択します。
  2. ナビゲーション・メニューを開き、「分析とAI」を選択します。「機械学習」で、「データ・サイエンス」を選択します。
  3. 左側のナビゲーションの「リストのスコープ」で、data-science-workコンパートメントを選択します。
  4. プロジェクトのリストで、Second Projectを選択します。
  5. my-second-notebook-sessionを選択し、「開く」をクリックします。
  6. JupyterLab UIにアクセスするための資格証明を入力します。
  7. ランチャというタブがない場合は、「ファイル」、「新規ランチャ」の順にクリックします。
  8. ランチャで、「ターミナル」を選択します。
  9. ターミナルで、次のコマンドを入力します。

    <tenancy-namespace>を、「バケットの作成」セクションで収集した情報に置き換えます。

    odsc conda init -b bucket-2 -n <tenancy-namespace>
  10. バケットがノートブックに登録されていることを確認します:

    ファイル・エクスプローラ・セクションで、condaフォルダの下のconfig.yamlを選択し、次のコードについてファイルを確認します:

    auth_mode: resource_principal
bucket_info:
  name: bucket-2
  namespace: <tenancy-namespace>
pack_prefix: conda_environments
公開されたConda環境のインストール

コピーしたconda環境を2つ目のノートブック・セッションで表示します。

  1. my-second-notebook-sessionで、「ファイル」、「新規ランチャ」の順にクリックします。
  2. ランチャの「カーネル」で、「環境エクスプローラ」アイコンを選択します。
  3. 「公開されたConda環境」リンクを選択します。
  4. Conda環境のリストで、「Python 3.12上のCPU用一般機械学習」を展開します。
    ノート

    ノートブック・セッションに公開されたconda環境があるということは、次のことを意味します:
    • そのconda環境をノートブック・セッションにインストールできます。
    • 公開されたconda環境はまだインストールされていない可能性があります。
    • conda環境を使用するには、ここから環境をインストールできます。
    • 公開されたconda環境は、インストール後も公開されたconda環境のリストに残ります。
  5. Python 3.12上のCPU用一般機械学習をインストールするためのコマンドをコピーし、端末に貼り付けます: 
    odsc conda install -s generalml_p312_cpu_x86_64_v1

    バージョン番号は、1.0などデフォルトで表示される値のままにします。

  6. ターミナルで、パッケージがインストールされていることを確認します: 
    odsc conda list -l
  7. 「環境エクスプローラ」で、「リフレッシュ」を選択します。
  8. 「インストール済Conda環境」リンクを選択します。
  9. Conda環境のリストで、Python 3.12上のCPU用一般機械学習がリストされていることを確認します。
ノートブック・セッションのbucket-2で公開されたコピーからconda環境が正常にインストールされました。

次の手順

あるリージョンから別のリージョンにconda環境が正常にコピーされ、2つ目のリージョンのノートブック・セッションで使用されました。

conda環境についてさらに学習するには、ノートブック・セッションで次のようにします:

  • ランチャの「Extenstions」で、「Notebook Explorer」アイコンを選択します。ONNX Integration with the Accelerated Data Science (ADS) SDKを選択し、「開く」を選択して、例を確認します。
  • 環境エクスプローラに移動し、このチュートリアルでは説明していないその他の事前構築済データ・サイエンスconda環境をインストールします。