Amazon SageMaker Studio Lab 環境を Amazon SageMaker Studio Classic にエクスポートする - Amazon SageMaker AI

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon SageMaker Studio Lab 環境を Amazon SageMaker Studio Classic にエクスポートする

Amazon SageMaker Studio Classic では、Amazon SageMaker Studio Lab では利用できない機械学習および深層学習のワークフローのための多数の機能が提供されています。このページでは、Studio Lab 環境を Studio Classic に移行して、コンピューティング性能、ストレージ、および機能をより多く利用する方法を説明します。ただし、MLOP パイプライン全体に最適化され、事前構築された Studio Classic のコンテナに慣れておくことができます。詳細については、「Amazon SageMaker Studio Lab」を参照してください。

Studio Lab 環境を Studio Classic に移行するには、最初に Amazon SageMaker AI ドメインの概要 の手順に従って、Studio Classic にオンボードする必要があります。

ステップ 1: Studio Lab conda 環境をエクスポートする

環境を管理する」の手順に従って、conda 環境をエクスポートしたり、その環境にライブラリまたはパッケージを追加することができます。次の例は、default 環境を使って Studio Classic にエクスポートする方法を示しています。

  1. [ファイルブラウザ] パネル ( Black square icon representing a placeholder or empty image. ) を開いて Studio Lab ターミナルを開き、ファイルブラウザの上部にあるメニューでプラス (+) 記号を選択して [ランチャー] を開き、[ターミナル] を選択します。Studio Lab ターミナルから次を実行して conda 環境を一覧表示します。

    conda env list

    このコマンドを使用すると、ファイルシステム内の conda 環境とその場所のリストが出力されます。Studio Lab にオンボードするとき、studiolab conda 環境が自動的にアクティブ化されます。

    # conda environments: # default /home/studio-lab-user/.conda/envs/default studiolab * /home/studio-lab-user/.conda/envs/studiolab studiolab-safemode /opt/amazon/sagemaker/safemode-home/.conda/envs/studiolab-safemode base /opt/conda

    studiolabstudiolab-safemode、および base 環境はエクスポートしないことをお勧めします。これらの環境は、以下の理由により Studio Classic では使用できません。

    • studiolab: Studio Lab の JupyterLab 環境を設定します。Studio Lab は Studio Classic とは異なるメジャーバージョンの JupyterLab を実行することから、Studio Classic では使用できません。

    • studiolab-safemode: Studio Lab の JupyterLab 環境も設定します。Studio Lab は Studio Classic とは異なるメジャーバージョンの JupyterLab を実行することから、Studio Classic では使用できません。

    • base: この環境には conda がデフォルトで付属します。Studio Lab の base 環境と Studio Classic の base 環境では、互換性のないバージョンのパッケージが多数存在しています。

  2. Studio Classic に移行する conda 環境の場合、まず conda 環境をアクティブ化します。その後、新しいライブラリがインストールまたは削除されると、default 環境が変更されます。環境の正確な状態を取得するには、コマンドラインを使用して YAML ファイルにエクスポートします。次のコマンドラインは、デフォルト環境を YAML ファイルにエクスポートし、myenv.yml というファイルを作成します。

    conda activate default conda env export > ~/myenv.yml

ステップ 2: Studio Lab のアーティファクトを保存する

環境を YAML ファイルに保存したので、環境ファイルを任意のプラットフォームに移動できます。

Save to a local machine using Studio Lab GUI
注記

現在、ディレクトリを右クリックして Studio Lab GUI からディレクトリをダウンロードすることはできません。ディレクトリをエクスポートする場合は、[Git リポジトリに保存] タブの手順に従ってください。

1 つのオプションは、環境をローカルマシンに保存することです。これには、以下の手順を使用します。

  1. Studio Lab で、左側のメニューの [ファイルブラウザ] アイコン ( Black square icon representing a placeholder or empty image. ) を選択すると、左側に [ファイルブラウザ] パネルが表示されます。

  2. ファイル検索バーの下にあるファイルアイコンを選択して、ユーザーディレクトリに移動します。

  3. myenv.yml ファイルを選択 (右クリック) し、[ダウンロード] を選択します。Studio Classic にインポートする他のファイルについても、このプロセスを繰り返すことができます。

Save to a Git repository

もう 1 つのオプションは、環境を Git リポジトリに保存することです。例として、このオプションでは GitHub を使用します。このステップには GitHub アカウントとリポジトリが必要です。詳細については、「GitHub」を参照してください。次の手順は、Studio Lab ターミナルを使用して、コンテンツを GitHub と同期する方法を示しています。

  1. Studio Lab ターミナルからユーザーディレクトリに移動し、エクスポートするファイルを格納する新しいディレクトリを作成します。

    cd ~ mkdir <NEW_DIRECTORY_NAME>
  2. 新しいディレクトリを作成した後、<NEW_DIRECTORY_NAME> にエクスポートするファイルまたはディレクトリをコピーします。

    次のコード形式を使用してファイルをコピーします。

    cp <FILE_NAME> <NEW_DIRECTORY_NAME>

    例えば、<FILE_NAME>myenv.yml に置き換えます。

    次のコード形式を使用してディレクトリをコピーします。

    cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>

    例えば、<DIRECTORY_NAME> をユーザーディレクトリ内の任意のディレクトリ名に置き換えます。

  3. 次のコマンドを使用して、新しいディレクトリに移動し、Git リポジトリとしてディレクトリを初期化します。詳細については、「git-init ドキュメント」を参照してください。

    cd <NEW_DIRECTORY_NAME> git init
  4. Git を使用して関連するファイルをすべて追加し、変更をコミットします。

    git add . git commit -m "<COMMIT_MESSAGE>"

    例えば、<COMMIT_MESSAGE>Add Amazon SageMaker Studio Lab artifacts to GitHub repository to migrate to Amazon SageMaker Studio Classic に置き換えます。

  5. コミットをリモートリポジトリにプッシュします。このリポジトリの形式は https://github.com/<GITHUB_USERNAME>/ <REPOSITORY_NAME>.git です。<GITHUB_USERNAME> は GitHub ユーザー名、<REPOSITORY_NAME> はリモートリポジトリ名になります。ブランチ <BRANCH_NAME> を作成して、コンテンツを GitHub リポジトリにプッシュします。

    git branch -M <BRANCH_NAME> git remote add origin https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git git push -u origin <BRANCH_NAME>

