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

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

# 教學課程：從空專案開始，並手動新增資源
<a name="getting-started-blank-template"></a>

您可以在建立專案時選擇**空白專案**藍圖，建立不含任何預先定義資源的空白專案。建立空專案後，您可以根據專案需求建立資源並將其新增至其中。由於在沒有藍圖的情況下建立的專案在建立時是空的，此選項需要更多建立和設定 CodeCatalyst 資源的知識才能開始使用。

**Topics**
+ [先決條件](#getting-started-bt-prerequisites)
+ [建立空專案](#getting-started-bt-proj-create)
+ [建立來源儲存庫](#getting-started-bt-source-create)
+ [建立工作流程以建置、測試和部署程式碼變更](#getting-started-bt-workflow-create)
+ [邀請某人加入您的專案](#getting-started-bt-ipa-user)
+ [建立問題以協同合作和追蹤工作](#getting-started-bt-issue)

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

若要建立空專案，您必須將 **Space 管理員**或 **Power 使用者**角色指派給您。如果這是您第一次登入 CodeCatalyst，請參閱 [設定並登入 CodeCatalyst設定並登入 CodeCatalyst](setting-up-topnode.md)。

## 建立空專案
<a name="getting-started-bt-proj-create"></a>

建立專案是能夠一起工作的第一步。如果您想要建立自己的資源，例如來源儲存庫和工作流程，您可以從空專案開始。

**建立空專案**

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

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

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

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

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

現在您有一個空的專案，下一個步驟是建立來源儲存庫。

## 建立來源儲存庫
<a name="getting-started-bt-source-create"></a>

建立來源儲存庫來存放和協作專案的程式碼。專案成員可以將此儲存庫複製到其本機電腦，以處理程式碼。或者，您可以選擇連結受支援服務中託管的儲存庫，但本教學課程未涵蓋此項目。如需詳細資訊，請參閱[連結來源儲存庫](source-repositories-link.md)。

**建立來源儲存庫**

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

1. 導覽至您的專案。

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

1. 選擇**新增儲存庫**，然後選擇**建立儲存庫**。

1. 在**儲存庫名稱**中，提供儲存庫的名稱。在本指南中，我們使用 *codecatalyst-source-repository*，但您可以選擇不同的名稱。儲存庫名稱在專案中必須是唯一的。如需儲存庫名稱需求的詳細資訊，請參閱 [CodeCatalyst 中來源儲存庫的配額](source-quotas.md)。

1. （選用） 在**描述**中，新增儲存庫的描述，以協助專案中的其他使用者了解儲存庫的用途。

1. 選擇**建立儲存庫 （預設）**。此選項會建立包含預設分支和 README.md 檔案的儲存庫。與空儲存庫不同，您可以在建立儲存庫後立即使用此儲存庫。

1. 在**預設分支**中，除非您有理由選擇不同的名稱，否則請將名稱保留為*主要*名稱。本指南中的範例都使用預設分支*的主*名稱。

1. （選用） 針對您計劃推送的程式碼類型新增`.gitignore`檔案。

1. 選擇**建立**。
**注意**  
CodeCatalyst 會在您建立檔案時，將`README.md`檔案新增至您的儲存庫。CodeCatalyst 也會在名為 **main** 的預設分支中為儲存庫建立初始遞交。您可以編輯或刪除 README.md 檔案，但無法刪除預設分支。

您可以建立開發環境，在儲存庫中快速新增程式碼。在本教學課程中，建議您使用 建立開發環境 AWS Cloud9，並在建立開發環境時選擇從**主要**分支建立分支的選項。我們**test**使用此分支的名稱，但您可以視需要輸入不同的分支名稱。

**使用新分支建立開發環境**

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

1. 導覽至您要建立開發環境的專案。

1. 從專案的來源儲存庫清單中選擇儲存庫的名稱。或者，在導覽窗格中，選擇**程式碼**、選擇**來源儲存庫**，然後選擇您要為其建立開發環境的儲存庫。

1. 在儲存庫首頁上，選擇**建立開發環境**。

1. 從下拉式選單中選擇支援的 IDE。如需詳細資訊，請參閱[支援開發環境的整合式開發環境](devenvironment-create.md#devenvironment-supported-ide)。

1. 選擇要複製的儲存庫，選擇在**新分支中工作**，在**分支名稱**欄位中輸入分支名稱，然後從從建立分支下拉式功能表中選擇要建立新**分支**的分支。

1. 或者，為開發環境新增別名。

1. 或者，選擇**開發環境組態**編輯按鈕，以編輯開發環境的運算、儲存或逾時組態。

1. 選擇**建立**。建立開發環境時，開發環境狀態欄會顯示**開始**，而狀態欄會在建立開發環境後顯示**執行**中。在您選擇的 IDE 中，新的索引標籤將隨您的開發環境開啟。您可以編輯程式碼並遞交和推送變更。

## 建立工作流程以建置、測試和部署程式碼變更
<a name="getting-started-bt-workflow-create"></a>

在 CodeCatalyst 中，您可以在工作流程中組織應用程式或服務的建置、測試和部署。工作流程由動作組成，可設定為在發生指定的來源儲存庫事件後自動執行，例如程式碼推送或開啟或更新提取請求。如需工作流程的相關詳細資訊，請參閱 [使用工作流程建置、測試和部署使用工作流程建置、測試和部署](workflow.md)。

遵循 中的指示[工作流程入門](workflows-getting-started.md)來建立您的第一個工作流程。

## 邀請某人加入您的專案
<a name="getting-started-bt-ipa-user"></a>

現在您已設定自訂專案，請邀請其他人與您合作。

**邀請某人加入您的專案**

1. 導覽至您要邀請使用者的專案。

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

1. 在**成員**索引標籤上，選擇**邀請**。

1. 輸入您要邀請做為專案使用者之人員的電子郵件地址。您可以輸入多個電子郵件地址，並以空格或逗號分隔。您也可以從不是專案成員的空間成員中進行選擇。

1. 選擇使用者的角色。

   完成新增使用者後，請選擇**邀請**。

## 建立問題以協同合作和追蹤工作
<a name="getting-started-bt-issue"></a>

CodeCatalyst 可協助您追蹤功能、任務、錯誤，以及專案中涉及問題的任何其他工作。您可以建立問題來追蹤所需的工作和想法。根據預設，當您建立問題時，它會新增至您的待處理項目。您可以將問題移至您追蹤進行中工作的電路板。您也可以將問題指派給特定的專案成員。

**為專案建立問題**

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

   請確定您正在要建立問題的專案中導覽。若要檢視所有專案，請在導覽窗格中選擇 **Amazon CodeCatalyst**，並視需要選擇**檢視所有專案**。選擇您要建立或處理問題的專案。

1. 在導覽窗格中，選擇**追蹤**，然後選擇**待處理**項目。

1. 選擇**建立問題**。

1. 在**問題標題**中，提供問題的名稱。選擇性地提供問題的描述。視需要選擇問題的狀態、優先順序和預估。您也可以從專案成員清單中將問題指派給專案成員。
**提示**  
您可以選擇將問題指派給 **Amazon Q**，讓 Amazon Q 嘗試解決問題。如果嘗試成功，將會建立提取請求，且問題狀態將變更為**檢閱中**，以便您可以檢閱和測試程式碼。如需詳細資訊，請參閱[教學課程：使用 CodeCatalyst 生成式 AI 功能來加速開發工作](getting-started-project-assistance.md)。  
此功能需要為空間啟用生成式 AI 功能。如需詳細資訊，請參閱[管理生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。

1. 選擇**儲存**。

建立問題之後，您可以將它們指派給專案成員、估計它們，並在 Kanban 電路板上追蹤它們。如需詳細資訊，請參閱[追蹤和組織 CodeCatalyst 中的問題追蹤和組織處理問題的工作](issues.md)。