快速入門:在 中安裝擴充功能、連線提供者和連結資源 CodeCatalyst - Amazon CodeCatalyst

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

快速入門:在 中安裝擴充功能、連線提供者和連結資源 CodeCatalyst

本教學課程提供以下三個任務的逐步解說:

  1. 安裝GitHub 儲存庫 Bitbucket 儲存庫 GitLab 儲存庫 Jira Software 延伸模組。系統會在外部網站提示您連線並提供對第三方資源的 CodeCatalyst 存取權,這是後續步驟的一部分。

    重要

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

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

    重要

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

    重要

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

    注意

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

  3. 將您的 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫或 Jira 專案連結至您的 CodeCatalyst 專案。

    重要
    重要

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

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

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

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

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

    • GitHub 儲存庫擴充功能與 GitHub Enterprise Server 儲存庫不相容。

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

    • GitLab 儲存庫擴充功能與 GitLab 自我管理的專案儲存庫不相容。

    • 您無法將我的寫入描述摘要評論功能與連結的儲存庫搭配使用。這些功能僅適用於 中的提取請求 CodeCatalyst。

    • CodeCatalyst 專案只能連結至一個 Jira 專案。Jira 專案可以連結至多個 CodeCatalyst 專案。

您也可以安裝GitHub 儲存庫 Bitbucket 儲存庫 GitLab 儲存庫延伸模組、連線至 GitHub 您的帳戶、Bitbucket 工作區或 GitLab 使用者,以及在建立新 CodeCatalyst 專案時連結第三方儲存庫。如需詳細資訊,請參閱使用連結的第三方儲存庫建立專案

步驟 1:從 CodeCatalyst 目錄安裝第三方延伸模組

使用 中的 小第三方資源的第一步 CodeCatalyst ,是從 CodeCatalyst 目錄安裝GitHub 儲存庫延伸。若要安裝擴充功能,請執行下列步驟,選擇您要使用的第三方資源的擴充功能。GitHub 儲存庫 Bitbucket 儲存庫 GitLab 儲存庫可讓您在 中使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫 CodeCatalyst。Jira Software 可讓您管理 中的 Jira 問題 CodeCatalyst。

從 CodeCatalyst 目錄安裝擴充功能
  1. 開啟 CodeCatalyst 主控台,網址為 https://https://codecatalyst.aws/

  2. 導覽至您的 CodeCatalyst 空間。

  3. 選擇頂端選單 The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. 中的目錄圖示,導覽至 CodeCatalyst CodeCatalyst 目錄。您可以搜尋GitHub 儲存庫 Bitbucket 儲存庫 GitLab 儲存庫 Jira Software 。您也可以根據類別篩選延伸模組。

  4. (選用) 若要查看延伸模組的詳細資訊,例如延伸模組將擁有的許可,請選擇延伸模組名稱。

  5. 選擇 Install (安裝)。檢閱延伸模組所需的許可,如果您想要繼續,請再次選擇安裝

安裝擴充功能後,系統會將您導向擴充功能詳細資訊頁面。根據您安裝的擴充功能,您可以檢視和管理連線的提供者和連結的資源。

步驟 2:將您的第三方供應商連接至您的 CodeCatalyst 空間

安裝GitHub 儲存庫 Bitbucket 儲存庫 GitLab 儲存庫 Jira Software 擴充功能後,下一步是將 GitHub 您的帳戶、Bitbucket 工作區、 GitLab 專案儲存庫或 Jira 網站連接至您的 CodeCatalyst 空間。

