建立專案 - Amazon CodeCatalyst
建立空專案使用連結的第三方儲存庫建立專案使用藍圖建立專案使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務搭配專案使用藍圖的最佳實務將資源和任務新增至建立的專案

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

建立專案

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

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

在 Amazon CodeCatalyst 中建立空專案

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

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

建立空專案

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

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

  3. 選擇從頭開始。

  4. 在為專案命名下，輸入您要指派給專案的名稱。名稱在您的空間中必須是唯一的。

  5. 選擇建立專案。

使用連結的第三方儲存庫建立專案

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

建立 CodeCatalyst 專案之前，您必須擁有 Space 管理員或 Power 使用者角色。如需詳細資訊，請參閱 建立空間 和 直接邀請使用者到空格 。

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

  1. 安裝 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 儲存庫延伸。系統會在外部網站提示您連線，並提供 CodeCatalyst 存取您的儲存庫，這是後續步驟的一部分。

    重要

    若要將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 儲存庫擴充功能安裝至 CodeCatalyst 空間，您必須使用空間中具有空間管理員角色的帳戶登入。

  2. 將您的 GitHub 帳戶或 Bitbucket 工作區或 GitLab 使用者連線至 CodeCatalyst。

    重要

    若要將 GitHub 帳戶、Bitbucket 工作區、GitLab 使用者連接至 CodeCatalyst 空間，您必須同時是第三方來源的管理員和 CodeCatalyst 空間管理員。

    重要

    安裝儲存庫延伸模組後，您連結至 CodeCatalyst 的任何儲存庫都會將其程式碼編製索引並儲存在 CodeCatalyst 中。這可讓程式碼在 CodeCatalyst 中搜尋。若要進一步了解在 CodeCatalyst 中使用連結儲存庫時程式碼的資料保護，請參閱《Amazon CodeCatalyst 使用者指南》中的資料保護。

  3. 建立連結至 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫的 CodeCatalyst 專案。

    重要

    雖然您可以將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結為貢獻者，但您只能將第三方儲存庫取消連結為空間管理員或專案管理員。如需詳細資訊，請參閱在 CodeCatalyst 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案。

    重要

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

    最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的延伸模組。

    注意

    • GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫只能連結到空間中的一個 CodeCatalyst 專案。

    • 您無法搭配 CodeCatalyst 專案使用空的或封存的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫。

    • 您無法連結與 CodeCatalyst 專案中儲存庫同名的 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫。

    • GitHub 儲存庫延伸模組與 GitHub Enterprise Server 儲存庫不相容。

    • Bitbucket 儲存庫擴充功能與 Bitbucket 資料中心儲存庫不相容。

    • GitLab 儲存庫延伸模組與 GitLab 自我管理的專案儲存庫不相容。

    • 您無法使用我 的寫入描述，也無法將註解功能與連結的儲存庫進行摘要。這些功能僅適用於 CodeCatalyst 中的提取請求。

如需詳細資訊，請參閱在 CodeCatalyst 中將功能新增至具有擴充功能的專案。

安裝第三方延伸模組

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

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

  3. 選擇自帶程式碼。

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

  5. 如果出現提示，請選擇安裝。檢閱延伸模組所需的許可，如果您想要繼續，請再次選擇安裝。

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

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

