CodeCatalyst 來源儲存庫和單頁應用程式藍圖入門

使用藍圖建立專案

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

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

3. 選擇從藍圖開始 。

   提示

   您可以選擇為 Amazon Q 提供專案需求來新增藍圖，讓 Amazon Q 向您建議藍圖。如需詳細資訊，請參閱 在建立專案或新增功能時，使用 Amazon Q 選擇藍圖 和 使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務。此功能僅適用於美國西部 （奧勒岡） 區域。

   此功能需要為空間啟用生成 AI 功能。如需詳細資訊，請參閱管理生成 AI 功能。

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

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

6. （選用） 根據預設，藍圖建立的原始程式碼會儲存在儲存庫中 CodeCatalyst 。或者，您可以選擇將藍圖的原始程式碼存放在第三方儲存庫中。如需詳細資訊，請參閱在 中將功能新增至具有擴充功能的專案 CodeCatalyst。

   重要

   CodeCatalyst 不支援偵測連結儲存庫的預設分支中的變更。若要變更連結儲存庫的預設分支，您必須先將其從 取消連結 CodeCatalyst、變更預設分支，然後再次連結。如需詳細資訊，請參閱在 中連結 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫和 Jira 專案 CodeCatalyst。

   最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的擴充功能。

   根據您要使用的第三方儲存庫提供者，執行下列其中一項操作：

   • GitHub 儲存庫 ：連接 GitHub 帳戶。

     選擇進階下拉式選單，選擇 GitHub 作為儲存庫提供者，然後選擇您要存放藍圖所建立原始碼 GitHub 的帳戶。

     注意

     如果您要連接 GitHub 帳戶，則必須建立個人連線，以在 CodeCatalyst 您的身分與身分之間建立 GitHub 身分映射。如需詳細資訊，請參閱 個人連接 和 使用個人連線存取 GitHub 資源。

   • Bitbucket 儲存庫：連接 Bitbucket 工作區。

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

   • GitLab 儲存庫 ：連接 GitLab 使用者。

     選擇進階下拉式選單，選擇 GitLab 作為儲存庫提供者，然後選擇您要將藍圖建立的原始程式碼存放到哪個 GitLab 使用者。

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

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

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

10. 選擇建立專案。

導覽至專案的來源儲存庫

1. 導覽至您的專案，並執行下列其中一項操作：

   • 在專案的摘要頁面上，從清單中選擇您想要的儲存庫，然後選擇檢視儲存庫 。

   • 在導覽窗格中，選擇程式碼 ，然後選擇來源儲存庫 。在來源儲存庫 中，從清單中選擇儲存庫的名稱。您可以在篩選列中輸入部分儲存庫名稱，以篩選儲存庫清單。

2. 在儲存庫的首頁上，檢視儲存庫的內容，以及有關相關資源的資訊，例如提取請求和工作流程的數量。預設會顯示預設分支的內容。您可以從下拉式清單中選擇不同的分支來變更檢視。

使用新分支建立開發環境

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

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

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

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

5. IDE 從下拉式功能表中選擇支援的 。如需更多資訊，請參閱支援開發環境的整合式開發環境。

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

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

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

9. 選擇 Create (建立)。建立開發環境時，開發環境狀態欄會顯示正在啟動 ，而狀態欄會在建立開發環境後顯示正在執行。新的索引標籤會在IDE您選擇的開發環境開啟。您可以編輯程式碼，並遞交和推送變更。

從 AWS Cloud9 開發環境進行和推送變更

1. 在 中 AWS Cloud9，展開側邊導覽選單以瀏覽檔案。展開 src，然後開啟 App.tsx。

2. 變更<p>標籤內的文字。

3. 儲存檔案，然後使用 Git 功能表遞交和推送變更。或者，在終端機視窗中，使用 和 git push命令遞交git commit和推送變更。

   git commit -am "Making an example change"
   git push

   提示

   您可能需要將終端機中的目錄變更為 Git 儲存庫目錄，才能成功執行 Git 命令。

建立提取請求

1. 導覽至您的專案。

2. 執行以下任意一項：

   • 在導覽窗格中，選擇程式碼 ，選擇提取請求 ，然後選擇建立提取請求 。

   • 在儲存庫首頁上，選擇更多 ，然後選擇建立提取請求 。

   • 在專案頁面上，選擇建立提取請求 。

