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

# Amazon SageMaker Studio Lab で外部リソースを使用する
<a name="studio-lab-use-external"></a>

Amazon SageMaker Studio Lab を使用すると、Git リポジトリや Amazon S3 から Jupyter ノートブックやデータなどの外部リソースを統合できます。GitHub リポジトリやノートブックに **[Studio Lab で開く]** ボタンを追加することもできます。このボタンを使用すると、Studio Lab から直接ノートブックのクローンを作成できます。

次のトピックでは、外部リソースの統合方法を説明します。

**Topics**
+ [

## GitHub リソースを使用する
](#studio-lab-use-external-clone-github)
+ [

## ノートブックに **[Studio Lab で開く]** ボタンを追加する
](#studio-lab-use-external-add-button)
+ [

## コンピュータからファイルをインポートする
](#studio-lab-use-external-import)
+ [

## Amazon S3 に接続する
](#studio-lab-use-external-s3)

## GitHub リソースを使用する
<a name="studio-lab-use-external-clone-github"></a>

Studio Lab は GitHub との統合が可能です。この統合を使用すれば、ノートブックとリポジトリのクローンを Studio Lab プロジェクトに直接作成できます。

次のトピックでは、Studio Lab での GitHub リソースの使用方法について説明します。

### Studio Lab サンプルノートブック
<a name="studio-lab-use-external-clone-examples"></a>

Studio Lab 用にカスタマイズされたサンプルノートブックのリポジトリの使用を開始するには、「[Studio Lab Sample Notebooks](https://github.com/aws/studio-lab-examples#sagemaker-studio-lab-sample-notebooks)」を参照してください。

このリポジトリには、以下のようなユースケース用のノートブックが用意されています。
+ コンピュータビジョン
+ への接続 AWS
+ カスタム環境を作成する
+ 地理空間データの分析
+ 自然言語処理
+ R を使用する

### GitHub リポジトリのクローンを作成する
<a name="studio-lab-use-external-clone-repo"></a>

Studio Lab プロジェクトに GitHub リポジトリのクローンを作成する場合は、次の手順を実行します。

1. Studio Lab プロジェクトのランタイムを開始します。Studio Lab プロジェクトランタイムの起動についての詳細は、「[プロジェクトランタイムを開始する](studio-lab-manage-runtime.md#studio-lab-manage-runtime-start)」を参照してください。

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. 左側のメニューから **[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)) を選択し、新しいドロップダウンメニューを開きます。

1. **[リポジトリのクローンを作成]** を選択します。

1. リポジトリの URL を **[Git リポジトリ URL (.git)]** の下に貼り付けます。

1. **[Clone]** (クローン) を選択します。

### GitHub から個々のノートブックのクローンを作成する
<a name="studio-lab-use-external-clone-individual"></a>

Studio Lab でノートブックを開くには、ノートブックが入っているリポジトリへのアクセス権が必要です。次のサンプルでは、さまざまな状況における Studio Lab のアクセス許可に関連する動作について説明します。
+ リポジトリがパブリックの場合、Studio Lab のプレビューページからプロジェクトにノートブックのクローンを自動的に作成できます。
+ リポジトリがプライベートの場合、Studio Lab のプレビューページで GitHub にサインインするように求められます。プライベートリポジトリへのアクセス権を持っていれば、プロジェクトにノートブックのクローンを作成できます。
+ プライベートリポジトリにアクセスできない場合は、Studio Lab のプレビューページからノートブックのクローンを作成できません。

次のセクションでは、Studio Lab プロジェクトで GitHub ノートブックをコピーするための 2 つのオプションについて説明します。これらのオプションは、ノートブックに **[Studio Lab で開く]** ボタンがあるかどうかによって異なります。

#### オプション 1: **[Studio Lab で開く]** ボタンを使用してノートブックをコピーする
<a name="studio-lab-use-external-clone-individual-button"></a>

次の手順は、**[Studio Lab で開く]** ボタンがあるノートブックをコピーする方法を示します。このボタンをノートブックに追加する場合は、「[ノートブックに **[Studio Lab で開く]** ボタンを追加する](#studio-lab-use-external-add-button)」を参照してください。

1. 「[Studio Lab にサインインします。](studio-lab-onboard.md#studio-lab-onboard-signin)」の手順に従って Studio Lab にサインインします。

1. 新しいブラウザタブで、クローンを作成する GitHub ノートブックに移動します。

1. ノートブックで、**[Studio Lab で開く]** ボタンを選択すると、Studio Lab で新しいページが開き、ノートブックのプレビューが表示されます。

1. プロジェクトランタイムがまだ実行されていない場合は、プレビューページの上部の **[ランタイムを開始]** ボタンをクリックします。ランタイムが開始されるまで待ってから次の手順に進みます。

1. プロジェクトランタイムが開始したら、**[プロジェクトにコピー]** を選択し、プロジェクトランタイムを新しいブラウザタブで開きます。

1. **[Copy from GitHub?]** (GitHub からコピーしますか) ダイアログボックスで、**[Copy notebook only]** (ノートブックのみをコピー) を選択します。ノートブックファイルがプロジェクトにコピーされます。

#### オプション 2: GitHub ノートブックのクローンを作成する
<a name="studio-lab-use-external-clone-individual-general"></a>

次の手順は、GitHub からノートブックをコピーする方法です。

1. GitHub のノートブックに移動します。

1. ブラウザのアドレスバーで、ノートブックの URL を以下のように変更します。

   ```
   # Original URL
   https://github.com/<PATH_TO_NOTEBOOK>
   
   # Modified URL 
   https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>
   ```

1. 変更された URL に移動します。Studio Lab でノートブックのプレビューが開きます。

1. プロジェクトランタイムがまだ実行されていない場合は、プレビューページの上部の **[ランタイムを開始]** ボタンをクリックします。ランタイムが開始されるまで待ってから次の手順に進みます。

1. プロジェクトランタイムが開始したら、**[プロジェクトにコピー]** を選択し、プロジェクトランタイムを新しいブラウザタブで開きます。

1. **[Copy from GitHub?]** (GitHub からコピーしますか?) ダイアログボックスで、**[Copy notebook only]** (ノートブックのみコピー) を選択し、ノートブックファイルをプロジェクトにコピーします。

## ノートブックに **[Studio Lab で開く]** ボタンを追加する
<a name="studio-lab-use-external-add-button"></a>

ノートブックに **[Studio Lab で開く]** ボタンを追加すると、他のユーザーが自分の Studio Lab プロジェクトにノートブックやリポジトリのクローンを直接作成できるようになります。パブリックな GitHub リポジトリでノートブックを共有すると、コンテンツは誰もが読み取れるようになります。アクセス AWS キーや AWS Identity and Access Management 認証情報などのプライベートコンテンツをノートブックで共有しないでください。

Jupyter ノートブックまたはリポジトリに **[Studio Lab で開く]** 機能ボタンを追加するには、ノートブックまたはリポジトリの上部に次のマークダウンを追加します。

```
[![Open In SageMaker Studio Lab](https://studiolab.sagemaker.aws/studiolab.svg)](https://studiolab.sagemaker.aws/import/github/<PATH_TO_YOUR_NOTEBOOK_ON_GITHUB>)
```

## コンピュータからファイルをインポートする
<a name="studio-lab-use-external-import"></a>

以下の手順は、Studio Lab プロジェクトにコンピュータからファイルをインポートする方法を示しています。  

1. Studio Lab プロジェクトランタイムを開きます。

1. **[File Browser]** (ファイルブラウザ) パネルを開きます。

1. **[File Browser]** (ファイルブラウザ) パネルのアクションバーで、**[Upload Files]** (ファイルをアップロード) ボタンを選択します。

1. アップロードするファイルをローカルマシンから選択します。

1. **[Open]** (開く) を選択します。



コンピュータから **[File Browser]** (ファイルブラウザ) パネルにファイルをドラッグアンドドロップすることもできます。

## Amazon S3 に接続する
<a name="studio-lab-use-external-s3"></a>

は、Studio Lab プロジェクトで AWS の統合 AWS CLI を有効にします。この統合を使用すると、Amazon S3 からリソースを取得して Jupyter ノートブックで使用できます。

Studio Lab AWS CLI で を使用するには、次の手順を実行します。この統合の概要を示すノートブックについては、「 [AWS リソースでの Studio Lab ](https://github.com/aws/studio-lab-examples/blob/main/connect-to-aws/Access_AWS_from_Studio_Lab.ipynb)の使用」を参照してください。

1.  AWS CLI 「 の最新バージョンをインストールまたは更新する」の手順 をインストールします。 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)

1. [クイックセットアップ](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html)の手順に従って AWS  認証情報を設定します。 AWS アカウントのロールには、データをコピーする Amazon S3 バケットにアクセスするためのアクセス許可が必要です。

1. Jupyter ノートブックから、必要に応じて Amazon S3 バケットのリソースのクローンを作成します。次のコマンドは、Amazon S3 パスからプロジェクトにすべてのリソースのクローンを作成する方法を示しています。詳細については、『[AWS CLI コマンドリファレンス](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html)』を参照してください。

   ```
   !aws s3 cp s3://<BUCKET_NAME>/<PATH_TO_RESOURCES>/ <PROJECT_DESTINATION_PATH>/ --recursive
   ```