若要將 GitHub 您的帳戶、Bitbucket 工作區或 Jira 網站連線至 CodeCatalyst
  • 根據您安裝的第三方延伸模組執行下列其中一項操作:

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

      1. 連線 GitHub 帳戶索引標籤中,選擇 Connect GitHub 帳戶以前往 的外部網站 GitHub。

      2. 使用您的 GitHub 憑證登入 GitHub 您的帳戶,然後選擇您要安裝 Amazon 的帳戶 CodeCatalyst。

        提示

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

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

      4. 檢閱授予 的許可 CodeCatalyst,然後選擇安裝

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

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

      1. 連線的 Bitbucket 工作區索引標籤中,選擇連線 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. 選擇 授權 AWS 連接器 GitLab

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

    • Jira Software :連接 Jira 網站。

      1. 連線的 Jira 網站索引標籤中,選擇連線 Jira 網站以前往 Atlassian Marketplace 的外部網站。

      2. 選擇立即取得,即可開始 CodeCatalyst 在 Jira 網站上安裝 。

        注意

        如果您先前已安裝 CodeCatalyst 至 Jira 網站,則會通知您。選擇開始進入最後一個步驟。

      3. 根據您的角色,執行下列其中一項操作:

        1. 如果您是 Jira 網站管理員,請從網站下拉式功能表中選擇 Jira 網站來安裝 CodeCatalyst 應用程式,然後選擇安裝應用程式

          注意

          如果您有一個 Jira 網站,則不會顯示此步驟,而且系統會自動將您導向下一個步驟。

          1. 如果您不是 Jira 管理員,請從網站下拉式功能表中選擇 Jira 網站來安裝 CodeCatalyst 應用程式,然後選擇請求應用程式 。如需安裝 Jira 應用程式的詳細資訊,請參閱誰可以安裝應用程式?

          2. 在 CodeCatalyst 輸入文字欄位中輸入您需要安裝 的原因,或保留預設文字,然後選擇提交請求

      4. 檢閱安裝應用程式 CodeCatalyst 時由 執行的動作,然後選擇立即取得

      5. 安裝應用程式後,選擇返回 CodeCatalyst以返回 CodeCatalyst。

      將您的 Jira 網站連線至 後 CodeCatalyst,您可以在 Jira 軟體延伸詳細資訊頁面的連線 Jira 網站索引標籤中檢視連線的網站。

使用 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫,或管理 Jira 問題的第三個和最後一個步驟 CodeCatalyst 是將它們連結至您想要使用的 CodeCatalyst 專案。

