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

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

# 在 CodeCatalyst 中組織使用專案
<a name="projects"></a>

您可以使用 Amazon CodeCatalyst 中的專案來建立協作空間，讓開發團隊可以使用共用的持續整合/持續交付 (CI/CD) 工作流程和儲存庫來執行開發任務。建立專案時，您可以新增、更新或移除資源。您也可以監控團隊工作的進度。您可以在空間中擁有多個專案。

CodeCatalyst 中的空間是由專案組成。您可以在空間中看到每個專案，但您只能使用您成為成員的專案。當您建立專案時，會產生專案的預設角色，您可以將這些角色指派給您邀請加入專案的使用者。
+ 指派給具有專案角色之專案的任何人，例如 **Contributor 角色**，都可以存取專案資源，例如來源儲存庫。
+ 具有 **Space 管理員**或**專案管理員**角色的任何人都可以傳送加入專案的邀請。
+ 具有**專案管理員**角色的使用者可以跨共用資源追蹤活動、狀態和其他設定。
+ 具有**有限存取**角色的使用者可以在 CI/CD 工作流程中管理功能、程式碼修正和測試的專案指派。

  工作流程用於建置、測試和發行或更新應用程式做為 CI/CD 管道。您可以透過新增傳輸和處理來源成品的動作來組合工作流程。當您執行動作時，專案雲端資源會用來為您的工作流程動作提供隨需運算能力。您可以根據要設定的活動和輸出來設定更多 CI/CD 工作流程。例如，您只能為建置和測試動作建立工作流程，您可以在其中檢視測試結果並完成工作流程，而無需部署，同時修正錯誤。然後，您可以建立另一個工作流程，將應用程式建置和部署到預備環境。

建立專案時，您可以使用藍圖來建立包含範本程式碼並建立資源的專案，也可以從空專案開始。如果您使用藍圖建立專案，您選擇的藍圖會決定要將哪些資源新增至您的專案，以及 CodeCatalyst 建立或設定的工具，以便您可以追蹤和使用您的專案資源。您可以在建立專案之後手動新增或移除資源。

每個專案都會將專案活動追蹤為使用者的事件清單，例如建立專案或修改資源的時間。在空間層級監控和彙總專案活動。如需使用活動資料的詳細資訊，請參閱 [檢視空間中的所有專案](projects-view-overview.md)。

如果您的專案使用 AWS 資源，您可以將 CodeCatalyst 帳戶 AWS 連接到您具有管理許可的帳戶，以整合專案的資源。

您可以在建立來源儲存庫、問題和其他資源之後，將其新增至您的專案。您必須具有 **Space 管理員**角色才能建立專案。

# 建立專案
<a name="projects-create"></a>

透過 CodeCatalyst 專案，您可以使用共用的持續整合/持續交付 (CI/CD) 工作流程和儲存庫來執行開發任務、管理資源、追蹤問題，以及新增使用者。

建立專案之前，您必須擁有 **Space 管理員**或 **Power 使用者**角色。