根據您選擇設定的第三方延伸模組，執行下列其中一項操作：

  • GitHub 儲存庫：連線至 GitHub 帳戶。

    1. 選擇連線 GitHub 帳戶以前往 GitHub 的外部網站。

    2. 使用您的 GitHub 登入資料登入 GitHub 帳戶，然後選擇您要安裝 Amazon CodeCatalyst 的帳戶。

      提示

      如果您之前已將 GitHub 帳戶連接到空間，將不會提示您重新授權。如果您是多個 GitHub 空間的成員或協作者，您會看到一個對話方塊，詢問您要安裝延伸模組的位置；或者，如果您只屬於一個 GitHub 空間，則會看到 Amazon CodeCatalyst 應用程式的組態頁面。為您要允許的儲存庫存取設定應用程式，然後選擇儲存。如果儲存按鈕未處於作用中狀態，請變更組態，然後再試一次。

    3. 選擇是否要允許 CodeCatalyst 存取所有目前和未來的儲存庫，或選擇您想要在 CodeCatalyst 中使用的特定 GitHub 儲存庫。預設選項是在 GitHub 帳戶中包含所有 GitHub 儲存庫，包括未來將由 CodeCatalyst 存取的儲存庫。

    4. 檢閱提供給 CodeCatalyst 的許可，然後選擇安裝。

    將您的 GitHub 帳戶連線至 CodeCatalyst 後，系統會將您導向 GitHub 儲存庫延伸詳細資訊頁面，您可以在其中檢視和管理連線的 GitHub 帳戶和連結的 GitHub 儲存庫。

  • Bitbucket 儲存庫：連線至 Bitbucket 工作區。

    1. 選擇連線 Bitbucket 工作區，前往 Bitbucket 的外部網站。

    2. 使用您的 Bitbucket 登入資料登入 Bitbucket 工作區，並檢閱提供給 CodeCatalyst 的許可。

    3. 從授權工作區下拉式功能表中，選擇您要提供 CodeCatalyst 存取權的 Bitbucket 工作區，然後選擇授予存取權。

      提示

      如果您之前已將 Bitbucket 工作區連接到空間，則不會提示您重新授權。如果您是多個 Bitbucket 工作區的成員或協作者，您會看到一個對話方塊，詢問您要安裝延伸模組的位置；如果您只屬於一個 Bitbucket 工作區，則會看到 Amazon CodeCatalyst 應用程式的組態頁面。為您想要允許的工作區存取設定應用程式，然後選擇授予存取權。如果授予存取按鈕未處於作用中狀態，請變更組態，然後再試一次。

    將您的 Bitbucket 工作區連線至 CodeCatalyst 後，系統會將您導向 Bitbucket 儲存庫延伸詳細資訊頁面，您可以在其中檢視和管理連接的 Bitbucket 工作區和連結的 Bitbucket 儲存庫。

  • GitLab 儲存庫：連線至 GitLab 使用者。

    1. 選擇 Connect GitLab 使用者以前往 GitLab 的外部網站。

    2. 使用您的 GitLab 登入資料登入 GitLab 使用者，並檢閱授予 CodeCatalyst 的許可。

      提示

      如果您之前已將 GitLab 使用者連接到空間，將不會提示您重新授權。您將改為導覽回 CodeCatalyst 主控台。

    3. 選擇 Authorize AWS Connector for GitLab。

    將您的 GitLab 使用者連線至 CodeCatalyst 後，系統會將您導向 GitLab 儲存庫延伸詳細資訊頁面，您可以在其中檢視和管理連線的 GitLab 使用者和連結的 GitLab 專案儲存庫。

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

若要建立專案

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

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

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

  4. 選擇建立專案。

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

使用藍圖建立專案

您可以使用專案藍圖來佈建所有專案資源和範例程式碼。如需藍圖的相關資訊，請參閱 使用 CodeCatalyst 藍圖建立全面的專案。

使用藍圖建立專案

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

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

  3. 選擇從藍圖開始。

    提示

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

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

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

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

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

    重要

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

    最佳實務是，在連結儲存庫之前，請務必確認您擁有最新版本的延伸模組。

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

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

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

      注意

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

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

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

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

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

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

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

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

  10. 選擇建立專案。

使用 Amazon Q 建立專案或新增具有藍圖的功能時的最佳實務

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

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

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

注意

採用 Amazon Bedrock： AWS 實作自動濫用偵測。由於 Amazon Q 開發人員代理程式的軟體開發功能建置在 Amazon Bedrock 上，因此為我建立內容摘要、建議任務、使用 Amazon Q 來建立或新增功能，以及將問題指派給 Amazon Q 功能，因此使用者可以充分利用在 Amazon Bedrock 中實作的控制項，以強制執行安全、安全和負責任地使用人工智慧 (AI)。

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

