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. [ファイルブラウザ] パネル ( ) を開いて 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> はリモートリポジトリ名になります。ブランチ <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 の左上にある [ファイルブラウザ] ( ) パネルを開きます。

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

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] ( ) タブを選択して、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 ランチャーを使用する」を参照してください。

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> を実行します。