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 に移行するには、まず「」の手順に従って Studio Classic にオンボードする必要がありますAmazon SageMaker ンドメインの概要。

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

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

1. [ファイルブラウザ] ( ) パネルを開いて 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

   studiolab、studiolab-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 の左側のメニューで [ファイルブラウザ] ( ) アイコンを選択すると、左側に [ファイルブラウザ] パネルが表示されます。

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>はリモートリポジトリ名です。コンテンツを GitHub リポジトリ<BRANCH_NAME>にプッシュするブランチを作成します。

   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 クラシックを起動します。。

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

Import using the Studio Classic GUI

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

1. Studio Classic の左上にあるファイルブラウザ ( ) パネルを開きます。

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

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

注記

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

Import using a Git repository

この例では、 GitHub リポジトリのクローンを Studio Classic に作成するための 2 つのオプションを示します。Studio Classic GUI を使用するには、Studio Classic の左側にある Git ( ) タブを選択します。リポジトリ のクローンを作成し、 から GitHub リポジトリ URL を貼り付けますステップ 2: Studio Lab のアーティファクトを保存する。もう 1 つのオプションは、次の手順を使用して Studio Classic ターミナルを使用することです。

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

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

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

   [ランチャー] を開くすべての方法については、「Amazon SageMaker スタジオクラシックランチャーを使用する」を参照してください。

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

5. Studio Classic Launcher で、イメージターミナルを開くを選択します。

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 Launcher を開きます。Launcher を開く方法の詳細については、「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> を実行します。