重要

生成式 AI 功能僅適用於美國西部 （奧勒岡） 區域。

  • 使用 Amazon Q 提供的預設提示。Amazon Q 最適合從提供的提示中選擇藍圖。

  • 使用 Amazon Q 建議的組態選項來預覽藍圖。選擇藍圖以預覽藍圖所建立的範例程式碼和資源。

  • 使用為 Amazon Q 啟用的空間。若要使用 Amazon Q 建立專案，或使用 Amazon Q 將功能新增至具有藍圖的專案，請使用針對生成式 AI 功能啟用的空間。如需詳細資訊，請參閱啟用或停用空間的生成式 AI 功能。

  • 取得 Amazon Q 所建議藍圖的詳細資訊。 您可能想要進一步了解使用特定建議藍圖建立的專案資源、範例程式碼和元件類型。如需 CodeCatalyst 中可用藍圖的詳細資訊，請參閱 使用 CodeCatalyst 藍圖建立全面的專案。

  • 允許 Amazon Q 處理問題。允許 Amazon Q 為您建立問題、指派這些問題並追蹤這些問題。如需詳細資訊，請參閱教學課程：使用 CodeCatalyst 生成式 AI 功能加速開發工作。

  • 從不再處理的問題取消指派 Amazon Q。完成此範例後，請取消指派 Amazon Q 以解決任何不再處理的問題。如果 Amazon Q 已完成其問題的工作或找不到解決方案，請務必取消指派 Amazon Q，以避免達到生成式 AI 功能的最大配額。如需詳細資訊，請參閱管理生成式 AI 功能和定價。

  • 檢視 Amazon Q 的用量。 您可以在使用者層級檢視生成 AI 功能的使用情況。前往我的設定以管理生成式 AI 配額，並依您的建置器 ID 或單一登入 (SSO) 身分檢視用量。如需詳細資訊，請參閱檢視空間中生成 AI 功能的使用情況。

重要

CodeCatalyst 中的生成 AI 功能受配額限制。如需詳細資訊，請參閱 Amazon Q 開發人員定價、啟用或停用空間的生成式 AI 功能，以及 Billing。

搭配專案使用藍圖的最佳實務

以下是一些最佳實務，可協助您建立具有藍圖的專案或新增藍圖。

  • 使用 CodeCatalyst 提供的藍圖來建立或新增至專案。您可以使用藍圖，為開發人員建立具有原始程式碼和資源的完整專案。例如，Web 應用程式藍圖會建立應用程式和基礎設施資源，並部署 Web 應用程式。您可以使用藍圖建立專案，或將自訂藍圖新增至現有專案。如需詳細資訊，請參閱使用藍圖建立專案。在 CodeCatalyst 中檢視任何藍圖，以預覽藍圖將建立的範例程式碼和資源。

  • 使用您組織設計的自訂藍圖。您可以使用自訂藍圖，在空間中建立完整的專案。您的組織設計的自訂藍圖可提供標準化和最佳實務，這也有助於減少設定新專案的工作量。身為自訂藍圖作者，您可以檢視哪些專案在空間中使用藍圖的詳細資訊。生命週期管理可讓您集中管理每個專案的軟體開發生命週期，而藍圖使用者可以利用生命週期管理，從更新的藍圖選項或版本重新產生程式碼庫。如需詳細資訊，請參閱以藍圖作者身分使用生命週期管理。

  • 將開發人員角色或適當的 IAM 角色新增至專案的帳戶。在您完成專案建立步驟期間或之後，您可以透過在連線至空間 AWS 帳戶 的 中選擇或建立 IAM 角色來設定藍圖許可。

將資源和任務新增至建立的專案

專案準備就緒後，您可以新增資源和任務。