

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

# Amazon SageMaker Studio Lab 環境を Amazon SageMaker Studio Classic にエクスポートする
<a name="studio-lab-use-migrate"></a>

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

Studio Lab 環境を Studio Classic に移行するには、最初に [Amazon SageMaker AI ドメインの概要](gs-studio-onboard.md) の手順に従って、Studio Classic にオンボードする必要があります。

**Topics**
+ [ステップ 1: Studio Lab conda 環境をエクスポートする](#studio-lab-use-migrate-step1)
+ [ステップ 2: Studio Lab のアーティファクトを保存する](#studio-lab-use-migrate-step2)
+ [ステップ 3: Studio Lab アーティファクトを Studio Classic にインポートする](#studio-lab-use-migrate-step3)
+ [ステップ 4: Studio Classic に Studio Lab conda 環境をインストールする](#studio-lab-use-migrate-step4)

## ステップ 1: Studio Lab conda 環境をエクスポートする
<a name="studio-lab-use-migrate-step1"></a>

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

1. **[ファイルブラウザ]** パネル (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/icons/folder.png)) を開いて Studio Lab ターミナルを開き、ファイルブラウザの上部にあるメニューでプラス (**\$1**) 記号を選択して **[ランチャー]** を開き、**[ターミナル]** を選択します。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` 環境では、互換性のないバージョンのパッケージが多数存在しています。

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

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

## ステップ 2: Studio Lab のアーティファクトを保存する
<a name="studio-lab-use-migrate-step2"></a>

環境を 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.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/icons/folder.png)) を選択すると、左側に **[ファイルブラウザ]** パネルが表示されます。

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

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

------
#### [ Save to a Git repository ]

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

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

   ```
   cd ~
   mkdir <NEW_DIRECTORY_NAME>
   ```

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

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

   ```
   cp <FILE_NAME> <NEW_DIRECTORY_NAME>
   ```

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

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

   ```
   cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>
   ```

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

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

   ```
   cd <NEW_DIRECTORY_NAME>
   git init
   ```

1. 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 ` に置き換えます。

1. コミットをリモートリポジトリにプッシュします。このリポジトリの形式は `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 にインポートする
<a name="studio-lab-use-migrate-step3"></a>

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

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

------
#### [ Import using the Studio Classic GUI ]

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

1. Studio Classic の左上にある **[ファイルブラウザ]** (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/icons/folder.png)) パネルを開きます。

1. **[ファイルブラウザ]** パネルの上部にあるメニューで、**[ファイルをアップロード]** アイコン (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/icons/File_upload_squid.png)) を選択します。

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

**注記**  
Studio Classic にディレクトリをインポートするには、最初にローカルマシンのディレクトリをファイルに圧縮します。Mac では、ディレクトリを右クリックして **[“*<DIRECTORY\$1NAME>*”を圧縮]** を選択します。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.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/icons/git.png)) タブを選択して、Studio Classic GUI を使用することができます。**[リポジトリのクローンを作成する]** を選択し、[ステップ 2: Studio Lab のアーティファクトを保存する](#studio-lab-use-migrate-step2) から GitHub リポジトリの URL を貼り付けます。もう 1 つのオプションは、次の手順に従って Studio Classic ターミナルを使用することです。

1. Studio Classic **[ランチャー]** を開きます。**[ランチャー]** を開く方法の詳細については、「[Amazon SageMaker Studio Classic Launcher](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-launcher.html)」を参照してください。

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

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

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

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

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

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

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

------

## ステップ 4: Studio Classic に Studio Lab conda 環境をインストールする
<a name="studio-lab-use-migrate-step4"></a>

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

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

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

