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

注記

ディレクトリを右クリックGUIして Studio Lab からディレクトリをダウンロードすることは、現在使用できません。ディレクトリをエクスポートする場合は、[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 で、ディレクトリを右クリックして に送信を選択し、圧縮 (圧縮) フォルダ を選択します。ディレクトリを圧縮した後、前述のステップに従って圧縮ファイルをインポートします。Studio Classic ターミナルに移動し、 コマンドを実行して、圧縮ファイルを解凍します<DIRECTORY_NAME>.zip。

Import using a Git repository

この例では、Studio Classic に GitHub リポジトリをクローンする方法として 2 つのオプションを提供します。Studio Classic の左側にある Git ( ) タブGUIを選択すると、Studio Classic を使用できます。リポジトリのクローン を選択し、 URLから GitHub リポジトリを貼り付けますステップ 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 Studio Classic Launcher を使用する」を参照してください。

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

5. Studio Classic Launcher で、Open image terminal を選択します。

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