Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 CodeCatalyst 中將功能新增至具有擴充功能的專案
Amazon CodeCatalyst 包含的擴充功能可協助您新增功能，並與 CodeCatalyst 以外的產品整合。透過 CodeCatalyst 目錄中的擴充功能，團隊可以在 CodeCatalyst 中自訂他們的體驗。
**Topics**
+ [可用的第三方延伸模組](#extensions-types)
+ [延伸模組概念](extensions-concepts.md)
+ [快速入門：在 CodeCatalyst 中安裝擴充功能、連線供應商和連結資源](extensions-quickstart.md)
+ [在空間中安裝擴充功能](install-extension.md)
+ [在空間中解除安裝擴充功能](uninstall-extension.md)
+ [連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst](extensions-connect.md)
+ [中斷連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst](extensions-disconnect.md)
+ [在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-link.md)
+ [在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)
+ [在 CodeCatalyst 中檢視第三方儲存庫和搜尋 Jira 問題](extensions-view-search.md)
+ [在第三方儲存庫事件之後自動啟動工作流程執行](extensions-workflow-repositories.md)
+ [透過第三方儲存庫供應商限制 IP 存取](extensions-restrict-ip-access.md)
+ [當工作流程失敗時封鎖第三方合併](extensions-block-merges.md)
+ [將 Jira 問題連結至 CodeCatalyst 提取請求](link-jira-issues-pull-requests.md)
+ [檢視 Jira 問題中的 CodeCatalyst 事件](view-codecatalyst-events-jira.md)
## 可用的第三方延伸模組
視您選擇整合資源的延伸項目而定，您可以將特定功能新增至 CodeCatalyst 專案。
### 在 CodeCatalyst 中整合 GitHub 儲存庫
GitHub 是一種雲端服務，可協助開發人員存放和管理程式碼。**GitHub 儲存庫**延伸可讓您在 Amazon CodeCatalyst 專案中使用連結的 GitHub 儲存庫。您也可以在建立新的 CodeCatalyst 專案時連結 GitHub 儲存庫。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。
**注意**
您無法搭配 CodeCatalyst 專案使用空白或封存的 GitHub 儲存庫。
**GitHub 儲存庫**擴充功能與 GitHub Enterprise Server 儲存庫不相容。
安裝和設定 **GitHub 儲存庫**延伸模組後，您將能夠：
+ 在 CodeCatalyst 的來源儲存庫清單中檢視您的 GitHub 儲存庫
+ 在 GitHub 儲存庫中存放和管理工作流程定義檔案
+ 從 CodeCatalyst 開發環境建立、讀取、更新和刪除儲存在連結 GitHub 儲存庫中的檔案
+ 從 CodeCatalyst 中連結的 GitHub 儲存庫存放和索引檔案
+ 使用連線 GitHub 帳戶的現有儲存庫建立 CodeCatalyst 專案
+ 使用藍圖建立專案或新增藍圖時，使用藍圖產生的程式碼建立 GitHub 儲存庫
+ 當程式碼推送至連結的 GitHub 儲存庫，或在連結的 GitHub 儲存庫中建立、修改或關閉提取請求時，啟動 CodeCatalyst 工作流程會自動執行
+ 在 CodeCatalyst 工作流程中使用連結的 GitHub 儲存庫來源檔案
+ 在 CodeCatalyst 工作流程中讀取和執行 GitHub 動作
+ 將 CodeCatalyst 工作流程執行狀態傳送至連結的 GitHub 儲存庫，並根據遞交狀態封鎖 GitHub 提取請求合併
### 在 CodeCatalyst 中整合 Bitbucket 儲存庫
Bitbucket 是一種雲端服務，可協助開發人員存放和管理程式碼。**Bitbucket 儲存庫**延伸可讓您在 Amazon CodeCatalyst 專案中使用連結的 Bitbucket 儲存庫。您也可以在建立新的 CodeCatalyst 專案時連結 Bitbucket 儲存庫。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。
**注意**
您無法搭配 CodeCatalyst 專案使用空白或封存的 Bitbucket 儲存庫。
**Bitbucket 儲存庫**擴充功能與 Bitbucket 資料中心儲存庫不相容。
安裝和設定 **Bitbucket 儲存庫**延伸模組後，您將能夠：
+ 在 CodeCatalyst 的來源儲存庫清單中檢視您的 Bitbucket 儲存庫
+ 在 Bitbucket 儲存庫中存放和管理工作流程定義檔案。
+ 從 CodeCatalyst 開發環境建立、讀取、更新和刪除儲存在連結 Bitbucket 儲存庫中的檔案
+ 使用連線 Bitbucket 帳戶的現有儲存庫建立 CodeCatalyst 專案
+ 從 CodeCatalyst 中連結的 Bitbucket 儲存庫存放和索引檔案
+ 使用藍圖建立專案或新增藍圖時，使用藍圖產生的程式碼建立 Bitbucket 儲存庫
+ 當程式碼推送至連結的 Bitbucket 儲存庫，或在連結的 Bitbucket 儲存庫中建立、修改或關閉提取請求時，啟動 CodeCatalyst 工作流程會自動執行
+ 在 CodeCatalyst 工作流程中使用您的連結 Bitbucket 儲存庫來源檔案
+ 將 CodeCatalyst 工作流程執行狀態傳送至連結的 Bitbucket 儲存庫，並根據遞交狀態封鎖 Bitbucket 提取請求合併
### 在 CodeCatalyst 中整合 GitLab 儲存庫
GitLab 是一種雲端服務，可協助開發人員存放和管理程式碼。**GitLab 儲存庫**延伸可讓您在 Amazon CodeCatalyst 專案中使用連結的 GitLab 專案儲存庫。您也可以在建立新的 CodeCatalyst 專案時連結 GitLab 專案儲存庫。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。
**注意**
您無法搭配 CodeCatalyst 專案使用空白或封存的 GitLab 專案儲存庫。
**GitLab 儲存庫**延伸模組與 GitLab 自我管理儲存庫不相容。
安裝和設定 **GitLab 儲存庫**延伸模組後，您將能夠：
+ 在 CodeCatalyst 的來源儲存庫清單中檢視 GitLab 專案儲存庫
+ 在 GitLab 專案儲存庫中存放和管理工作流程定義檔案。
+ 從 CodeCatalyst 開發環境建立、讀取、更新和刪除儲存在連結 GitLab 專案儲存庫中的檔案
+ 使用連線 GitLab 使用者的現有儲存庫建立 CodeCatalyst 專案
+ 從 CodeCatalyst 中連結的 GitLab 專案儲存庫存放和索引檔案
+ 使用藍圖建立專案或新增藍圖時，使用藍圖產生的程式碼建立 GitLab 專案儲存庫
+ 當程式碼推送至連結的 GitLab 專案儲存庫，或在連結的 GitLab 專案儲存庫中建立、修改或關閉提取請求時，啟動 CodeCatalyst 工作流程會自動執行
+ 在 CodeCatalyst 工作流程中使用您的連結 GitLab 專案儲存庫來源檔案
+ 將 CodeCatalyst 工作流程執行狀態傳送至連結的 GitLab 專案儲存庫，並根據遞交狀態封鎖 GitLab 合併請求
### 在 CodeCatalyst 中整合 Jira 問題
Jira 是一種軟體應用程式，可協助靈活的開發團隊規劃、指派、追蹤、報告和管理工作。**Jira Software** 擴充功能可讓您在 Amazon CodeCatalyst 專案中使用 Jira 專案。
**注意**
CodeCatalyst 僅與 **Jira Software Cloud** 相容。
為 Amazon CodeCatalyst 專案安裝和設定 **Jira 軟體**擴充功能後，您將能夠：
+ 透過將 Jira 專案連結至 CodeCatalyst 專案，從 CodeCatalyst 存取專案
+ 更新 CodeCatalyst 提取請求的 Jira 問題
+ 檢視 Jira 問題中連結 CodeCatalyst 提取請求的狀態和工作流程執行
# 延伸模組概念
以下是在 CodeCatalyst 中使用擴充功能時需要了解的一些概念和術語。
## 延伸模組
*擴充*功能是一種附加元件，您可以安裝在 CodeCatalyst 空間中，將新功能新增至您的專案，並與 CodeCatalyst 以外的服務整合。延伸項目可以從 CodeCatalyst 目錄瀏覽和安裝。
## CodeCatalyst 目錄
CodeCatalyst 目錄是 CodeCatalyst 中所有可用延伸項目的集中式清單。您可以瀏覽 CodeCatalyst 目錄，尋找可在來源、工作流程等 CodeCatalyst 領域改善團隊體驗的延伸模組。
## 連接和連結
根據您要使用或管理的第三方資源，您需要連接 GitHub 帳戶、Bitbucket 工作區或 Jira 專案。然後，您需要將 GitHub 儲存庫、Bitbucket 儲存庫或 Jira 專案連結至 CodeCatalyst 專案。
+ **GitHub 儲存庫**：連接 GitHub 帳戶，然後連結 GitHub 儲存庫。
+ **Bitbucket 儲存庫**：連接 Bitbucket 工作區，然後連結 Bitbucket 儲存庫。
+ **GitLab 儲存庫**：連接 GitLab 使用者，然後連結 GitLab 專案儲存庫。
+ **Jira 軟體**：連接 Jira 網站，然後連結 Jira 專案。
# 快速入門：在 CodeCatalyst 中安裝擴充功能、連線供應商和連結資源
本教學課程提供以下三個任務的逐步解說：
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 目錄安裝第三方延伸模組
在 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 空間
安裝 **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 專案
使用 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)。
## 後續步驟
安裝 **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)。
# 在空間中安裝擴充功能
您可以為 CodeCatalyst 空間安裝擴充功能，將功能新增至該空間中的專案。您可以選擇目錄圖示 來檢視 CodeCatalyst **目錄**![\[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)。若要進一步了解擴充功能及其功能，請參閱 [可用的第三方延伸模組](extensions.md#extensions-types)。
**重要**
若要安裝 延伸模組，您必須使用空間中具有 **Space 管理員**角色的帳戶登入。
**重要**
安裝儲存庫延伸模組後，您連結至 CodeCatalyst 的任何儲存庫都會將其程式碼編製索引並儲存在 CodeCatalyst 中。這可讓程式碼在 CodeCatalyst 中搜尋。若要進一步了解在 CodeCatalyst 中使用連結儲存庫時的程式碼資料保護，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[資料保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。
**從 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 目錄。您可以搜尋 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**或 **Jira 軟體**。您也可以根據類別篩選延伸項目。
1. （選用） 選擇延伸模組的名稱，以查看延伸模組的詳細資訊，例如延伸模組的許可。
1. 選擇 **Install (安裝)**。檢閱擴充功能所需的許可，如果您想要繼續，請再次選擇**安裝**。
安裝擴充功能後，您會看到已安裝擴充功能的詳細資訊頁面。瀏覽標籤以取得有關 延伸模組的詳細資訊。如有需要，詳細資訊頁面也可讓您執行延伸模組的進一步組態。
# 在空間中解除安裝擴充功能
您可以解除安裝先前安裝在 CodeCatalyst 空間中的擴充功能。解除安裝擴充功能可能會從您的 CodeCatalyst 空間或專案中移除與該擴充功能相關的資源。
**重要**
若要解除安裝 延伸模組，您必須使用空間中具有 **Space 管理員**角色的帳戶登入。
**從 CodeCatalyst 空間解除安裝擴充功能**
1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。
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. 在您要解除安裝的延伸項目上，選擇**設定** 。
1. 在延伸項目詳細資訊頁面上選擇**解除安裝**。
1. 檢閱**解除安裝延伸**模組對話方塊中的資訊。遵循指示，然後選擇**解除安裝**以解除安裝延伸模組。
# 連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst
若要使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，或在 CodeCatalyst 中管理 Jira 專案，您必須先將第三方來源連線至 CodeCatalyst 空間。若要進一步了解擴充功能及其功能，請參閱 [可用的第三方延伸模組](extensions.md#extensions-types)。
**重要**
若要將您的 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者或 Jira 網站連線至 CodeCatalyst 空間，您必須同時是第三方來源的管理員和 CodeCatalyst **空間管理員**。
**注意**
如果您使用 GitHub 帳戶的連線，則必須建立個人連線，以在 CodeCatalyst 身分和 GitHub 身分之間建立身分映射。如需詳細資訊，請參閱[個人連線](concepts.md#personal-connection-concept)及[使用個人連線存取 GitHub 資源](ipa-settings-connections.md)。
**若要將您的 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者或 Jira 網站連線至 CodeCatalyst**
1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。
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 帳戶**以前往 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 **網站索引標籤中檢視連線**的網站。
如果您不想再使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，或管理 CodeCatalyst 中的 Jira 問題，您可以中斷與第三方來源的連線。當 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者中斷連線時，第三方儲存庫中的事件將不會啟動工作流程執行，而且您將無法將這些儲存庫與 CodeCatalyst 開發環境搭配使用。當 Jira 網站中斷連線時，來自網站專案的 Jira 問題將無法在 CodeCatalyst 專案中使用，CodeCatalyst **問題**將再次成為問題提供者。如需詳細資訊，請參閱[中斷連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst](extensions-disconnect.md)。
# 中斷連接 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者和 Jira 網站 CodeCatalyst
如果您不想再使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，或管理 CodeCatalyst 中的 Jira 問題，您可以中斷與第三方來源的連線。一旦 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者中斷連線，儲存庫中的事件將不會啟動工作流程執行，而且您將無法將這些儲存庫與 CodeCatalyst 開發環境搭配使用。當 Jira 網站中斷連線時，來自網站專案的 Jira 問題將無法在 CodeCatalyst 專案中使用，CodeCatalyst **問題**將再次成為問題提供者。
**注意**
若要中斷連接 GitHub 帳戶，您必須先取消連結該帳戶的所有連結 GitHub 儲存庫。
若要中斷 Bitbucket 工作區的連線，您必須先將所有連結的 Bitbucket 儲存庫與該工作區取消連結。
若要中斷 GitLab 使用者的連線，您必須先將所有連結的 GitLab 專案儲存庫與該工作區取消連結。
若要中斷 Jira 網站的連線，您必須先取消連結該帳戶的所有連結 Jira 專案。
如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
**若要中斷連接 GitHub 專案、Bitbucket 工作區、GitLab 使用者或 Jira 網站**
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 帳戶。
在**連線的 GitHub 帳戶**索引標籤中，選擇您要中斷連線的 GitHub 帳戶，然後選擇**中斷連線 GitHub 帳戶**。
+ **Bitbucket 儲存庫**：不連接到 Bitbucket 工作區。
在**連線的 Bitbucket 工作區**索引標籤中，選擇您要中斷連線的 Bitbucket 工作區，然後選擇**中斷連線 Bitbucket 工作區**。
+ **GitLab 儲存庫**：不連接到 GitLab 使用者。
在**連線的 GitLab 使用者**索引標籤中，選擇您要中斷連線的 GitLab 使用者，然後選擇**中斷連線 GitLab 使用者**。
+ **Jira 軟體**：解構至 Jira 網站。
在**連線的 Jira 網站**索引標籤中，選擇您要中斷連線的 Jira 網站，然後選擇**中斷連線 Jira 網站**。
1. 在**中斷**連線對話方塊中，檢閱中斷帳戶連線的效果。
1. 在文字輸入欄位中輸入**中斷**連線，然後選擇**中斷連線**。
# 在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案
您必須先將儲存庫或專案所屬的第三方來源與 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)
## 從連線的第三方供應商連結資源
**從延伸詳細資訊頁面將 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 專案建立期間將第三方儲存庫連結至
您可以在建立新的 CodeCatalyst 專案時，將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至新的 CodeCatalyst 專案。如需詳細資訊，請參閱[使用連結的第三方儲存庫建立專案](projects-create.md#projects-create-3p-repo)。
# 在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案
如果您不想再使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，或在 CodeCatalyst 中管理 Jira 專案，您可以取消儲存庫或專案與 CodeCatalyst 專案的連結。
取消連結 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫不會刪除儲存庫或對其進行任何變更。它不會刪除存放在該連結儲存庫中的任何工作流程組態檔案。不過，一旦取消連結 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，該儲存庫中的事件將不再啟動工作流程執行，而且您無法搭配開發環境使用儲存庫。您可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫從 CodeCatalyst 專案取消連結，從 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**延伸的詳細資訊頁面，或從專案本身**程式碼**中的**來源儲存庫**檢視取消連結。
取消連結 Jira 專案不會刪除專案，包括規劃項目或開發資訊，或對其進行任何變更。不過，一旦取消連結 Jira 專案，專案的 Jira 問題將無法再連結至 CodeCatalyst 專案，而 CodeCatalyst **問題**將再次成為問題提供者。
**重要**
若要從 CodeCatalyst 專案取消連結 GitHub 儲存庫、Bitbucket 儲存庫或 Gitlab 專案儲存庫，您必須是**空間管理員**或**專案管理員**。
**從延伸詳細資訊頁面取消 CodeCatalyst 專案中的 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫或 Jira 專案的連結**
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 儲存庫。
在 **GitHub 儲存庫**索引標籤中，選擇您要取消連結的 GitHub 儲存庫，然後選擇**取消連結 GitHub 儲存庫**。
+ **Bitbucket 儲存庫**：取消連結 Bitbucket 儲存庫。
在 **Bitbucket 儲存庫**索引標籤中，選擇您要取消連結的 Bitbucket 儲存庫，然後選擇**取消連結 Bitbucket 儲存庫**。
+ **GitLab 儲存庫**：取消連結 GitLab 專案儲存庫。
在 **GitLab 專案儲存庫**索引標籤中，選擇您要取消連結的 GitLab 專案儲存庫，然後選擇**取消連結 GitLab 專案儲存庫**。
+ **Jira 軟體**：取消 Jira 專案的連結。
在 **Jira 專案**索引標籤中，選擇您要取消連結的 Jira 專案，然後選擇**取消連結 Jira 專案**。
1. 在**取消連結**對話方塊中，檢閱取消連結儲存庫的效果。
1. 在文字輸入欄位中輸入**取消連結**，然後選擇**取消連結**。
**從來源儲存庫頁面取消連結 CodeCatalyst 專案中的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至 CodeCatalyst 專案。
1. 在導覽窗格中，選擇**程式碼**，然後選擇**來源儲存庫**。
1. 選擇您要取消連結之儲存庫的選項按鈕，然後選擇**取消連結儲存庫**。
1. 檢閱對話方塊中的資訊。遵循指示，然後選擇**取消連結**以取消連結儲存庫。
# 在 CodeCatalyst 中檢視第三方儲存庫和搜尋 Jira 問題
連結 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫之後，您可以在 CodeCatalyst 中檢視它們，以確認和設定資源。您也可以在 CodeCatalyst 中搜尋連結的 Jira 問題。
**Topics**
+ [在 CodeCatalyst 中檢視第三方儲存庫](#extensions-view-repositories)
+ [在 CodeCatalyst 中搜尋 Jira 問題](#extensions-search-issues)
## 在 CodeCatalyst 中檢視第三方儲存庫
您可以在專案的來源儲存庫清單中，或從 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 儲存庫延伸詳細資訊頁面中，檢視連結的 **GitHub **儲存庫、Bitbucket 儲存庫或 **GitLab 專案儲存庫**。 ****從儲存庫清單中選擇它們並不會在 CodeCatalyst 中開啟它們。相反地，它們會在第三方儲存庫提供者中開啟，您可以在其中檢視和處理連結儲存庫中的程式碼。
**在 CodeCatalyst 中檢視連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至 CodeCatalyst 專案。
1. 在導覽窗格中，選擇**程式碼**，然後選擇**來源儲存庫**。
**從延伸詳細資訊頁面檢視連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至 CodeCatalyst 空間，然後選擇**已安裝的擴充**功能索引標籤。
1. 根據您要檢視的第三方儲存庫，執行下列其中一項操作：
+ 在 **GitHub 儲存庫**中，選擇**設定**，然後選擇**連結的 GitHub 儲存庫**，以檢視連線至 CodeCatalyst 空間中 CodeCatalyst 專案的所有 GitHub 儲存庫。
+ 在 **Bitbucket 儲存庫**中，選擇**設定**，然後選擇**連結的 Bitbucket 儲存庫**，以檢視連線至 CodeCatalyst 空間中 CodeCatalyst 專案的所有 Bitbucket 儲存庫。
+ 在 **GitLab 儲存庫**中，選擇**設定**，然後選擇**連結的 GitLab 專案儲存庫**，以檢視連線至 CodeCatalyst 空間中 CodeCatalyst 專案的所有 GitLab 專案儲存庫。
連結至 CodeCatalyst 專案的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫會顯示在清單中。選擇 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，以檢視和編輯第三方儲存庫提供者中的檔案。
**注意**
如果工作流程在來源動作中使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫，您對視覺化編輯器中的工作流程 YAML 或 CodeCatalyst 中的 YAML 編輯器所做的變更將自動遞交並推送至第三方儲存庫。
## 在 CodeCatalyst 中搜尋 Jira 問題
連結 Jira 專案後，您可以使用 CodeCatalyst 全域搜尋列來搜尋連結的 Jira 專案是否有問題。您也可以在 CodeCatalyst 中搜尋 Jira 問題，同時從提取請求連結至問題。如需將 Jira 問題連結至 CodeCatalyst 提取請求的詳細資訊，請參閱 [將 Jira 問題連結至 CodeCatalyst 提取請求](link-jira-issues-pull-requests.md)。
**在連結的 Jira 專案中搜尋 Jira 問題**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至 CodeCatalyst 專案。
1. 在全域搜尋列中，搜尋連結的 Jira 專案是否有您要連結至提取請求的問題或 Jira 問題。
# 在第三方儲存庫事件之後自動啟動工作流程執行
您可以使用連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫做為工作流程的來源，其中對連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫中指定分支的變更會自動啟動工作流程執行。
*工作流程*是一種自動化程序，說明如何建置、測試和部署程式碼，做為持續整合和持續交付 (CI/CD) 系統的一部分。工作流程定義了工作流程執行期間要採取的一系列步驟或*動作*。工作流程也會定義導致工作流程啟動的事件或*觸發條件*。若要設定工作流程，您可以使用 CodeCatalyst 主控台的[視覺化或 YAML 編輯器](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)建立*工作流程定義檔案*。
**提示**
若要快速了解如何在專案中使用工作流程，[請使用藍圖建立專案](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)。每個藍圖都會部署可檢閱、執行和實驗的正常運作工作流程。
當您將工作流程設定為使用連結的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫時，工作流程組態檔案會存放在該 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫中。工作流程組態是 YAML 檔案，可定義工作流程名稱、觸發條件、資源、成品和動作。如需工作流程組態檔案的詳細資訊，請參閱 [工作流程 YAML 定義](workflow-reference.md)。
工作流程組態檔案必須位於 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫的 `./codecatalyst/workflows/` 目錄中。
您可以使用工作流程編輯器來建立和設定工作流程。如需更多資訊，請參閱[工作流程入門](workflows-getting-started.md)及[將來源儲存庫連線至工作流程](workflows-sources.md)。
## 新增觸發條件以啟動工作流程執行
您可以設定 CodeCatalyst 工作流程，在程式碼推送至 GitHub 或 Bitbucket 儲存庫的指定分支時自動啟動執行。若要自動啟動工作流程執行，請將觸發條件新增至工作流程組態檔案的 `Triggers`區段。
### 範例：簡單的程式碼推送觸發程序
下列範例顯示每當程式碼推送到來源儲存庫中的任何分支時，啟動工作流程執行的觸發。
```
Triggers:
- Type: PUSH
```
### 範例：簡易的提取請求觸發
下列範例顯示觸發程序，會在針對來源儲存庫中的任何分支建立提取請求時啟動工作流程執行。
```
Triggers:
- Type: PULLREQUEST
Events:
- OPEN
```
如需詳細資訊，請參閱[使用觸發程序自動啟動工作流程執行](workflows-add-trigger.md)。
# 透過第三方儲存庫供應商限制 IP 存取
您可以設定規則或組態，根據 IP 地址限制對 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫的存取。您可以透過第三方供應商的設定或存取控制功能來執行此操作。
視您使用的第三方儲存庫提供者而定，請參閱下列其中一項：
+ Amazon CodeCatalyst **GitHub 儲存庫**延伸模組與 [ GitHub Enterprise Cloud IP 存取限制](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)相容。設定 GitHub Enterprise Cloud 組織以限制存取特定 IP 地址時，您也可以[啟用 GitHub 應用程式來設定允許清單](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)，讓 CodeCatalyst 自動向 GitHub 註冊其 IP 地址。或者，您可以[手動新增 CodeCatalyst IP 地址](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)。
+ Amazon CodeCatalyst **Bitbucket 儲存庫**延伸模組與 [ Bitbucket Cloud Premium 存取限制](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/)相容。設定 Bitbucket Cloud Premium 工作區以限制存取特定 IP 地址時，您也可以[將一組 IP 地址的 IP 地址或網路區塊新增至允許清單](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/#Allowlisting-IP-addresses)。
+ Amazon CodeCatalyst **GitLab 儲存庫**延伸模組與 [ GitLab IP 地址限制](https://docs.gitlab.com/ee/administration/reporting/ip_addr_restrictions.html)相容。設定 GitLab Premium 或 Ultimate 群組以限制存取特定 IP 地址時，您也可以將[一組 IP 地址的 IP 地址或網路區塊新增至允許清單](https://docs.gitlab.com/ee/user/group/access_and_permissions.html)。
如果 CodeCatalyst IP 地址不在第三方儲存庫的允許清單中，Amazon CodeCatalyst 應用程式將無法存取您的第三方儲存庫。如需詳細資訊，請參閱[第三方儲存庫擴充功能所使用的 IP 地址](#codecatalyst-ip-address)。
## 第三方儲存庫擴充功能所使用的 IP 地址
第三方擴充功能會使用下列 IP 地址來存取您的第三方資源：
+ **GitHub 儲存庫**：
```
us-west-2
52.32.242.246
54.148.176.49
35.164.118.94
eu-west-1
34.241.64.10
34.246.255.80
3.248.38.7
```
+ **Bitbucket 儲存庫**和 **GitLab 儲存庫**：
```
us-west-2
35.160.210.199
54.71.206.108
54.71.36.205
eu-west-1
34.242.64.82
52.18.37.201
54.77.75.62
```
# 當工作流程失敗時封鎖第三方合併
將 GitHub 或 Bitbucket 儲存庫連結至 CodeCatalyst 之後，您可以為提取請求新增 CodeCatalyst 工作流程。同樣地，在將 GitLab 專案儲存庫連結至 CodeCatalyst 之後，您可以為合併請求新增 CodeCatalyst 工作流程。一或多個工作流程執行可能發生在特定遞交上，而且 CodeCatalyst 中每個工作流程的執行狀態也會反映為 GitHub、Bitbucket 或 GitLab 中遞交狀態的一部分。推送新的遞交時，新的工作流程[執行狀態](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-view-run.html#workflows-view-run-status)會反映在該新遞交的 GitHub、Bitbucket 或 GitLab 中。如果您再次為遞交執行工作流程，新的工作流程執行狀態會覆寫該遞交和工作流程的先前狀態。
您可以在 GitHub 或 Bitbucket 中設定分支保護規則以封鎖提取請求合併，或在最近的遞交具有失敗的工作流程執行狀態時，在 GitLab 中設定分支保護規則以封鎖合併請求。透過分支保護規則，最新遞交的狀態會影響在 GitHub、Bitbucket 或 GitLab 中合併提取請求的能力。若要進一步了解工作流程，請參閱 [執行工作流程](workflows-working-runs.md)和 [使用觸發程序自動啟動工作流程執行](workflows-add-trigger.md)。
根據您正在使用的第三方儲存庫提供者，請參閱以下內容：
+ **GitHub 儲存庫**：GitHub 的文件[關於狀態檢查](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)和[關於受保護的分支](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)。
+ **Bitbucket 儲存庫**：Bitbucket 在 Bitbucket Cloud [中使用分支許可](https://confluence.atlassian.com/bitbucketserver/using-branch-permissions-776639807.html)和控制分支許可的文件。 [https://bitbucket.org/blog/take-control-with-branch-restrictions](https://bitbucket.org/blog/take-control-with-branch-restrictions)
+ **GitLab 儲存庫**：GitLab 的[自動合併](https://docs.gitlab.com/ee/user/project/merge_requests/auto_merge.html)和[受保護分支](https://docs.gitlab.com/ee/user/project/protected_branches.html)文件。
# 將 Jira 問題連結至 CodeCatalyst 提取請求
您可以將 CodeCatalyst 來源儲存庫中建立的提取請求連結至 Jira 問題。連結 Jira 問題後，問題會顯示為提取請求的屬性。因此，提取請求事件、工作流程事件和部署事件會傳送至 Jira，並新增至 Jira 問題。提取請求可以連結到一或多個 Jira 問題。您只能連結 CodeCatalyst 來源儲存庫中的提取請求，不能連結 GitHub 等第三方儲存庫中的提取請求。您必須先將 Jira 專案連結至 CodeCatalyst 專案，才能將 Jira 問題連結至提取請求。如需將 Jira 專案連結至 CodeCatalyst 專案的詳細資訊，請參閱 [在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-link.md)。
**注意**
在沒有 CodeCatalyst 專案中有兩個分支的來源儲存庫的情況下，您無法建立提取請求。如需提取請求的詳細資訊，請參閱[在 CodeCatalyst 中使用提取請求](source-pull-requests.md)。
**將 Jira 問題連結至 CodeCatalyst 提取請求**
1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 導覽至 CodeCatalyst 專案。
1. 在導覽窗格中，選擇**程式碼**，然後選擇**提取請求**。
1. 選擇**建立提取請求**以輸入提取請求詳細資訊。
1. 從**來源儲存庫**下拉式功能表中，選擇您要連結提取請求的來源儲存庫。
1. 從**來源分支**下拉式功能表中，選擇包含您要檢閱之變更的分支。
1. 從**目的地分支**下拉式功能表中，選擇您要合併已檢閱變更的分支。
1. 在**提取請求標題**文字輸入欄位中，輸入提取請求的標題。
1. 選擇 Jira 問題**的連結問題** - 選用欄位，選擇下拉式清單，然後搜尋您要從連結的 Jira 專案新增的 Jira 問題。 ** ****
1. 選取您要新增至提取請求的 Jira 問題。
1. 選擇**建立**以建立提取請求。
將 Jira 問題連結至 CodeCatalyst 提取請求後，即可取得提取請求的摘要。摘要包括工作流程執行、連結問題、必要檢閱者、選用檢閱者和作者。
**注意**
CodeCatalyst 中無法使用與 Jira 問題相關聯的**受指派者**和**建立者**資訊。
連結提取請求後，同步的 CodeCatalyst 專案和 Jira 專案允許 CodeCatalyst 的更新反映在您的 Jira 專案中。在 Jira 中檢視時，與提取請求相關的連結提取請求和任何工作流程事件的狀態會顯示在 Jira 問題中。如需在 Jira 中檢視 CodeCatalyst 事件的詳細資訊，請參閱 [檢視 Jira 問題中的 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。
# 檢視 Jira 問題中的 CodeCatalyst 事件
如果您的 CodeCatalyst 專案和 Jira 專案已連結，則提取請求的摘要狀態和相關聯的 CodeCatalyst 工作流程事件狀態會反映在您的 Jira 問題中。例如，如果您在 CodeCatalyst 中關閉或合併提取請求，狀態更新會反映在 Jira 問題中。CodeCatalyst 工作流程 CI/CD 與 CodeCatalyst 提取請求相關的事件會同步，因此成功的工作流程執行也會傳送至 Jira 問題。
**檢視 Jira 問題中的 CodeCatalyst 事件**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至 CodeCatalyst 專案。
1. 在 CodeCatalyst 導覽窗格中，選擇**程式碼**，選擇**提取請求**，然後使用您要在 Jira 專案中檢視的 Jira 問題選擇提取請求。
1. 在**其他資訊**窗格中，選擇您要在 Jira 專案中檢視的 Jira 問題。
1. 從 Jira 專案的詳細資訊****窗格中，選擇為**開發**列出的**提取請求**，以查看提取請求的詳細資訊。
1. （選用） 若要查看最新的組建，請選擇**組建**索引標籤。
1. （選用） 若要查看開發狀態，請選擇**部署**索引標籤。