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

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

# 快速入門：在 CodeCatalyst 中安裝擴充功能、連線供應商和連結資源
<a name="extensions-quickstart"></a>

本教學課程提供以下三個任務的逐步解說：

1. 安裝 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira Software** 擴充功能。系統會在外部網站提示您連線，並提供 CodeCatalyst 存取第三方資源的權限，這是後續步驟的一部分。
**重要**  
若要將 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira Software** 擴充功能安裝至 CodeCatalyst 空間，您必須使用空間中具有**空間管理員**角色的帳戶登入。

1. 將您的 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者或 Jira 網站連線至 CodeCatalyst。
**重要**  
若要將您的 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者或 Jira 網站連線至 CodeCatalyst 空間，您必須同時是第三方來源的管理員和 CodeCatalyst **空間管理員**。
**重要**  
安裝儲存庫延伸模組後，您連結至 CodeCatalyst 的任何儲存庫都會將其程式碼編製索引並儲存在 CodeCatalyst 中。這可讓程式碼在 CodeCatalyst 中搜尋。若要進一步了解在 CodeCatalyst 中使用連結儲存庫時的程式碼資料保護，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[資料保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。
**注意**  
如果您使用 GitHub 帳戶的連線，則必須建立個人連線，以在 CodeCatalyst 身分和 GitHub 身分之間建立身分映射。如需詳細資訊，請參閱[個人連線](concepts.md#personal-connection-concept)及[使用個人連線存取 GitHub 資源](ipa-settings-connections.md)。

1. 將您的 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫或 Jira 專案連結至 CodeCatalyst 專案。
**重要**  
雖然您可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結為**貢獻者**，但您只能將第三方儲存庫取消連結為**空間管理員**或**專案管理員**。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
若要將 Jira 專案連結至 CodeCatalyst 專案，您必須是 CodeCatalyst **Space 管理員**或 CodeCatalyst **Project 管理員**。
**重要**  
CodeCatalyst 不支援偵測連結儲存庫的預設分支中的變更。若要變更連結儲存庫的預設分支，您必須先將其從 CodeCatalyst 取消連結、變更預設分支，然後再次連結。如需詳細資訊，請參閱[在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-link.md)。  
最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的擴充功能。
**注意**  
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 專案。

您也可以安裝 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**延伸模組、連接至 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者，並在建立新的 CodeCatalyst 專案時連結第三方儲存庫。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。

**Topics**
+ [步驟 1：從 CodeCatalyst 目錄安裝第三方延伸模組](#extensions-quickstart-install)
+ [步驟 2：將您的第三方供應商連接到 CodeCatalyst 空間](#extensions-github-extension-get-started-connect)
+ [步驟 3：將您的第三方資源連結至 CodeCatalyst 專案](#extensions-quickstart-link)
+ [後續步驟](#extensions-quickstart-next-steps)

## 步驟 1：從 CodeCatalyst 目錄安裝第三方延伸模組
<a name="extensions-quickstart-install"></a>

在 CodeCatalyst 中使用第三方資源的第一步是從 CodeCatalyst 目錄中安裝 **GitHub 儲存庫**延伸。若要安裝擴充功能，請執行下列步驟，為您要使用的第三方資源選擇擴充功能。**GitHub 儲存庫**、**Bitbucket 儲存庫**和 **GitLab 儲存庫**可讓您在 CodeCatalyst 中使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫。**Jira Software** 可讓您管理 CodeCatalyst 中的 Jira 問題。

**從 CodeCatalyst 目錄安裝擴充功能**

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

1. 導覽至 CodeCatalyst 空間。

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)中的**目錄**圖示，導覽至 CodeCatalyst CodeCatalyst 目錄。您可以搜尋 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira 軟體**。您也可以根據類別篩選延伸項目。

1. （選用） 若要查看延伸項目的詳細資訊，例如延伸項目將擁有的許可，請選擇延伸項目名稱。

1. 選擇 **Install (安裝)**。檢閱擴充功能所需的許可，如果您想要繼續，請再次選擇**安裝**。

安裝擴充功能後，系統會將您導向至擴充功能詳細資訊頁面。根據您安裝的擴充功能，您可以檢視和管理連線的提供者和連結的資源。

## 步驟 2：將您的第三方供應商連接到 CodeCatalyst 空間
<a name="extensions-github-extension-get-started-connect"></a>

安裝 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira 軟體**擴充功能後，下一步是將 GitHub 帳戶、Bitbucket 工作區、GitLab 專案儲存庫或 Jira 網站連線至 CodeCatalyst 空間。

**將您的 GitHub 帳戶、Bitbucket 工作區或 Jira 網站連線至 CodeCatalyst**
+ 根據您安裝的第三方延伸模組，執行下列其中一項操作：
  + **GitHub 儲存庫**：連線至 GitHub 帳戶。

    1. 在**連線的 GitHub 帳戶**索引標籤中，選擇**連線 GitHub 帳戶**以前往 GitHub 的外部網站。

    1. 使用您的 GitHub 登入資料登入 GitHub 帳戶，然後選擇您要安裝 Amazon CodeCatalyst 的帳戶。
**提示**  
如果您之前已將 GitHub 帳戶連接到空間，將不會提示您重新授權。如果您是多個 GitHub 組織的成員或協作者，您會看到一個對話方塊，詢問您要安裝延伸模組的位置；如果您只屬於一個 GitHub 組織，則會看到 Amazon CodeCatalyst 應用程式的組態頁面。為您要允許的儲存庫存取設定應用程式，然後選擇**儲存**。如果**儲存**按鈕未處於作用中狀態，請變更組態，然後再試一次。

    1. 選擇是否要允許 CodeCatalyst 存取所有目前和未來的儲存庫，或選擇您想要在 CodeCatalyst 中使用的特定 GitHub 儲存庫。預設選項是在 GitHub 帳戶中包含所有 GitHub 儲存庫，包括未來將由 CodeCatalyst 存取的儲存庫。

    1. 檢閱提供給 CodeCatalyst 的許可，然後選擇**安裝**。

    將您的 GitHub 帳戶連線至 CodeCatalyst 後，系統會帶您前往 **GitHub 儲存庫**延伸詳細資訊頁面，您可以在其中檢視和管理連線的 GitHub 帳戶和連結的 GitHub 儲存庫。
  + **Bitbucket 儲存庫**：連接至 Bitbucket 工作區。

    1. 在**連線的 Bitbucket 工作區**索引標籤中，選擇**連線 Bitbucket 工作區**以前往 Bitbucket 的外部網站。

    1. 使用您的 Bitbucket 登入資料登入 Bitbucket 工作區，並檢閱授予 CodeCatalyst 的許可。

    1. 從**授權工作區**下拉式功能表中，選擇您要提供 CodeCatalyst 存取權的 Bitbucket 工作區，然後選擇**授予存取權**。
**提示**  
如果您之前已將 Bitbucket 工作區連接到空間，將不會提示您重新授權。如果您是多個 Bitbucket 工作區的成員或協作者，您會看到一個對話方塊，詢問您要安裝延伸模組的位置；或者，如果您只屬於一個 Bitbucket 工作區，則會看到 Amazon CodeCatalyst 應用程式的組態頁面。為您要允許的工作區存取設定應用程式，然後選擇**授予存取權**。如果**授予存取**按鈕未處於作用中狀態，請變更組態，然後再試一次。

    將 Bitbucket 工作區連線至 CodeCatalyst 後，系統會帶您前往 **Bitbucket 儲存庫**延伸詳細資訊頁面，您可以在其中檢視和管理連接的 Bitbucket 工作區和連結的 Bitbucket 儲存庫。
  + **GitLab 儲存庫**：連線至 GitLab 使用者。

    1. 選擇 **Connect GitLab 使用者**以前往 GitLab 的外部網站。

    1. 使用您的 GitLab 登入資料登入您的 GitLab 使用者，並檢閱授予 CodeCatalyst 的許可。
**提示**  
如果您之前已將 GitLab 使用者連接到空間，將不會提示您重新授權。您將改為導覽回 CodeCatalyst 主控台。

    1. 選擇**授權 AWS GitLab 連接器**。

    將您的 GitLab 使用者連線至 CodeCatalyst 後，系統會帶您前往 **GitLab 儲存庫**延伸詳細資訊頁面，您可以在其中檢視和管理連線的 GitLab 使用者和連結的 GitLab 專案儲存庫。
  + **Jira 軟體**：連接 Jira 網站。

    1. 在**連線的 Jira 網站**索引標籤中，選擇**連線 Jira 網站**以前往 Atlassian Marketplace 的外部網站。

    1. 選擇**立即取得**，即可開始在 Jira 網站上安裝 CodeCatalyst。
**注意**  
如果您之前將 CodeCatalyst 安裝到您的 Jira 網站，您將會收到通知。選擇**開始使用**到最後一個步驟。

    1. 根據您的角色，執行下列其中一項：

       1. 如果您是 Jira 網站管理員，請從網站下拉式選單中選擇 Jira 網站來安裝 CodeCatalyst 應用程式，然後選擇**安裝應用程式**。
**注意**  
如果您有一個 Jira 網站，則不會顯示此步驟，而且會自動將您導向下一個步驟。

       1. 

          1. 如果您不是 Jira 管理員，請從網站下拉式功能表中選擇 Jira 網站來安裝 CodeCatalyst 應用程式，然後選擇**請求應用程式**。如需安裝 Jira 應用程式的詳細資訊，請參閱[誰可以安裝應用程式？](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)。

          1. 在輸入文字欄位中輸入您需要安裝 CodeCatalyst 的原因，或保留預設文字，然後選擇**提交請求**。

    1. 檢閱安裝應用程式時 CodeCatalyst 執行的動作，然後選擇**立即取得**。

    1. 安裝應用程式後，選擇**返回 CodeCatalyst** 以返回 CodeCatalyst。

    將您的 Jira 網站連線至 CodeCatalyst 後，您可以在 **Jira 軟體**延伸詳細資訊頁面的連線 Jira **網站索引標籤中檢視連線**的網站。

## 步驟 3：將您的第三方資源連結至 CodeCatalyst 專案
<a name="extensions-quickstart-link"></a>

使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫或管理 CodeCatalyst 中 Jira 問題的第三個和最後一個步驟是將它們連結到您要使用的 CodeCatalyst 專案。

**從延伸詳細資訊頁面將 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫或 Jira 專案連結至 CodeCatalyst 專案**
+ 根據您安裝的第三方延伸模組和連線的提供者，執行下列其中一項操作：
  + **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 **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 **問題**將再次成為問題提供者。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。

您也可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至 **Code** 中**來源儲存庫**的專案。如需詳細資訊，請參閱[從連線的第三方供應商連結資源](extensions-link.md#extensions-link-resources)。

## 後續步驟
<a name="extensions-quickstart-next-steps"></a>

安裝 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**延伸模組、連接您的資源提供者，並將第三方儲存庫連結至 CodeCatalyst 專案後，您可以在 CodeCatalyst 工作流程和開發環境中使用它。您也可以使用從藍圖產生的程式碼，在連線的 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者中建立第三方儲存庫。如需詳細資訊，請參閱[在第三方儲存庫事件之後自動啟動工作流程執行](extensions-workflow-repositories.md)及[建立開發環境](devenvironment-create.md)。

安裝 **Jira Software** 擴充功能、連接 Jira 網站、將 Jira 專案連結至 CodeCatalyst 專案，以及連結提取請求後，CodeCatalyst 的更新會反映在您的 Jira 專案中。如需將提取請求連結至 Jira 問題的詳細資訊，請參閱 [將 Jira 問題連結至 CodeCatalyst 提取請求](link-jira-issues-pull-requests.md)。如需在 Jira 中檢視 CodeCatalyst 事件的詳細資訊，請參閱 [檢視 Jira 問題中的 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。