從延伸詳細資訊頁面將 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫或 Jira 專案連結至 CodeCatalyst 專案
  • 根據您安裝的第三方延伸模組和連線的提供者,執行下列其中一項操作:

    • GitHub 儲存庫 :連結 GitHub 儲存庫。

      1. 連結的 GitHub 儲存庫索引標籤中,選擇連結 GitHub 儲存庫

      2. GitHub 帳戶下拉式清單中,選擇包含您要連結之儲存庫 GitHub 的帳戶。

      3. GitHub 儲存庫下拉式清單中,選擇要連結至 CodeCatalyst 專案的儲存庫。

        提示

        如果儲存庫的名稱反灰,則您無法連結該儲存庫,因為該儲存庫已連結至空間中的另一個專案。

      4. (選用) 如果您在 GitHub 儲存庫清單中看不到儲存庫,則可能尚未在 中的 Amazon CodeCatalyst 應用程式中設定儲存庫存取權 GitHub。您可以設定哪些 GitHub 儲存庫可用於 CodeCatalyst 連線帳戶中。

        1. 導覽至GitHub您的帳戶,選擇設定 ,然後選擇應用程式

        2. 已安裝 GitHub 的應用程式索引標籤中,選擇 Amazon CodeCatalyst 應用程式的設定

        3. 執行下列其中一項操作,以設定您要在 中連結的 GitHub 儲存庫存取權 CodeCatalyst:

          • 若要提供所有目前和未來儲存庫的存取權,請選擇所有儲存庫

          • 若要提供特定儲存庫的存取權,請選擇僅選取儲存庫 ,選擇選取儲存庫下拉式清單,然後選擇您要允許在 中連結的儲存庫 CodeCatalyst。

      5. CodeCatalyst 專案下拉式功能表中,選擇要連結 GitHub 儲存庫的 CodeCatalyst 專案。

      6. 選擇 Link (連結)

      如果您不想再使用 中的 GitHub 儲存庫 CodeCatalyst,您可以取消它與 CodeCatalyst 專案的連結。當儲存庫取消連結時,該儲存庫中的事件將不會啟動工作流程執行,且您將無法將該儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊,請參閱在 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫和 Jira 專案 CodeCatalyst

    • Bitbucket 儲存庫:連結 Bitbucket 儲存庫。

      1. 連結的 Bitbucket 儲存庫索引標籤中,選擇連結 Bitbucket 儲存庫

      2. Bitbucket 工作區下拉式清單中,選擇包含您要連結之儲存庫的 Bitbucket 工作區。

      3. Bitbucket 儲存庫下拉式清單中,選擇要連結至 CodeCatalyst 專案的儲存庫。

        提示

        如果儲存庫的名稱反灰,則您無法連結該儲存庫,因為該儲存庫已連結至空間中的另一個專案。

      4. CodeCatalyst 專案下拉式功能表中,選擇要連結 Bitbucket 儲存庫的 CodeCatalyst 專案。

      5. 選擇 Link (連結)

      如果您不想再在 中使用 Bitbucket 儲存庫 CodeCatalyst,您可以取消它與 CodeCatalyst 專案的連結。當儲存庫取消連結時,該儲存庫中的事件將不會啟動工作流程執行,而且您將無法將該儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊,請參閱在 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫和 Jira 專案 CodeCatalyst

    • GitLab 儲存庫 :連結 GitLab 專案儲存庫。

      1. 連結的 GitLab 專案儲存庫索引標籤中,選擇連結 GitLab 專案儲存庫

      2. GitLab 使用者下拉式清單中,選擇包含您要連結之儲存庫 GitLab 的使用者。

      3. GitLab 專案儲存庫下拉式清單中,選擇要連結至 CodeCatalyst 專案的儲存庫。

        提示

        如果儲存庫的名稱反灰,則您無法連結該儲存庫,因為該儲存庫已連結至空間中的另一個專案。

      4. CodeCatalyst 專案下拉式功能表中,選擇您要連結 CodeCatalyst 專案儲存庫的 GitLab 專案。

      5. 選擇 Link (連結)

      如果您不想再使用 中的 GitLab 專案儲存庫 CodeCatalyst,您可以取消它與 CodeCatalyst 專案的連結。當專案儲存庫取消連結時,該專案儲存庫中的事件將不會啟動工作流程執行,且您將無法將該專案儲存庫與 CodeCatalyst 開發環境搭配使用。如需詳細資訊,請參閱在 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫和 Jira 專案 CodeCatalyst

    • Jira Software :連結 Jira 專案。

      1. 連結的 Jira 專案索引標籤中,選擇連結 Jira 專案

      2. Jira 網站下拉式功能表中,選擇包含您要連結之專案的 Jira 網站。

      3. Jira 專案下拉式功能表中,選擇要連結至專案的 CodeCatalyst 專案。

      4. CodeCatalyst 專案下拉式功能表中,選擇您要連結至 Jira CodeCatalyst 專案的專案。

      5. 選擇 Link (連結)

      一旦 Jira 專案連結至 CodeCatalyst 專案, CodeCatalyst 問題存取會完全停用,而且 CodeCatalyst 導覽窗格中的問題會取代為 Jira 發行項目,該項目會連結至 Jira 專案。

      CodeCatalyst 問題已取代為導覽窗格中連結的 Jira 問題。

      如果您不想再在 中使用 Jira 專案 CodeCatalyst,您可以取消它與 CodeCatalyst專案的連結。當 Jira 專案取消連結時,專案中 CodeCatalyst將無法使用 Jira 問題,且 CodeCatalyst 問題將再次成為問題提供者。如需詳細資訊,請參閱在 中取消連結 GitHub 儲存庫、Bitbucket 儲存庫、 GitLab 專案儲存庫和 Jira 專案 CodeCatalyst

您也可以從程式碼 中的來源儲存庫,將 GitHub 儲存庫、Bitbucket 儲存庫或 GitLab 專案儲存庫連結至專案。 如需詳細資訊,請參閱從連線的第三方供應商連結資源

後續步驟

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

安裝 Jira Software 擴充功能、連接 Jira 網站、將 Jira 專案連結至 CodeCatalyst 專案,以及連結提取請求後,來自 的更新 CodeCatalyst 會反映在您的 Jira 專案中。如需將提取請求連結至 Jira 問題的詳細資訊,請參閱 連結 Jira 問題以 CodeCatalyst 提取請求。如需在 Jira 中檢視 CodeCatalyst 事件的詳細資訊,請參閱 檢視 Jira 問題中的 CodeCatalyst 事件