Amazon SageMaker Studio Lab で外部リソースを使用する - Amazon SageMaker

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

Amazon SageMaker Studio Lab で外部リソースを使用する

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

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

GitHub リソースを使用する

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

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

Studio Lab サンプルノートブック

Studio Lab 用にカスタマイズされたサンプルノートブックのリポジトリの使用を開始するには、「Studio Lab Sample Notebooks」を参照してください。

このリポジトリには、以下のようなユースケース用のノートブックが用意されています。

  • コンピュータビジョン

  • への接続 AWS

  • カスタム環境を作成する

  • 地理空間データの分析

  • 自然言語処理

  • R を使用する

GitHub リポジトリのクローンを作成する

Studio Lab プロジェクトに GitHub リポジトリのクローンを作成するには、次の手順に従います。

  1. Studio Lab プロジェクトのランタイムを開始します。Studio Lab プロジェクトランタイムの起動についての詳細は、「プロジェクトランタイムを開始する」を参照してください。

  2. Studio Lab で、左側のメニューの [ファイルブラウザ] アイコン ( Black square icon representing a placeholder or empty image. ) を選択すると、左側に [ファイルブラウザ] パネルが表示されます。

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

  4. 左側のメニューから [Git] アイコン ( Black square icon representing a placeholder or empty image. ) を選択し、新しいドロップダウンメニューを開きます。

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

  6. リポジトリの を Git リポジトリ URL (.git) URLに貼り付けます。

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

から個々のノートブックのクローンを作成する GitHub

Studio Lab でノートブックを開くには、ノートブックが入っているリポジトリへのアクセス権が必要です。次のサンプルでは、さまざまな状況における Studio Lab のアクセス許可に関連する動作について説明します。

  • リポジトリがパブリックの場合、Studio Lab のプレビューページからプロジェクトにノートブックのクローンを自動的に作成できます。

  • リポジトリがプライベートの場合は、Studio Lab のプレビューページ GitHub から にサインインするように求められます。プライベートリポジトリへのアクセス権を持っていれば、プロジェクトにノートブックのクローンを作成できます。

  • プライベートリポジトリにアクセスできない場合は、Studio Lab のプレビューページからノートブックのクローンを作成できません。

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

オプション 1: [Studio Lab で開く] ボタンを使用してノートブックをコピーする

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

  1. Studio Lab にサインインします。」の手順に従って Studio Lab にサインインします。

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

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

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

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

  6. GitHub「? からコピー」ダイアログボックスで、「ノートブックのみをコピー」を選択します。ノートブックファイルがプロジェクトにコピーされます。

オプション 2: GitHub ノートブックのクローンを作成する

次の手順は、 からノートブックをコピーする方法を示しています GitHub。

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

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

    # Original URL https://github.com/<PATH_TO_NOTEBOOK> # Modified URL  https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>
  3. 変更された に移動しますURL。Studio Lab でノートブックのプレビューが開きます。

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

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

  6. GitHub「? からコピー」ダイアログボックスで、ノートブックをコピーする を選択して、ノートブックファイルをプロジェクトにコピーします。

ノートブックに [Studio Lab で開く] ボタンを追加する

ノートブックに [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>)

コンピュータからファイルをインポートする

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

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

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

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

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

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

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

Amazon S3 に接続する

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

Studio Lab AWS CLI で を使用するには、次のステップを実行します。この統合の概要を示すノートブックについては、AWS 「 リソースでの Studio Lab の使用」を参照してください。

  1. AWS CLI 「 の最新バージョンをインストールまたは更新する」の手順を実行します AWS CLI

  2. 「クイックセットアップ」の手順に従って AWS 認証情報を設定します。 AWS アカウントのロールには、データをコピーする Amazon S3 バケットへのアクセス許可が必要です。

  3. Jupyter ノートブックから、必要に応じて Amazon S3 バケットのリソースのクローンを作成します。次のコマンドは、Amazon S3 パスからプロジェクトにすべてのリソースのクローンを作成する方法を示しています。詳細については、『AWS CLI コマンドリファレンス』を参照してください。

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