本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon SageMaker Studio 实验室中使用外部资源
<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 示例笔记本](https://github.com/aws/studio-lab-examples#sagemaker-studio-lab-sample-notebooks)。

此存储库为以下使用案例和其他使用案例提供笔记本。
+ 计算机视觉
+ 正在连接到 AWS
+ 创建自定义环境
+ 地理空间数据分析
+ 自然语言处理
+ 使用 R

### 克隆存储 GitHub 库
<a name="studio-lab-use-external-clone-repo"></a>

要将 GitHub 存储库克隆到您的 Studio Lab 项目，请按照以下步骤操作。

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/zh_cn/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/zh_cn/sagemaker/latest/dg/images/studio/icons/git.png))，打开一个新的下拉菜单。

1. 选择**克隆存储库**。

1. 将存储库的 URL 粘贴到 **Git 存储库 URL (.git)** 下。

1. 选择**克隆**。

### 从中克隆单个笔记本 GitHub
<a name="studio-lab-use-external-clone-individual"></a>

要在 Studio Lab 中打开笔记本，您必须有权访问该笔记本所在的存储库。以下示例描述了 Studio Lab 在各种情况下与权限相关的行为。
+ 如果存储库是公有的，您可以从 Studio Lab 预览页面自动将笔记本克隆到项目中。
+ 如果存储库是私有的，则系统会提示您 GitHub 从 Studio Lab 预览页面登录。如果您有权访问私有存储库，则可以将笔记本克隆到项目中。
+ 如果您无权访问私有存储库，则无法从 Studio Lab 预览页面克隆笔记本。

以下各节显示了在 Studio Lab 项目中复制 GitHub 笔记本的两个选项。这些选项取决于笔记本是否有**在 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？** 对话框中，选择 “**仅复制笔记本**”。这会将笔记本文件复制到项目中。

#### 选项 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？** 对话框中，选择 “**仅复制笔记本**”，将笔记本文件复制到您的项目中。

## 在笔记本中添加**在 Studio Lab 中打开**按钮
<a name="studio-lab-use-external-add-button"></a>

将**在 Studio Lab 中打开**按钮添加到笔记本后，其他人就可以将您的笔记本或存储库直接克隆到他们的 Studio Lab 项目中。如果您在公共 GitHub 存储库中共享笔记本，则您的内容将是公开可读的。请勿在笔记本中共享私密内容，例如 AWS 访问密钥或 AWS Identity and Access Management 凭据。

要将**在 Studio Lab 中打开**功能按钮添加到您的 Jupyter 笔记本或存储库，请在笔记本或存储库顶部添加以下标记。

```
[![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. 打开**文件浏览器**面板。

1. 在**文件浏览器**面板的操作栏中，选择**上传文件**按钮。

1. 选择要从本地电脑上传的文件。

1. 选择**打开**。



或者，您可以将文件从电脑拖放到**文件浏览器**面板。

## 连接到 Amazon S3
<a name="studio-lab-use-external-s3"></a>

 AWS CLI 允许 AWS 集成到您的 Studio Lab 项目中。通过这种集成，您可以从 Amazon S3 中提取资源以与 Jupyter 笔记本一起使用。

要 AWS CLI 与 Studio Lab 配合使用，请完成以下步骤。有关概述此集成的笔记本，请参阅将 [Studio Lab 与 AWS 资源一起使用](https://github.com/aws/studio-lab-examples/blob/main/connect-to-aws/Access_AWS_from_Studio_Lab.ipynb)。

1.  AWS CLI 按照[安装或更新最新版本中的步骤进行](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)安装 AWS CLI。

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
   ```