ステップ 3: Studio Lab アーティファクトを Studio Classic にインポートする

次の手順は、Studio Classic にアーティファクトをインポートする方法を示します。コンソールで Feature Store を使用する手順は、デフォルトのエクスペリエンスとして Studio と Studio Classic のどちらを有効にしているかどうかによって異なります。コンソールから Studio Classic にアクセスする方法については、「Studio がデフォルトのエクスペリエンスである場合に Studio Classic を起動する」を参照してください。

Studio Classic から、ローカルマシンまたは Git リポジトリからファイルをインポートできます。これを行うには、Studio Classic GUI またはターミナルを使用します。次の手順では、ステップ 2: Studio Lab のアーティファクトを保存する の例を使用しています。

Import using the Studio Classic GUI

ファイルをローカルマシンに保存した場合、次の手順を使用してファイルを Studio Classic にインポートできます。

  1. Studio Classic の左上にある [ファイルブラウザ] ( Black square icon representing a placeholder or empty image. ) パネルを開きます。

  2. [ファイルブラウザ] パネルの上部にあるメニューで、[ファイルをアップロード] アイコン ( Black square icon representing a placeholder or empty image. ) を選択します。

  3. インポートするファイルに移動し、[開く]を選択します。

注記

Studio Classic にディレクトリをインポートするには、最初にローカルマシンのディレクトリをファイルに圧縮します。Mac では、ディレクトリを右クリックして [“<DIRECTORY_NAME>”を圧縮] を選択します。Windows では、ディレクトリを右クリックして [送る] を選択し、[圧縮 (zip 形式) フォルダ] を選択します。ディレクトリを圧縮した後、前述のステップに従って圧縮ファイルをインポートします。Studio Classic ターミナルに移動し、コマンド <DIRECTORY_NAME>.zip を実行して、圧縮されたファイルを解凍します。

Import using a Git repository

この例では、Studio Classic に GitHub リポジトリのクローンを作成する方法について 2 つのオプションを提供します。Studio Classic の左側にある [Git] ( Black square icon representing a placeholder or empty image. ) タブを選択して、Studio Classic GUI を使用することができます。[リポジトリのクローンを作成する] を選択し、ステップ 2: Studio Lab のアーティファクトを保存する から GitHub リポジトリの URL を貼り付けます。もう 1 つのオプションは、次の手順に従って Studio Classic ターミナルを使用することです。

  1. Studio Classic [ランチャー] を開きます。[ランチャー] を開く方法の詳細については、「Amazon SageMaker Studio Classic Launcher」を参照してください。

  2. [ランチャー][ノートブックとコンピューティングリソース] セクションで、[環境の変更] を選択します。

  3. Studio Classic で、[ランチャー] を開きます。Studio Classic の左上隅にある [Amazon SageMaker Studio Classic] を選択して、[ランチャー] を開きます。

    [ランチャー] を開くすべての方法については、「Amazon SageMaker Studio Classic Launcher を使用する」を参照してください。

  4. [環境の変更] ダイアログで、[イメージ] ドロップダウンリストを使用して [データサイエンス] イメージを選択し、[選択] を選択します。このイメージには Conda がプリインストールされています。

  5. Studio Classic [ランチャー] で、[イメージターミナルを開く] を選択します。

  6. イメージターミナルで次のコマンドを実行して、リポジトリのクローンを作成します。このコマンドにより、Studio Classic インスタンスに <REPOSITORY_NAME> という名前のディレクトリが作成され、そのレポジトリのアーティファクトのクローンが作成されます。

    git clone https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git

ステップ 4: Studio Classic に Studio Lab conda 環境をインストールする

Studio Classic インスタンスの YAML ファイルを使用して conda 環境を再作成できるようになりました。Studio Classic [ランチャー] を開きます。[ランチャー] を開く方法の詳細については、「Amazon SageMaker Studio Classic Launcher」を参照してください。[ランチャー] から [イメージターミナルを開く] を選択します。ターミナルで、YAML ファイルが含まれているディレクトリに移動し、次のコマンドを実行します。

conda env create --file <ENVIRONMENT_NAME>.yml conda activate <ENVIRONMENT_NAME>

これらのコマンドが完了したら、Studio Classic ノートブックインスタンスのカーネルとして環境を選択できるようになります。使用可能な環境を表示するには、conda env list を実行します。環境をアクティブ化するには、conda activate <ENVIRONMENT_NAME> を実行します。