**Topics**
+ [在 Amazon CodeCatalyst 中建立空專案](#projects-create-empty)
+ [使用連結的第三方儲存庫建立專案](#projects-create-3p-repo)
+ [使用藍圖建立專案](#projects-create-console-template)
+ [使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務](#projects-create-amazon-q)
+ [搭配專案使用藍圖的最佳實務](#projects-create-use-blueprints)
+ [將資源和任務新增至已建立的專案](#projects-create-after-steps)

## 在 Amazon CodeCatalyst 中建立空專案
<a name="projects-create-empty"></a>

您可以建立沒有資源的空專案，稍後再手動新增所需的資源。

建立專案之前，您必須擁有 **Space 管理員**或 **Power 使用者**角色。

**建立空專案**

1. 導覽至您要建立專案的空間。

1. 在空間儀表板上，選擇**建立專案**。

1. 選擇**從頭開始**。

1. 在**將名稱提供給專案**下，輸入您要指派給專案的名稱。名稱在您的空間中必須是唯一的。

1. 選擇**建立專案**。

## 使用連結的第三方儲存庫建立專案
<a name="projects-create-3p-repo"></a>

您可以將專案的原始碼保留在偏好的第三方供應商中，但仍使用所有 CodeCatalyst 功能，例如藍圖、生命週期管理、工作流程等。若要這樣做，您可以建立新的 CodeCatalyst 專案，連結至 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫。然後，您可以在 CodeCatalyst 專案中使用連結的來源儲存庫。

建立 CodeCatalyst 專案之前，您必須擁有 **Space 管理員**或 **Power 使用者**角色。如需詳細資訊，請參閱[建立空間](spaces-create.md)及[直接邀請使用者到空格](spaces-members-add-admin.md)。

若要在 CodeCatalyst 中建立連結至 GitHub 帳戶中來源儲存庫的專案，您需要完成下列三個任務：

1. 安裝 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**延伸。系統會在外部網站提示您連線，並提供 CodeCatalyst 存取您的儲存庫的權限，這是下一個步驟的一部分。
**重要**  
若要將 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**延伸模組安裝至 CodeCatalyst 空間，您必須使用空間中具有**空間管理員**角色的帳戶登入。

1. 將您的 GitHub 帳戶或 Bitbucket 工作區或 GitLab 使用者連線至 CodeCatalyst。
**重要**  
若要將您的 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者連線至 CodeCatalyst 空間，您必須同時是第三方來源的管理員和 CodeCatalyst **空間管理員**。
**重要**  
安裝儲存庫延伸模組後，您連結至 CodeCatalyst 的任何儲存庫都會將其程式碼編製索引並儲存在 CodeCatalyst 中。這可讓程式碼在 CodeCatalyst 中搜尋。若要進一步了解在 CodeCatalyst 中使用連結儲存庫時的程式碼資料保護，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[資料保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。

1. 建立連結至 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫的 CodeCatalyst 專案。
**重要**  
雖然您可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結為**貢獻者**，但您只能將第三方儲存庫取消連結為**空間管理員**或**專案管理員**。如需詳細資訊，請參閱[在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-unlink.md)。
**重要**  
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 中將功能新增至具有擴充功能的專案將功能新增至具有擴充功能的專案](extensions.md)。

**安裝第三方延伸模組**

1. 導覽至您要建立專案的空間。

1. 在空間儀表板上，選擇**建立專案**。

1. 選擇**使用您自己的程式碼**。

1. 在**連結現有儲存庫**下，根據您要使用的第三方儲存庫提供者，選擇 **GitHub 儲存庫**、**Bitbucket 儲存庫**、**GitLab 儲存庫**。如果您之前未這麼做，系統會提示您連接 GitHub 帳戶、Bitbucket 工作區或 GitLab 帳戶。如果尚未安裝您選擇的第三方延伸模組，則會顯示安裝提示。

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

安裝第三方延伸模組後，下一步是將您的 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者連線至 CodeCatalyst 空間。

**將您的 GitHub 帳戶、Bitbucket 工作區或 GitLab 使用者連線至 CodeCatalyst**

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

  1. 選擇**連線 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 的外部網站。

  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 專案儲存庫。

將您的第三方來源連線至 CodeCatalyst 之後，您可以將第三方儲存庫連結至 CodeCatalyst 專案。

**若要建立專案**

1. 在**建立專案**頁面上，選擇您連接的 GitHub 帳戶。

1. 根據您連接的第三方儲存庫供應商，選擇 **GitHub 儲存庫**、**Bitbucket 儲存庫**或 **GitLab 儲存庫**儲存庫下拉式功能表，以檢視第三方儲存庫，然後選擇您要連結至專案的儲存庫。

1. 在**命名專案**文字輸入欄位中，輸入您要指派給專案的名稱。名稱在您的空間中必須是唯一的。

1. 選擇**建立專案**。

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

## 使用藍圖建立專案
<a name="projects-create-console-template"></a>

您可以使用專案藍圖佈建所有專案資源和範本程式碼。如需藍圖的相關資訊，請參閱 [使用 CodeCatalyst 藍圖建立全面的專案使用藍圖建立全面的專案](project-blueprints.md)。

**使用藍圖建立專案**

1. 在 CodeCatalyst 主控台中，導覽至您要建立專案的空間。

1. 在空間儀表板上，選擇**建立專案**。

1. 選擇**從藍圖開始**。
**提示**  
您可以選擇為 **Amazon Q** 提供專案要求來新增藍圖，讓 Amazon Q 向您建議藍圖。如需詳細資訊，請參閱[建立專案或新增功能時，使用 Amazon Q 選擇藍圖](getting-started-project-assistance.md#getting-started-project-assistance-create-apply-bp)及[使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務](#projects-create-amazon-q)。此功能僅適用於美國西部 （奧勒岡） 區域。  
此功能需要為空間啟用生成式 AI 功能。如需詳細資訊，請參閱[管理生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。

1. 從 **CodeCatalyst 藍圖**或**空間藍圖**索引標籤中，選擇藍圖，然後選擇**下一步**。

1. 在**為您的專案命名**下，輸入您要指派給專案的名稱及其相關聯的資源名稱。名稱在您的空間中必須是唯一的。

1. （選用） 根據預設，藍圖建立的原始碼會存放在 CodeCatalyst 儲存庫中。或者，您可以選擇將藍圖的原始程式碼存放在第三方儲存庫中。如需詳細資訊，請參閱[在 CodeCatalyst 中將功能新增至具有擴充功能的專案將功能新增至具有擴充功能的專案](extensions.md)。
**重要**  
CodeCatalyst 不支援偵測連結儲存庫的預設分支中的變更。若要變更連結儲存庫的預設分支，您必須先將其從 CodeCatalyst 取消連結、變更預設分支，然後再次連結。如需詳細資訊，請參閱[在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-link.md)。  
最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的擴充功能。

   根據您要使用的第三方儲存庫提供者，執行下列其中一項操作：
   + **GitHub 儲存庫**：連接 GitHub 帳戶。

     選擇**進階**下拉式功能表，選擇 GitHub 做為儲存庫提供者，然後選擇您要存放藍圖所建立原始碼的 GitHub 帳戶。
**注意**  
如果您要連接 GitHub 帳戶，則必須建立個人連線，以在 CodeCatalyst 身分和 GitHub 身分之間建立身分映射。如需詳細資訊，請參閱[個人連線](concepts.md#personal-connection-concept)及[使用個人連線存取 GitHub 資源](ipa-settings-connections.md)。
   + **Bitbucket 儲存庫**：連接 Bitbucket 工作區。

     選擇**進階**下拉式功能表，選擇 Bitbucket 做為儲存庫提供者，然後選擇您要存放藍圖所建立原始碼的 Bitbucket 工作區。
   + **GitLab 儲存庫**：連接 GitLab 使用者。

     選擇**進階**下拉式功能表，選擇 GitLab 做為儲存庫提供者，然後選擇您要存放藍圖所建立原始碼的 GitLab 使用者。

1. 在**專案資源**下，設定藍圖參數。根據藍圖，您可以選擇命名來源儲存庫名稱。

1. （選用） 若要根據您所做的專案參數選擇來檢視具有更新的定義檔案，請選擇從**產生專案預覽****中檢視程式碼**或**檢視工作流程**。

1. （選用） 從藍圖的卡片選擇**檢視詳細資訊**，以檢視藍圖的特定詳細資訊，例如藍圖架構的概觀、必要的連線和許可，以及藍圖建立的資源類型。

1. 選擇**建立專案**。

## 使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務
<a name="projects-create-amazon-q"></a>

當您建立專案或想要將新元件新增至現有專案時，您可能不確定要使用哪個藍圖或如何整合功能。CodeCatalyst 包含與名為 Amazon Q 的生成式 AI 助理整合，該助理可以分析您的專案需求，並建議最符合您需求的藍圖。

您可以使用 Amazon Q 來協助您建立具有藍圖的專案，以根據您的需求建立元件，或者您可以使用 Amazon Q 來協助您將藍圖新增至現有專案。例如，若要將 Web 應用程式或現代應用程式的資源新增至專案，請指定您的需求，然後使用建議的藍圖新增資源。您可以為您建立剩餘元件的問題。

Amazon Q 也會針對建議的藍圖無法解決的需求建立問題。此外，您可以將這些問題指派給 Amazon Q。如果您將問題指派給 Amazon Q，則會嘗試建立草稿解決方案供您評估。這可協助您和您的團隊專注於和最佳化需要您注意的問題，而 Amazon Q 可為您沒有資源可立即解決的問題提供解決方案。

**注意**  
**採用 Amazon Bedrock 技術**： AWS 實作[自動濫用偵測](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html)。由於**為我撰寫說明**、**建立內容摘要**、**建議的任務**、**使用 Amazon Q 建立或新增功能至專案**，以及**將問題指派給 Amazon Q** 功能，搭配適用於軟體開發的 Amazon Q Developer 代理程式功能建置在 Amazon Bedrock 上，因此使用者可以充分利用 Amazon Bedrock 中實作的控制措施，來加強安全性、資安和負責任的人工智慧 (AI) 運用。

以下是一些最佳實務，可協助您使用 Amazon Q 建立專案和新增藍圖。

**重要**  
生成式 AI 功能僅適用於美國西部 （奧勒岡） 區域。
+ **使用 Amazon Q 提供的預設提示**。Amazon Q 最適合從提供的提示中選擇藍圖。
+ **使用 Amazon Q 建議的組態選項來預覽藍圖**。選擇藍圖以預覽藍圖將建立的範例程式碼和資源。
+ **使用為 Amazon Q 啟用的空間**。若要使用 Amazon Q 建立專案，或使用 Amazon Q 將功能新增至具有藍圖的專案，請使用針對生成式 AI 功能啟用的空間。如需詳細資訊，請參閱[啟用或停用空間的生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)。
+ **取得 Amazon Q 建議藍圖的詳細資訊**。 您可能想要進一步了解使用特定建議藍圖建立的專案資源、範例程式碼和元件類型。如需 CodeCatalyst 中可用藍圖的詳細資訊，請參閱 [使用 CodeCatalyst 藍圖建立全面的專案使用藍圖建立全面的專案](project-blueprints.md)。
+ **允許 Amazon Q 處理問題**。允許 Amazon Q 為您建立問題、指派這些問題並追蹤這些問題。如需詳細資訊，請參閱[教學課程：使用 CodeCatalyst 生成式 AI 功能來加速開發工作](getting-started-project-assistance.md)。
+ **從不再處理的問題取消指派 Amazon Q**。完成範例後，請取消指派 Amazon Q 以解決任何不再處理的問題。如果 Amazon Q 已完成問題的工作或找不到解決方案，請務必取消指派 Amazon Q，以避免達到生成式 AI 功能的最大配額。如需詳細資訊，請參閱[管理生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)和[定價](https://codecatalyst.aws/explore/pricing)。
+ **檢視 Amazon Q 的用量**。 您可以在使用者層級檢視生成式 AI 功能的使用情況。前往**我的設定**以管理生成式 AI 配額，並依您的建置器 ID 或單一登入 (SSO) 身分檢視用量。如需詳細資訊，請參閱[檢視空間中生成式 AI 功能的使用情況](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-view-usage)。

**重要**  
CodeCatalyst 中的生成式 AI 功能受配額限制。如需詳細資訊，請參閱 [Amazon Q 開發人員定價](https://aws.amazon.com/q/developer/pricing/)、[啟用或停用空間的生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)，以及[帳單](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)。

## 搭配專案使用藍圖的最佳實務
<a name="projects-create-use-blueprints"></a>

以下是一些最佳實務，可協助您建立具有藍圖的專案或新增藍圖。
+ **使用 CodeCatalyst 提供的藍圖來建立或新增至專案**。您可以使用藍圖，為開發人員建立具有原始程式碼和資源的完整專案。例如，Web 應用程式藍圖會建立應用程式和基礎設施資源，並部署 Web 應用程式。您可以使用藍圖建立專案，或將自訂藍圖新增至現有專案。如需詳細資訊，請參閱[使用藍圖建立專案](create-project-with-bp.md)。檢視 CodeCatalyst 中的任何藍圖，以預覽藍圖將建立的範例程式碼和資源。
+ **使用您組織設計的自訂藍圖**。您可以使用自訂藍圖，在空間中建立完整的專案。您的組織設計的自訂藍圖可以提供標準化和最佳實務，這也有助於減少設定新專案的工作量。身為自訂藍圖作者，您可以檢視整個空間使用藍圖的專案詳細資訊。生命週期管理可讓您集中管理每個專案的軟體開發生命週期，而藍圖使用者可以利用生命週期管理，從更新的藍圖選項或版本重新產生程式碼庫。如需詳細資訊，請參閱[以藍圖作者身分使用生命週期管理](lifecycle-management-dev.md)。
+ **將開發人員角色或適當的 IAM 角色新增至專案的帳戶**。在專案建立步驟期間或之後，您可以在連線至空間 AWS 帳戶 的 中選擇或建立 IAM 角色，以設定藍圖許可。

## 將資源和任務新增至已建立的專案
<a name="projects-create-after-steps"></a>

專案準備就緒後，您可以新增資源和任務。
+ 若要了解使用專案建立的 CI/CD 工作流程，請參閱 [工作流程入門](workflows-getting-started.md)。
+ 若要使用與新專案類似的建置動作，將建置成品部署到 Amazon S3 儲存貯體，請參閱 [使用工作流程建置](build-workflow-actions.md)和 [教學課程：將成品上傳至 Amazon S3](build-deploy.md)。
+ 若要從空專案開始，並使用堆疊部署來 CloudFormation 部署類似的無伺服器應用程式，請參閱 [教學課程：部署無伺服器應用程式](deploy-tut-lambda.md)。
+ 若要新增規劃電路板的問題，請參閱 [追蹤和組織 CodeCatalyst 中的問題追蹤和組織處理問題的工作](issues.md)。
+ 若要檢視專案概觀、專案狀態、最近的團隊活動和指派的工作，請參閱 [取得專案清單](projects-view.md)。
+ 若要檢視原始碼或建立提取請求，請參閱 [將程式碼與 CodeCatalyst 中的來源儲存庫一起存放和協作儲存程式碼並與來源儲存庫協作](source.md)。
+ 若要設定傳送工作流程執行成功或失敗狀態提醒的通知，請參閱 [從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。
+ 若要邀請成員加入您的專案，請參閱 [授予使用者專案許可](projects-members.md)。
+ 若要設定開發環境，請參閱 [在 CodeCatalyst 中使用開發環境撰寫和修改程式碼使用開發環境撰寫和修改程式碼](devenvironment.md)。

# 取得專案清單
<a name="projects-view"></a>

您可以從 CodeCatalyst 空間檢視您擁有專案許可的每個專案的詳細資訊。

若要檢視專案，您必須是專案的成員，或具有空間的 **Space 管理員**角色。

如果您尚未建立專案，請參閱 [建立專案](projects-create.md)。您必須擁有要建立專案之空間的空間**管理員**角色。
+ 在專案概觀上，您可以檢視專案成員、來源儲存庫、工作流程執行、開啟提取請求、專案開發環境和問題。
+ 在專案設定下，您可以檢視和管理專案詳細資訊、刪除專案、邀請新成員加入專案、管理專案成員，以及設定通知。

## 檢視專案任務和開發環境
<a name="projects-view-overview-tasks"></a>

若要檢視專案任務的摘要，例如指派給您或由您建立的開啟問題和提取請求，以及專案相關聯的開發環境，請使用 主控台。

若要檢視專案，您必須是專案的成員，或具有空間的 **Space 管理員**角色。

**檢視您的來源儲存庫、工作流程執行、問題、提取請求、開發環境和問題**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**概觀**。

1. 檢視指派給您的專案任務，並由您建立。
   + 檢視**成員 \$1 檢視所有**清單以檢視專案成員的清單。
   + 檢視**儲存庫**卡片，以檢視與專案相關聯的來源儲存庫。
   + 檢視**工作流程執行**卡以檢視與專案相關聯的工作流程。
   + 檢視**開啟提取請求**卡片，以檢視程式碼儲存庫狀態的摘要，以及為您指派和建立的提取請求。
   + 檢視**我的開發環境**卡，以檢視與專案相關聯的開發環境摘要。
   + 檢視**問題**卡片，以檢視所指派任務或您所建立任務的摘要。

# 檢視空間中的所有專案
<a name="projects-view-overview"></a>

在空間的**專案**清單中，您可以檢視您擁有許可的所有專案。

若要檢視專案任務的摘要，例如指派給您或由您建立的開啟問題和提取請求，以及專案相關聯的開發環境，請使用 主控台。

若要檢視專案，您必須是專案的成員，或具有空間的 **Space 管理員**角色。

**檢視您的來源儲存庫、工作流程執行、問題、提取請求、開發環境和問題**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 檢視專案名稱、路徑、專案 ID 和描述。

## 檢視專案設定
<a name="projects-view-settings"></a>

在**專案設定**中，您可以檢視專案成員、來源儲存庫、工作流程執行、開啟提取請求、專案開發環境和問題。

若要檢視專案任務的摘要，例如指派給您或由您建立的開啟問題和提取請求，以及專案相關聯的開發環境，請使用 主控台。

**檢視您的來源儲存庫、工作流程執行、問題、提取請求、開發環境和問題**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 檢視專案名稱、路徑、專案 ID 和描述。

## 在 CodeCatalyst 中變更為不同的專案
<a name="projects-view-switch"></a>

若要變更為不同的專案，請使用 主控台從您有權存取的專案清單中選擇。

**變更為不同的專案**

1. 在 CodeCatalyst 主控台中，選擇頂端的專案選擇器。

1. 展開下拉式清單，然後選擇您要導覽的專案。

# 刪除專案
<a name="projects-delete"></a>

您可以刪除專案，以移除對專案資源的所有存取權。您必須擁有空間管理員或專案管理員角色，才能刪除專案。刪除專案後，專案成員將無法存取專案資源，而且第三方來源儲存庫提示的任何工作流程都將停止。

**刪除您的專案**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**刪除專案**。

1. 輸入 **delete** 以確認刪除。

1. 選擇**刪除專案**。

# 授予使用者專案許可
<a name="projects-members"></a>

您可以使用 Amazon CodeCatalyst 主控台來管理專案中的成員。您可以新增或移除使用者、管理目前成員的角色、傳送加入專案的邀請，以及取消尚未接受的邀請。

在空間和專案使用者的成員頁面上，使用者可以擁有多個角色。具有多個角色的使用者在擁有多個角色時會顯示 指標，而且他們會先以具有最多許可的角色顯示。

## 取得成員及其專案角色的清單
<a name="projects-members-view"></a>

當您將使用者新增至專案時，您會指派授予專案許可的角色，如下所示：
+ **專案管理員**角色具有專案中的所有許可。僅將此角色指派給需要管理專案各方面的使用者，包括編輯專案設定、管理專案許可，以及刪除專案。如需詳細資訊，請參閱[專案管理員角色](ipa-role-types.md#ipa-role-project-admin)。
+ **貢獻者**角色具有在專案中運作所需的許可。將此角色指派給需要在專案中使用程式碼、工作流程、問題和動作的使用者。如需詳細資訊，請參閱[貢獻者角色](ipa-role-types.md#ipa-role-contributor)。
+ **檢閱者**角色具有檢閱許可。如需詳細資訊，請參閱[檢閱者角色](ipa-role-types.md#ipa-role-reviewer)。
+ **唯讀**角色具有讀取許可。如需詳細資訊，請參閱[唯讀角色](ipa-role-types.md#ipa-role-read-only)。

您不需要邀請具有 **Space 管理員**角色的使用者加入您的專案，因為他們已經具有空間中所有專案的隱含存取權。

當您邀請使用者加入您的專案 （不指派**空間管理員**角色） 時，使用者會顯示在專案下方的**專案成員**資料表中，以及在空格下方的**專案成員**資料表中。

**檢視空間中的使用者和角色**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**成員**索引標籤。

   **專案成員**表格顯示專案中具有角色的所有成員。
**提示**  
如果您有 **Space 管理員**角色，您可以檢視您直接受邀參加的專案。導覽至專案的**專案設定**，然後選擇**我的專案**。

   **空間管理員**資料表顯示具有**空間管理員**角色的使用者。這些使用者會自動 （隱含） 指派給空間中的所有專案，而且在專案中沒有角色。

   在**狀態**欄中，下列為有效值：
   + **已邀請** – CodeCatalyst 已傳送邀請，但使用者尚未接受或拒絕。
   + **成員** – 使用者接受邀請。

**Topics**
+ [取得成員及其專案角色的清單](#projects-members-view)
+ [邀請使用者加入專案](#projects-members-add)
+ [取消邀請](#projects-members-cancel-invite)
+ [從專案中移除使用者](#projects-members-remove)
+ [接受或拒絕專案的邀請](#w2aac27c19c15c25)

## 邀請使用者加入專案
<a name="projects-members-add"></a>

您可以使用 主控台來邀請使用者加入您的專案。您可以邀請空間的成員，或從空間外部新增名稱。

若要邀請使用者加入您的專案，您必須使用**專案管理員**或**空間管理員**角色登入。

您不需要邀請具有 **Space 管理員**角色的使用者加入您的專案，因為他們已經具有空間中所有專案的隱含存取權。

當您邀請使用者加入您的專案 （不指派**空間管理員**角色） 時，使用者會顯示在專案下方的**專案成員**資料表中，以及在空格下方的**專案成員**資料表中。

**從專案設定索引標籤邀請成員加入您的專案**

1. 導覽至您的專案。
**提示**  
您可以在頂端導覽列中選擇要檢視的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**成員**索引標籤。

1. 在**專案成員**中，選擇**邀請新成員**。

1. 輸入新成員的電子郵件地址，選擇此成員的角色，然後選擇**邀請**。如需角色的詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。

**從專案概觀頁面邀請成員加入您的專案**

1. 導覽至您的專案。
**提示**  
您可以在頂端導覽列中選擇要檢視的專案。

1. 選擇**成員 \$1** 按鈕。

1. 輸入新成員的電子郵件地址，為此成員選擇角色，然後選擇**邀請**。如需角色的詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。

## 取消邀請
<a name="projects-members-cancel-invite"></a>

如果您最近傳送邀請，只要邀請尚未被接受，您就可以取消該邀請。

若要管理專案邀請，您必須擁有**專案管理員**或**空間管理員**角色。

**取消專案成員邀請**

1. 導覽至您已傳送要取消之邀請的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 檢視**成員**索引標籤，並確認成員的狀態為**已邀請**。
**注意**  
您只能取消尚未接受的邀請。

1. 選擇受邀成員列旁的選項，然後選擇**取消邀請**。

1. 確認視窗隨即顯示。選擇**取消邀請**以確認。

## 從專案中移除使用者
<a name="projects-members-remove"></a>

您可以使用 主控台從專案中移除使用者。

若要從專案中移除使用者，您必須使用**專案管理員**或**空間管理員**角色登入。

**注意**  
從空間中的所有專案中移除使用者會自動從該空間移除使用者。

**從專案中移除使用者**

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**成員**索引標籤。

1. 選擇您要移除之設定檔旁的選擇器，然後選擇**移除**。

1. 確認您想要移除使用者，然後選擇**移除**。

## 接受或拒絕專案的邀請
<a name="w2aac27c19c15c25"></a>

您可能會收到加入 Amazon CodeCatalyst 專案的電子郵件邀請。您可以接受或拒絕邀請。

**接受或拒絕邀請**

1. 開啟邀請電子郵件。

1. 選擇電子郵件中的專案連結。

1. 選擇**接受****或拒絕**。

   如果您選擇**拒絕**，系統會傳送電子郵件至專案管理帳戶，通知他們您拒絕邀請。

# 使用 團隊允許專案存取
<a name="projects-teams"></a>

建立專案之後，您可以新增團隊。團隊可讓您將使用者分組，讓他們可以共用許可，並以專案和空間成員身分在 CodeCatalyst 中管理專案、問題追蹤、角色和資源。

您必須擁有**專案管理員**角色，才能管理專案的團隊。

團隊也會在 CodeCatalyst 的空間層級進行管理。若要進一步了解空間中的團隊，請參閱 [使用 團隊允許空間存取](managing-teams.md)。

**Topics**
+ [將團隊新增至專案](projects-teams-add.md)
+ [授予團隊專案角色](projects-teams-project-roles.md)
+ [移除團隊的專案角色](projects-teams-remove.md)

# 將團隊新增至專案
<a name="projects-teams-add"></a>

您可以管理團隊成員可以存取專案中資源的團隊。

在空間和專案使用者的成員頁面上，使用者可以擁有多個角色。具有多個角色的使用者在擁有多個角色時會顯示 指標，而且他們會先顯示具有最多許可的角色。

**新增團隊**

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

1. 導覽至您的專案。選擇**專案設定**，然後選擇**團隊**。

1. 選擇**新增團隊**。

1. 在**團隊**中，從可用的團隊清單中選擇團隊。

1. 在**專案角色**下，從 CodeCatalyst 中可用的專案角色清單中選擇角色。
   + **專案管理員** — 如需詳細資訊，請參閱 [專案管理員角色](ipa-role-types.md#ipa-role-project-admin)。
   + **貢獻者** — 如需詳細資訊，請參閱 [貢獻者角色](ipa-role-types.md#ipa-role-contributor)。
   + **檢閱者** — 如需詳細資訊，請參閱 [檢閱者角色](ipa-role-types.md#ipa-role-reviewer)。
   + **唯讀** — 如需詳細資訊，請參閱 [唯讀角色](ipa-role-types.md#ipa-role-read-only)。

1. 選擇**新增團隊**。

# 授予團隊專案角色
<a name="projects-teams-project-roles"></a>

團隊可以在空間中擁有角色許可，例如 **Power 使用者**。您可以變更團隊的空間角色，但請注意，團隊的所有成員都會繼承這些許可。

**新增或變更專案角色**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的空間。選擇**專案設定**，然後選擇**團隊**。

1. 若要變更角色，請選擇此清單中團隊旁邊的選擇器，然後選擇**變更角色**。若要新增角色，請選擇**新增專案角色**。在**專案**中，選擇您要新增的專案，然後在**角色**中選擇角色。選擇其中一個可用的專案角色：
   + **專案管理員** - 如需詳細資訊，請參閱 [專案管理員角色](ipa-role-types.md#ipa-role-project-admin)。
   + **貢獻者** - 如需詳細資訊，請參閱 [貢獻者角色](ipa-role-types.md#ipa-role-contributor)。
   + **檢閱者** - 如需詳細資訊，請參閱 [檢閱者角色](ipa-role-types.md#ipa-role-reviewer)。
   + **唯讀** - 如需詳細資訊，請參閱 [唯讀角色](ipa-role-types.md#ipa-role-read-only)。

1. 選擇**儲存**。

# 移除團隊的專案角色
<a name="projects-teams-remove"></a>

在 CodeCatalyst 中，您可以檢視團隊的專案角色。您也可以檢視團隊中的成員。您可以移除團隊的專案角色。

**移除專案角色**

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

1. 導覽至您的空間。選擇**專案設定**，然後選擇**團隊**。

1. 選擇**專案角色**索引標籤。

1. 選擇您要移除的角色。
**重要**  
從團隊移除角色會移除團隊中所有使用者的相關聯許可。

1. 選擇**儲存**。

# 允許機器資源的專案存取
<a name="projects-machine-resources"></a>

機器資源是 CodeCatalystthat可授予 CodeCatalyst 中專案或空間的許可。

**注意**  
機器資源一詞不是指雲端基礎設施，例如 EC2 執行個體，而是用來參考具有空間或專案許可的藍圖或工作流程資源。

在專案中使用機器資源的範例包括啟用藍圖資源來代表您存取專案。

透過 SSO 存取 CodeCatalyst 時，機器資源會代表您授權資源的身分。機器資源用於將許可授予專案中的資源，例如**藍圖**和**工作流程**。您可以檢視專案中的機器資源，也可以選擇啟用或停用專案的機器資源。例如，您可能想要停用機器資源來管理存取，然後稍後重新啟用。

如果需要撤銷或停用機器資源，這些操作可用於機器資源。例如，如果您懷疑登入資料可能已洩露，您可以停用機器資源。一般而言，不需要使用這些操作。

您必須擁有**空間管理員**角色或**專案管理員**角色，才能檢視此頁面，以及在專案層級管理機器資源。

CodeCatalyst 中的機器資源也會在空間層級進行管理。若要進一步了解空間/專案中的團隊，請參閱 [允許機器資源的空間存取](managing-machine-resources.md)。

**Topics**
+ [檢視機器資源的專案存取權](projects-machine-resources-view.md)
+ [停用機器資源的專案存取](projects-machine-resources-disable.md)
+ [啟用機器資源的專案存取](projects-machine-resources-enable.md)

# 檢視機器資源的專案存取權
<a name="projects-machine-resources-view"></a>

您可以檢視專案中正在使用的機器資源清單。

您必須擁有**空間管理員**角色或**專案管理員**角色。

**檢視機器資源**

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

1. 導覽至您的專案，然後選擇**專案設定**。選擇**機器資源**。

1. 在下拉式清單中，選擇**工作流程動作**，以僅檢視工作流程的機器資源。選擇**藍圖**，僅檢視藍圖的機器資源。

   您也可以使用篩選條件欄位來**篩選**名稱。

# 停用機器資源的專案存取
<a name="projects-machine-resources-disable"></a>

您可以選擇停用專案中正在使用的機器資源。

**重要**  
停用機器資源會移除空間中所有相關聯藍圖或工作流程的所有許可。

您必須擁有**空間管理員**角色或**專案管理員**角色。

**停用機器資源**

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

1. 導覽至您的專案，然後選擇**專案設定**。選擇**機器資源**。

1. 選擇下列其中一項。
**重要**  
停用機器資源會移除空間中所有相關聯藍圖或工作流程的所有許可。
   + 若要個別停用，請選擇您要停用的一或多個機器資源旁的選擇器。選擇**停用**，然後選擇**此資源**。
   + 若要停用所有資源，請選擇**停用**，然後選擇**所有資源**。
   + 若要停用所有工作流程動作，請選擇**停用**，然後選擇**所有工作流程動作**。
   + 若要停用所有藍圖，請選擇**停用**，然後選擇**所有藍圖**。

# 啟用機器資源的專案存取
<a name="projects-machine-resources-enable"></a>

您可以選擇啟用專案中正在使用且已停用的機器資源。

您必須擁有**空間管理員**角色或**專案管理員**角色。

**啟用機器資源**

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

1. 導覽至您的專案，然後選擇**專案設定**。選擇**機器資源**。

1. 選擇下列其中一項。
   + 若要個別啟用，請選擇您要啟用的一或多個機器資源旁的選擇器。選擇**啟用**，然後選擇**此資源**。
   + 若要啟用所有資源，請選擇**啟用**，然後選擇**所有資源**。
   + 若要啟用所有工作流程動作，請選擇**啟用**，然後選擇**所有工作流程動作**。
   + 若要啟用所有藍圖，請選擇**啟用**，然後選擇**所有藍圖**。

# 專案配額
<a name="projects-quotas"></a>

下表說明 Amazon CodeCatalyst 中專案的配額和限制。如需 Amazon CodeCatalyst 中配額的詳細資訊，請參閱 [CodeCatalyst 的配額](quotas.md)。


|  |  | 
| --- |--- |
| 每個空間的專案數量上限 | 100 | 
| 使用者可以所屬的專案數量上限 | 1,000 | 
| 可屬於專案的成員數目上限。 | 10,000 | 
| 專案名稱 |  專案名稱在空格內必須是唯一的。名稱必須介於 3 到 63 個字元之間。名稱區分大小寫。專案名稱必須以英數字元開頭。有效字元：**A-Z、a-z、0-9、空格**和 **.、\$1 （底線） - （連字號）** 專案名稱不能包含下列任何字元： `! ? @ # $ % ^ & * ( ) + = { } [ ] \| \ / > < ~ ` ' " ; : `  | 
| 專案說明 |  專案描述最多可達 200 個字元。有效字元：**A-Z、a-z、0-9、空格**和 **.、\$1 （底線） - （連字號）**。專案說明為選擇性。  | 

# 從 CodeCatalyst 傳送通知
<a name="notifications"></a>

您可以設定通知來監控 CodeCatalyst 中的專案和資源。使用者可以選擇要在任何他們是成員的專案中接收電子郵件的專案事件。您也可以透過設定 CodeCatalyst 空間和 Slack 工作區之間的存取權，然後設定要傳送至該 Slack 工作區中一或多個頻道的專案通知，來選擇在 Slack 等團隊傳訊應用程式中設定傳送至整個團隊的通知。設定 CodeCatalyst 空間和 Slack 工作區之間的存取權後，專案成員也可以選擇新增自己的 Slack 成員 IDs，以便他們可以直接收到連線 Slack 工作區和頻道中 CodeCatalyst 事件的通知。

**注意**  
可傳送至 Slack 的一組專案事件與使用者可以選擇在電子郵件中收到通知的一組事件不同。

**Topics**
+ [通知如何運作？](notifications-concepts.md)
+ [Slack 通知入門](getting-started-notifications.md)
+ [從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)

# 通知如何運作？
<a name="notifications-concepts"></a>

您可以設定專案，向團隊傳訊應用程式提供通知，例如 Slack。



## 通知需要哪些許可？
<a name="notifications-concepts-permissions"></a>

任何專案成員都可以在 CodeCatalyst 中設定、檢視、更新或刪除頻道的通知設定。不過，只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。所有使用者都可以為他們屬於 CodeCatalyst 的專案設定要接收電子郵件的專案事件。

## 我可以設定哪些 CodeCatalyst 事件的通知？
<a name="notifications-concepts-events"></a>

您可以設定 CodeCatalyst，將有關工作流程事件的通知傳遞至一或多個 Slack 頻道。在 CodeCatalyst 專案和 Slack 之間設定通知後，專案使用者可以選擇新增自己的 Slack 成員 ID，以便在 Slack 頻道中接收有關 CodeCatalyst 事件的直接訊息。新增其 Slack IDs 的使用者，將在為其專案設定的 Slack 頻道中收到對其 IDs 的直接提及，協助提高他們關注之事件的意識。

您也可以選擇要接收電子郵件的事件。這些電子郵件會傳送到為您的 AWS 建置器 ID 設定的電子郵件地址。

## 如何呈現通知？
<a name="notifications-concepts-delivery"></a>

您可以設定 CodeCatalyst 將通知傳送到一或多個 Slack 頻道。您需要授權 CodeCatalyst 授予存取 Slack 工作區的許可。一旦提供授權，CodeCatalyst 就可以將通知傳送到您設定的 Slack 頻道。如果專案成員選擇新增其 Slack 成員 ID，他們可以在為該專案設定的 Slack 頻道中收到有關 CodeCatalyst 事件的提及。

## 如何設定通知？
<a name="notifications-concepts-setup"></a>

電子郵件通知會設定為 CodeCatalyst 的一部分。專案使用者可以在**我的設定**頁面中選擇想要接收電子郵件的事件。

若要為您的專案資源設定 Slack 通知，您必須完成下列高階任務。

**設定通知 （高階任務）**

1. 在 CodeCatalyst 中，您可以**設定 CodeCatalyst 與簡訊用戶端之間的連線**，例如 Slack。 CodeCatalyst 連接 Slack 工作區後，它將可供空間中的所有專案使用。
**注意**  
只有具有 Space 管理員角色的使用者才能新增或刪除 Slack 工作區。

1. 在 CodeCatalyst 的專案**中，新增您希望團隊接收通知的管道**。

1. 在 CodeCatalyst 中，您可以**開啟各種事件的通知**，例如工作流程執行失敗，並指定要傳送它們的管道。

如需詳細步驟，請參閱[Slack 通知入門](getting-started-notifications.md)。

在 CodeCatalyst 空間和 Slack 之間設定通知後，使用者可以選擇新增自己的 Slack IDs，以在為其專案設定的 Slack 頻道中接收有關 CodeCatalyst 事件的直接訊息。

# Slack 通知入門
<a name="getting-started-notifications"></a>

建立專案後，您可以設定 Slack 通知，以協助您的團隊監控專案資源。

這些步驟會逐步引導您首次在 CodeCatalyst 中設定 Slack 通知。如果您已設定通知，請參閱 [從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

**注意**  
可傳送至通知管道的一組專案事件與使用者可以選擇在電子郵件中收到通知的事件組不同。如需詳細資訊，請參閱[從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

**Topics**
+ [先決條件](#getting-started-notifications-prerequisites)
+ [步驟 1：將 CodeCatalyst 連接至 Slack 工作區](#getting-started-notifications-connect-slack)
+ [步驟 2：將 Slack 頻道新增至 CodeCatalyst](#getting-started-notifications-add-slack-channel)
+ [步驟 3：測試從 CodeCatalyst 到 Slack 的通知](#getting-started-notifications-next-steps)
+ [步驟 4：後續步驟](#getting-started-notifications-test)

## 先決條件
<a name="getting-started-notifications-prerequisites"></a>

開始之前，您必須準備好以下事項：
+ CodeCatalyst 空間。如需有關建立 CodeCatalyst 空間和首次登入的資訊，請參閱 [設定並登入 CodeCatalyst設定並登入 CodeCatalyst](setting-up-topnode.md)。
+ CodeCatalyst 專案。如需詳細資訊，請參閱[建立專案](projects-create.md)。
+ 具有**專案管理員**或**空間管理員**角色的 CodeCatalyst 帳戶。如需詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。
+ CodeCatalyst 可存取的 Slack 帳戶和 Slack 工作區。
+ CodeCatalyst 將傳送通知的 Slack 頻道。頻道可以是公有或私有。

## 步驟 1：將 CodeCatalyst 連接至 Slack 工作區
<a name="getting-started-notifications-connect-slack"></a>

只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。新增或刪除 Slack 工作區會影響空間中的所有專案。為了在 CodeCatalyst 和 Slack 之間建立連線，CodeCatalyst 會與您的 Slack 工作區執行安全的 OAuth 身分驗證交握。

使用下列指示將 CodeCatalyst 連接至 Slack 工作區。

**注意**  
這只需要為每個 Slack 工作區執行一次。然後，您可以依 Slack 頻道設定通知。

**將 CodeCatalyst 連接到 Slack 工作區**

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

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇**設定通知**。

1. 選擇**連線至 Slack 工作區**。

1. 讀取對話方塊內容，然後選擇**連線至 Slack 工作區**。

1. 在**聊天應用程式訊息中的 Amazon Q Developer** 上：

   1. 在右上角，選擇包含頻道的 Slack 工作區。

   1. 選擇 **Allow** (允許)。

   您將返回 CodeCatalyst 主控台。

1. 繼續進行[步驟 2：將 Slack 頻道新增至 CodeCatalyst](#getting-started-notifications-add-slack-channel)。

## 步驟 2：將 Slack 頻道新增至 CodeCatalyst
<a name="getting-started-notifications-add-slack-channel"></a>

您需要 Slack 頻道 ID 才能將頻道新增至 CodeCatalyst。

**取得您的 Slack 頻道 ID**

1. 登入 Slack。如需詳細資訊，請參閱[登入 Slack](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 前往包含您希望通知前往之頻道的 Slack 工作區。如需詳細資訊，請參閱在 [Slack 工作區之間切換](https://slack.com/help/articles/1500002200741-Switch-between-workspaces)或[登入其他 Slack 工作區](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 在導覽窗格中，開啟您要通知前往的頻道內容 （按一下滑鼠右鍵） 選單，然後選擇**開啟頻道詳細資訊**。

   頻道 ID 會顯示在對話方塊底部。

1. 複製**頻道 ID** 值。下一個步驟將需要此值。

使用您剛複製的頻道 ID，您現在可以將 Slack 頻道連線至 CodeCatalyst。

**將 Slack 頻道新增至 CodeCatalyst**

1. 開始之前，如果您的 Slack 頻道是私有的，請在聊天應用程式中將 Amazon Q Developer 新增至頻道，如下所示：

   1. 在 Slack 頻道的訊息方塊中，輸入 **@aws**，然後從對話方塊中選擇 **aws 應用程式**。

   1. 按 Enter。

      隨即出現 Slackbot 訊息，指出聊天應用程式中的 Amazon Q Developer 不在私有頻道中。

   1. 選擇**邀請他們**，邀請聊天應用程式中的 Amazon Q Developer 加入頻道。

1. 在 CodeCatalyst 主控台中，選擇**下一步**。

1. 在**頻道 ID** 中，貼上您先前取得的 Slack 頻道 ID。

1. 在**頻道名稱**中，輸入名稱。建議使用 Slack 頻道名稱。

1. 選擇**下一步**。

1. 在**選取通知事件**中，選擇您要接收通知的事件類型。

1. 選擇**完成**。

## 步驟 3：測試從 CodeCatalyst 到 Slack 的通知
<a name="getting-started-notifications-next-steps"></a>



將專案設定為傳送工作流程狀態的通知後，您可以在 Slack 中檢視通知。

**在 Slack 中檢視您的通知**

1. 在您的 CodeCatalyst 專案中，[手動啟動工作流程](workflows-manually-start.md)，以完成工作流程執行，並在執行完成時收到狀態通知。

1. 在 Slack 中，檢視您為通知設定的頻道。您的通知會顯示每個工作流程執行的最新狀態，以及是否失敗或成功。

## 步驟 4：後續步驟
<a name="getting-started-notifications-test"></a>

為您的 CodeCatalyst 空間設定 Slack 工作區後，您可以新增額外的 Slack 通道現有 CodeCatalyst 專案，並在建立新專案之後新增這些專案。您也可以讓專案使用者知道他們可以為其 Slack 成員 IDs 設定個人 Slack 通知，並設定他們將收到電子郵件的事件。如需詳細資訊，請參閱[從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

# 從 CodeCatalyst 傳送 Slack 和電子郵件通知
<a name="notifications-manage"></a>

您可以設定 CodeCatalyst 來傳送專案中事件發生的通知。CodeCatalyst 可以傳送通知給簡訊用戶端，例如 Slack 頻道。讓 CodeCatalyst 傳送訊息到 Slack 頻道有助於確保您的整個團隊都知道重要事件，例如工作流程失敗。或者，您可以選擇讓 CodeCatalyst @mention 出現在其傳送的 Slack 訊息中，以便您接收對應的直接訊息 (DM)。

CodeCatalyst 也可以透過電子郵件直接傳送通知給您。電子郵件通知將針對您為成員的任何專案中的事件傳送。這些電子郵件會傳送到您 AWS 建置器 ID 中設定的電子郵件地址。

**注意**  
可傳送至 Slack 頻道的事件可能與透過電子郵件傳送的事件不同。

**Topics**
+ [設定電子郵件通知](notifications-personal.md)
+ [傳送通知至 Slack 頻道](notifications-projects.md)
+ [設定 Slack 直接訊息](notifications-personal-slack.md)
+ [編輯通知管道的通知](notifications-edit.md)
+ [移除頻道](notifications-remove-channel.md)

# 設定電子郵件通知
<a name="notifications-personal"></a>

您可以選擇在身為 成員的任何專案中，將有關事件的電子郵件通知傳送給您。這些電子郵件會傳送到您 AWS 建置器 ID 中設定的電子郵件地址。根據預設，您將收到有關可傳送電子郵件之所有專案事件的電子郵件。<a name="notifications-personal-email"></a>

**設定專案事件的電子郵件通知**

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

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的名稱，以尋找您的使用者設定檔。

1. 在**電子郵件通知**中，在您要設定電子郵件通知的清單中尋找專案，然後選擇**編輯**。

1. 選取您要接收電子郵件的事件，然後選擇**儲存**。

# 傳送通知至 Slack 頻道
<a name="notifications-projects"></a>

您可以設定 CodeCatalyst，將專案事件的通知傳送至團隊的 Slack 頻道。透過這樣做，您可以協助確保整個團隊了解重要事件，例如工作流程執行失敗時。

**注意**  
專案的任何成員都可以管理傳送至該專案頻道的通知。不過，只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。

使用下列指示來新增通知將傳送至其中的 Slack 頻道。

**新增通知的 Slack 頻道**

1. 如果您要新增第一個 Slack 頻道，請改為參閱 [Slack 通知入門](getting-started-notifications.md)。

   設定第一個頻道後，請返回此程序以設定其他頻道。

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇 **Add channel** (新增頻道)。

1. 選擇**選擇工作區**，然後選取包含您要傳送通知之頻道的 Slack 工作區。

   如果您的 Slack 工作區不在清單中，您可以依照 中的指示新增它[Slack 通知入門](getting-started-notifications.md)。

1. 在輸入**頻道 ID** 之前，如果您要新增的 Slack 頻道是私有的，請完成以下步驟：

   1. 在 Slack 頻道的訊息方塊中，輸入 **@aws**，然後從快顯視窗中選擇 **aws 應用程式**。

   1. 按 Enter。

      隨即出現 Slackbot 訊息，指出聊天應用程式中的 Amazon Q Developer 不在私有頻道中。

   1. 選擇**邀請他們**，邀請聊天應用程式中的 Amazon Q Developer 加入頻道。

1. 在 CodeCatalyst 的**頻道 ID** 欄位中，輸入 Slack 頻道 ID。若要尋找 ID，請前往 Slack，然後在導覽窗格中，在頻道上按一下滑鼠右鍵，然後選擇**開啟頻道詳細資訊**。

   頻道 ID 會顯示在對話方塊底部。

1. 在**頻道名稱**中，輸入名稱。建議使用 Slack 頻道名稱。

1. 在**選取通知事件**中，選擇要接收通知的事件類型。

1. 選擇**新增**。

# 設定 Slack 直接訊息
<a name="notifications-personal-slack"></a>

如果 CodeCatalyst 專案已設定為[傳送通知至 Slack 頻道](notifications-projects.md)，這些通知也可以做為直接訊息 (DMs傳送。以 DMs 身分直接傳送通知給您，有助於提高您擁有角色之專案中發生的事件意識。若要啟用 DMs，您必須將 Slack 成員 ID 新增至 CodeCatalyst。

**設定 Slack 直接訊息**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的姓名，以尋找您的使用者設定檔。

1. 在**個人 Slack 通知**中，選擇**連線 Slack ID**，然後選擇**連線至 Slack 工作區**。將開啟單獨的視窗。
**提示**  
除非具有 **Space 管理員**角色的使用者已為您的 CodeCatalyst 空間新增 Slack 工作區，否則此選項無法設定。如需詳細資訊，請參閱 [Slack 通知入門](getting-started-notifications.md) 和 [傳送通知至 Slack 頻道](notifications-projects.md)。

1. 在許可請求視窗中，請確定工作區的名稱符合針對 CodeCatalyst 空間設定的 Slack 工作區。選擇**允許**以允許聊天應用程式中的 Amazon Q Developer 存取工作區。視窗會關閉，Slack 工作區會顯示 **Connnection 狀態**為**已連線**。
**提示**  
如果連線狀態未變更，請檢查連線 Slack 工作區時發生錯誤。您可能需要向上捲動才能看到錯誤。

1. 若要停止接收個人 Slack 通知，請選擇連接的 Slack 工作區，然後選擇**中斷連線 Slack ID**。

# 編輯通知管道的通知
<a name="notifications-edit"></a>

您可以變更通知前往哪些頻道，也可以完全關閉特定通知。

**編輯通知**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇**編輯通知**。

1. 執行以下任意一項：
   + 若要將通知傳送至特定頻道，請從下拉式清單中選擇頻道。
   + 若要全域關閉通知，請選擇通知旁的切換開關。
   + 若要停止傳送通知至特定頻道，請選擇頻道上的 **X**。

1. 選擇 **Save** (儲存)。

# 移除頻道
<a name="notifications-remove-channel"></a>

您可以從 Amazon CodeCatalyst 移除 Slack 頻道。透過移除 Slack 頻道，所選 CodeCatalyst 專案的通知將不再傳送至頻道。

**移除頻道**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。在導覽窗格中，選擇**專案設定**。

1. 在**專案設定**頁面上，選擇**通知**索引標籤。

1. 選擇您要移除的頻道旁的指標，然後選擇**移除頻道**。在確認視窗中選擇**確定**。