本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將基於 Git 的儲存庫連結到 EMR Studio 工作區
<a name="emr-studio-git-repo"></a>

將最多三個 Git 儲存庫與 Amazon EMR Studio 工作區建立關聯，以儲存和共用筆記本檔案。

## 關於適用於 EMR Studio 的 Git 儲存庫
<a name="emr-studio-git-repo-about"></a>

最多可以將三個 Git 儲存庫與 EMR Studio 工作區建立關聯。根據預設，每個工作區可讓您從與 Studio 相同 AWS 帳戶相關聯的 Git 儲存庫清單中選擇。也可以建立新的 Git 儲存庫作為工作區的資源。

可以在連接到叢集的主節點時，使用終端命令執行如下的 Git 命令。

```
!git pull origin <branch-name>
```

或者，可以使用 jupyterlab-git 擴充功能。透過選擇 **Git** 圖示，從左側邊欄中開啟它。如需 JupyterLab 之 jupyterlab-git 擴充功能的資訊，請參閱 [jupyterlab-git](https://github.com/jupyterlab/jupyterlab-git)。

## 先決條件
<a name="emr-studio-git-prereqs"></a>
+ 若要將 Git 儲存庫與工作區建立關聯，必須將 Studio 設定為允許 Git 儲存庫連結。Studio 管理員應採取步驟以 [建立 Git 儲存庫的存取權和許可](emr-studio-enable-git.md)。
+ 如果使用 CodeCommit 儲存庫，則必須使用 Git 憑證與 HTTPS。不支援具有 AWS Command Line Interface 登入資料協助程式的 SSH 金鑰和 HTTPS。CodeCommit 也不支援個人存取字符 (PAT)。如需詳細資訊，請參閱《IAM 使用者指南》**中的[搭配使用 IAM 與 CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html)和《AWS CodeCommit 使用者指南》**中的[使用 Git 憑證設定 HTTPS 使用者](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)。

## 指示
<a name="emr-studio-link-git-repo"></a>

**將關聯的 Git 儲存庫連結至工作區**

1. 從 Studio 中的**工作區**清單中開啟要連結至儲存庫的工作區。

1. 在左側邊欄中，選擇 **Amazon EMR Git 儲存庫**圖示，以開啟 **Git 儲存庫**工具面板。

1. 在 **Git 儲存庫**下，展開下拉式清單，並選取最多三個儲存庫以連結至工作區。EMR Studio 會註冊您的選取項，並開始連結每個儲存庫。

完成連結程序可能需要一點時間。可以在 **Git 儲存庫**工具面板中查看所選取的每個儲存庫的狀態。EMR Studio 將儲存庫連結至工作區之後，您應該會看到屬於該儲存庫的檔案會出現在**檔案瀏覽器**面板中。

**若要將新的 Git 儲存庫作為資源新增至工作區**

1. 從 Studio 中的工作區清單中開啟要連結至儲存庫的工作區。

1. 在左側邊欄中，選擇 **Amazon EMR Git 儲存庫**圖示，以開啟 **Git 儲存庫**工具面板。

1. 選擇**新增新的 Git 儲存庫**。

1. 針對**儲存庫名稱**，在 EMR Studio 中輸入儲存庫的描述性名稱。名稱僅可含有英數字元、連字號或底線。

1. 針對 **Git repository URL (Git 儲存庫 URL)**，輸入儲存庫的 URL。使用 CodeCommit 儲存庫時，這是當您依序選擇**複製 URL** 和**複製 HTTPS** 時所複製的 URL。例如 `https://git-codecommit.us-west-2.amazonaws.com/v1/repos/[MyCodeCommitRepoName]`。

1. 針對**分支**，輸入要簽出的現有分支的名稱。

1. 針對 Git 憑證，請根據下列指導方針選擇選項。EMR Studio 會使用儲存在 Secrets Manager 中的密碼來存取 Git 憑證。
**注意**  
如果您使用 GitHub 儲存庫，建議使用個人存取字符 (PAT) 進行驗證。自 2021 年 8 月 13 日起，GitHub 在驗證 Git 操作時將要求基於字符的身分驗證，並不再接受密碼。如需詳細資訊，請參閱「GitHub 部落格」**中的[ Git 操作的字符驗證要求](https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/)。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/emr/latest/ManagementGuide/emr-studio-git-repo.html)

1. 選擇**新增儲存庫**以建立新的儲存庫。EMR Studio 建立新儲存庫後，您將看到成功訊息。新儲存庫顯示在 **Git 儲存庫**下的下拉式清單中。

1. 若要將新儲存庫連結至您的工作區，請從 **Git 儲存庫**下的下拉式清單中選擇它。

完成連結程序可能需要一點時間。EMR Studio 將新儲存庫連結至工作區之後，您應該會看到與儲存庫名稱相同的新資料夾出現在**檔案瀏覽器**面板中。

若要開啟其他連結儲存庫，請在**檔案瀏覽器**中導覽至其資料夾。