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

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

# 建立專案
<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)。