3. 在來源儲存庫 中，請確定指定的來源儲存庫是包含遞交程式碼的儲存庫。只有在您未從儲存庫的首頁建立提取請求時，此選項才會出現。

4. 在目的地分支 中，選擇要在程式碼檢閱後將程式碼合併到 中的分支。

5. 在來源分支 中，選擇包含遞交程式碼的分支。

6. 在提取請求標題 中，輸入一個標題，協助其他使用者了解需要檢閱的內容及其原因。

7. （選用） 在提取請求描述 中，提供問題連結或變更描述等資訊。

   提示

   您可以選擇寫入描述，讓我 CodeCatalyst 自動產生提取請求中包含的變更描述。您可以在將自動產生的描述新增至提取請求之後對其進行變更。

   此功能需要為空間啟用生成 AI 功能，且不適用於連結儲存庫中的提取請求。如需詳細資訊，請參閱管理生成 AI 功能。

8. （選用） 在問題 中，選擇 連結問題 ，然後從清單中選擇問題或輸入其 ID。若要取消問題連結，請選擇取消連結圖示。

9. （選用） 在必要檢閱者 中，選擇新增必要檢閱者 。從專案成員清單中選擇以新增成員。必要的檢閱者必須先核准變更，才能將提取請求合併到目的地分支。

   注意

   您無法同時將檢閱者新增為必要檢閱者和選用檢閱者。您無法將自己新增為檢閱者。

10. （選用） 在選用檢閱者 中，選擇新增選用檢閱者 。從專案成員清單中選擇以新增成員。在提取請求合併到目的地分支之前，選用檢閱者不需要核准變更。

11. 檢閱分支之間的差異。提取請求中顯示的差異是來源分支中的修訂與合併基礎之間的變更，這是建立提取請求時目的地分支的主要承諾。如果沒有顯示變更，則分支可能相同，或者您可能已為來源和目的地選擇相同的分支。

12. 當您滿意提取請求包含您要檢閱的程式碼和變更時，請選擇建立 。

    注意

    建立提取請求後，您可以新增註解。評論可以新增至提取請求或檔案中的個別行，以及整體提取請求。您可以使用 @ 符號加上檔案名稱，將連結新增至資源，例如檔案。

合併提取請求 （主控台）

1. 在提取請求 中，選擇您在上一個步驟中建立的提取請求。在提取請求中，選擇合併 。

2. 從提取請求的可用合併策略中進行選擇。選擇性地選取或取消選取選項，以在合併提取請求後刪除來源分支，然後選擇合併 。合併完成後，提取請求的狀態會變更為合併，且不再出現在提取請求的預設檢視中。預設檢視會顯示狀態為 Open 的提取請求。您仍然可以檢視合併的提取請求，但無法核准或變更其狀態。

   注意

   如果合併按鈕未啟動，或者您看到不可合併標籤，則所需的檢閱者尚未核准提取請求，或提取請求無法在 CodeCatalyst 主控台中合併。尚未核准提取請求的檢閱者會在提取請求詳細資訊區域中的概觀中以時鐘圖示表示。如果所有必要的檢閱者都已核准提取請求，但合併按鈕仍處於非作用中狀態，則可能會發生合併衝突，或者您已超過空間的儲存配額。您可以在開發環境中解決目的地分支的合併衝突、推送變更，然後合併提取請求，或者您可以解決衝突並在本機合併，然後將包含合併的遞交推送至 CodeCatalyst。如需詳細資訊，請參閱 合併提取請求 （Git）和 Git 文件。

檢視部署的程式碼

1. 在工作流程 中，在 中onPushToMainDeployPipeline展開最近執行 。

   注意

   這是使用單頁應用程式藍圖建立之專案工作流程的預設名稱。

2. 最近的執行是合併提取請求遞交給main分支時啟動的執行，並且可能會顯示進行中的狀態。從清單中選擇成功完成的執行，以開啟該執行的詳細資訊。

3. 選擇變數 。複製應用程式 URL的值。這是URL已部署的單頁 Web 應用程式的 。開啟新的瀏覽器索引標籤並貼入 值，以檢視建置和部署的程式碼。保持索引標籤開啟。

4. 返回工作流程執行的清單，並等待最近的執行完成。這樣做時，請返回您開啟的索引標籤，以檢視 Web 應用程式並重新整理瀏覽器。您應該會看到您在合併提取請求中所做的變更。