Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案
<a name="extensions-link"></a>

您必須先將儲存庫或專案所屬的第三方來源與 CodeCatalyst 空間連線，才能使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，或管理 Jira 專案。如需詳細資訊，請參閱[連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst](extensions-connect.md)。

您可以在工作流程中使用連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，其中連結儲存庫中的事件會啟動可能建置、測試或部署程式碼的工作流程，視工作流程組態而定。使用連結 GitHub 或 Bitbucket 儲存庫之工作流程的工作流程組態檔案會存放在連結的儲存庫中。連結的儲存庫也可以與開發環境搭配使用，以在連結的儲存庫中建立、更新和刪除檔案。您可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至 CodeCatalyst 專案，從 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**延伸的詳細資訊頁面，或從專案本身**程式碼**中的**來源儲存庫**檢視。

**重要**  
雖然您可以將 GitHub 或 Bitbucket 儲存庫連結為**貢獻者**，但您只能將第三方儲存庫取消連結為**空間管理員**或**專案管理員**。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。

**重要**  
安裝儲存庫延伸模組後，您連結至 CodeCatalyst 的任何儲存庫都會將其程式碼編製索引並儲存在 CodeCatalyst 中。這可讓程式碼在 CodeCatalyst 中搜尋。若要在 CodeCatalyst 中使用連結儲存庫時進一步了解程式碼的資料保護，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[資料保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。

**重要**  
CodeCatalyst 不支援偵測連結儲存庫的預設分支中的變更。若要變更連結儲存庫的預設分支，您必須先將其從 CodeCatalyst 取消連結、變更預設分支，然後再次連結。  
最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的擴充功能。

您可以使用連結的 Jira 專案來管理問題，並將 CodeCatalyst 提取請求連結至 Jira 問題。提取請求的摘要狀態和相關聯的 CodeCatalyst 工作流程事件狀態會反映在您的 Jira 問題中。

**重要**  
若要將您的 Jira 專案連結至 CodeCatalyst 專案，您必須是 CodeCatalyst **Space 管理員**或 CodeCatalyst **專案管理員**。

**注意**  
GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫只能連結到空間中的一個 CodeCatalyst 專案。
您無法搭配 CodeCatalyst 專案使用空的或封存的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫。
您無法連結與 CodeCatalyst 專案中儲存庫同名的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 儲存庫。
**GitHub 儲存庫**擴充功能與 GitHub Enterprise Server 儲存庫不相容。
**Bitbucket 儲存庫**擴充功能與 Bitbucket 資料中心儲存庫不相容。
**GitLab 儲存庫**延伸與 GitLab 自我管理專案儲存庫不相容。
您無法**針對我使用寫入描述**，也無法透過連結的儲存庫**來摘要評論**功能。這些功能僅適用於 CodeCatalyst 中的提取請求。
CodeCatalyst 專案只能連結到一個 Jira 專案。Jira 專案可以連結至多個 CodeCatalyst 專案。

**Topics**
+ [從連線的第三方供應商連結資源](#extensions-link-resources)
+ [在 CodeCatalyst 專案建立期間將第三方儲存庫連結至](#extensions-link-repositories-creation)

## 從連線的第三方供應商連結資源
<a name="extensions-link-resources"></a>

**從延伸詳細資訊頁面將 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫或 Jira 專案連結至 CodeCatalyst 專案**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 導覽至 CodeCatalyst 空間。

1. 執行下列其中一項操作，以檢視空間中已安裝擴充功能的清單：

   1. 選擇**設定**，然後選擇**已安裝的擴充**功能。

   1. 選擇頂端選單![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_tw/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)中的**目錄**圖示。

1. 針對下列其中一個擴充功能選擇**設定**：**GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira 軟體**。

1. 根據您選擇設定的第三方延伸模組，執行下列其中一項操作：
   + **GitHub 儲存庫**：連結 GitHub 儲存庫。

     1. 在**連結的 GitHub 儲存庫**索引標籤中，選擇**連結 GitHub 儲存庫**。

     1. 從 **GitHub 帳戶**下拉式清單中，選擇包含您要連結之儲存庫的 GitHub 帳戶。

     1. 從 **GitHub 儲存庫**下拉式清單中，選擇您要連結至 CodeCatalyst 專案的儲存庫。
**提示**  
如果儲存庫的名稱呈現灰色，則您無法連結該儲存庫，因為它已連結至空間中的另一個專案。

     1. （選用） 如果您在儲存庫清單中看不到 GitHub 儲存庫，則可能尚未在 GitHub 的 Amazon CodeCatalyst 應用程式中設定儲存庫存取。您可以設定哪些 GitHub 儲存庫可在連線帳戶中的 CodeCatalyst 中使用。

        1. 導覽至您的 [GitHub](https://github.com/) 帳戶，選擇**設定**，然後選擇**應用程式**。

        1. 在**已安裝的 GitHub 應用程式**索引標籤中，選擇**設定** Amazon CodeCatalyst 應用程式。

        1. 執行下列其中一項操作來設定您要在 CodeCatalyst 中連結的 GitHub 儲存庫存取權：
           + 若要提供所有目前和未來儲存庫的存取權，請選擇**所有儲存庫**。
           + 若要提供特定儲存庫的存取權，請選擇**僅選取儲存庫**，選擇**選取儲存庫**下拉式清單，然後選擇您要允許 在 CodeCatalyst 中連結的儲存庫。

     1. 從 **CodeCatalyst 專案**下拉式功能表中，選擇您要連結 GitHub 儲存庫的 CodeCatalyst 專案。

     1. 選擇 **Link (連結)**。

     如果您不想再使用 CodeCatalyst 中的 GitHub 儲存庫，您可以取消它與 CodeCatalyst 專案的連結。當儲存庫取消連結時，該儲存庫中的事件將不會啟動工作流程執行，而且您將無法將該儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
   + **Bitbucket 儲存庫**：連結 Bitbucket 儲存庫。

     1. 在**連結的 Bitbucket 儲存庫**索引標籤中，選擇**連結 Bitbucket 儲存庫**。

     1. 從 **Bitbucket 工作區**下拉式清單中，選擇包含您要連結之儲存庫的 Bitbucket 工作區。

     1. 從 **Bitbucket 儲存庫**下拉式清單中，選擇您要連結至 CodeCatalyst 專案的儲存庫。
**提示**  
如果儲存庫的名稱呈現灰色，則您無法連結該儲存庫，因為它已連結至空間中的另一個專案。

     1. 從 **CodeCatalyst 專案**下拉式功能表中，選擇您要連結 Bitbucket 儲存庫的 CodeCatalyst 專案。

     1. 選擇 **Link (連結)**。

     如果您不想再使用 CodeCatalyst 中的 Bitbucket 儲存庫，可以將其從 CodeCatalyst 專案取消連結。當儲存庫取消連結時，該儲存庫中的事件將不會啟動工作流程執行，而且您將無法將該儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
   + **GitLab 儲存庫**：連結 GitLab 專案儲存庫。

     1. 在**連結的 GitLab 專案儲存庫**索引標籤中，選擇**連結 GitLab 專案儲存庫**。

     1. 從 **GitLab 使用者**下拉式清單中，選擇包含您要連結之專案儲存庫的 GitLab 使用者。

     1. 從 **GitLab 專案儲存庫**下拉式清單中，選擇您要連結至 CodeCatalyst 專案的儲存庫。
**提示**  
如果儲存庫的名稱呈現灰色，則您無法連結該儲存庫，因為它已連結至空間中的另一個專案。

     1. 從 **CodeCatalyst 專案**下拉式功能表中，選擇您要將 GitLab 專案儲存庫連結至的 CodeCatalyst 專案。

     1. 選擇 **Link (連結)**。

     如果您不想再使用 CodeCatalyst 中的 GitLab 專案儲存庫，您可以取消它與 CodeCatalyst 專案的連結。當專案儲存庫取消連結時，該專案儲存庫中的事件將不會啟動工作流程執行，而且您將無法將該專案儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
   + **Jira 軟體**：連結 Jira 專案。

     1. 在**連結的 Jira 專案**索引標籤中，選擇**連結 Jira 專案**。

     1. 從 **Jira 網站**下拉式功能表中，選擇包含您要連結之專案的 Jira 網站。

     1. 從 **Jira 專案**下拉式功能表中，選擇您要連結至 CodeCatalyst 專案的專案。

     1. 從 **CodeCatalyst 專案**下拉式功能表中，選擇您要連結至 Jira 專案的 CodeCatalyst 專案。

     1. 選擇 **Link (連結)**。

     一旦 Jira 專案連結至 CodeCatalyst 專案，對 CodeCatalyst 問題的存取將完全停用，而 CodeCatalyst 導覽窗格中**的問題**將取代為連結至 Jira 專案的 Jira **問題**項目。  
![\[CodeCatalyst 問題取代為導覽窗格中連結的 Jira 問題。\]](http://docs.aws.amazon.com/zh_tw/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)

     如果您不想再使用 CodeCatalyst 中的 Jira 專案，您可以將其與 CodeCatalyst 專案取消連結。當 Jira 專案取消連結時，CodeCatalyst 專案中將無法使用 Jira 問題，而 CodeCatalyst **Issues** 將再次成為問題提供者。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。

**從專案中的來源儲存庫頁面，將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至 CodeCatalyst 專案**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 導覽至 CodeCatalyst 專案。

1. 在導覽窗格中，選擇**程式碼**，然後選擇**來源儲存庫**。

1. 選擇**新增儲存庫**，然後選擇**連結儲存庫**。

1. 從**儲存庫提供者**下拉式功能表中，選擇下列其中一個第三方儲存庫提供者：**GitHub**、**Bitbucket**、**GitLab**。

1. 根據您選擇連結的第三方儲存庫提供者，執行下列其中一項操作：
   + **GitHub 儲存庫**：連結 GitHub 儲存庫。

     1. 從 **GitHub 帳戶**下拉式功能表中，選擇包含您要連結之儲存庫的 GitHub 帳戶。

     1. 從 **GitHub 儲存庫**下拉式功能表中，選擇您要連結 CodeCatalyst 專案的 GitHub 儲存庫。
**提示**  
如果儲存庫的名稱呈現灰色，則您無法連結該儲存庫，因為它已連結至 Amazon CodeCatalyst 中的另一個專案。

     1. （選用） 如果您在儲存庫清單中看不到 GitHub 儲存庫，則可能尚未在 GitHub 的 Amazon CodeCatalyst 應用程式中設定儲存庫存取。您可以設定哪些 GitHub 儲存庫可在連線帳戶中的 CodeCatalyst 中使用。

        1. 導覽至您的 [GitHub](https://github.com/) 帳戶，選擇**設定**，然後選擇**應用程式**。

        1. 在**已安裝的 GitHub 應用程式**索引標籤中，選擇為 Amazon CodeCatalyst 應用程式**設定** 。

        1. 執行下列其中一項操作來設定您要在 CodeCatalyst 中連結的 GitHub 儲存庫存取權：
           + 若要提供所有目前和未來儲存庫的存取權，請選擇**所有儲存庫**。
           + 若要提供特定儲存庫的存取權，請選擇**僅選取儲存庫**，選擇**選取儲存庫**下拉式清單，然後選擇您要允許 在 CodeCatalyst 中連結的儲存庫。
   + **Bitbucket 儲存庫**：連結 Bitbucket 儲存庫。

     1. 從 **Bitbucket 工作區**下拉式功能表中，選擇包含您要連結之儲存庫的 Bitbucket 工作區。

     1. 從 **Bitbucket 儲存庫**下拉式功能表中，選擇您要連結 CodeCatalyst 專案的 Bitbucket 儲存庫。
**提示**  
如果儲存庫的名稱呈現灰色，則您無法連結該儲存庫，因為它已連結至 Amazon CodeCatalyst 中的另一個專案。
   + **GitLab 儲存庫**：連結 GitLab 專案儲存庫。

     1. 從 **GitLab 使用者**下拉式功能表中，選擇包含您要連結之專案儲存庫的 GitLab 使用者。

     1. 從 **GitLab 專案儲存庫**下拉式功能表中，選擇您要連結 CodeCatalyst 專案的 GitLab 專案儲存庫。
**提示**  
如果專案儲存庫的名稱呈現灰色，您就無法連結該專案儲存庫，因為它已連結至 Amazon CodeCatalyst 中的另一個專案。

1. 選擇 **Link (連結)**。

如果您不想再使用 CodeCatalyst 中的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，您可以將其與 CodeCatalyst 專案取消連結。當儲存庫取消連結時，該儲存庫中的事件將不會啟動工作流程執行，而且您將無法將該儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。



將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至 CodeCatalyst 專案後，您可以在 CodeCatalyst 工作流程和開發環境中使用它。您也可以將連結的儲存庫與 Amazon Q Developer、藍圖等搭配使用。如需詳細資訊，請參閱[在第三方儲存庫事件之後自動啟動工作流程執行](extensions-workflow-repositories.md)及[建立開發環境](devenvironment-create.md)。

將您的 Jira 專案連結至 CodeCatalyst 專案，並連結提取請求後，CodeCatalyst 的更新會反映在您的 Jira 專案中。如需將提取請求連結至 Jira 問題的詳細資訊，請參閱 [將 Jira 問題連結至 CodeCatalyst 提取請求](link-jira-issues-pull-requests.md)。如需在 Jira 中檢視 CodeCatalyst 事件的詳細資訊，請參閱 [檢視 Jira 問題中的 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。

## 在 CodeCatalyst 專案建立期間將第三方儲存庫連結至
<a name="extensions-link-repositories-creation"></a>

您可以在建立新的 CodeCatalyst 專案時，將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至新的 CodeCatalyst 專案。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。