從 遷移 AWS Cloud9 至 Amazon CodeCatalyst - AWS Cloud9

AWS Cloud9 不再提供給新客戶。的現有客戶 AWS Cloud9 可以繼續正常使用服務。進一步了解

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

從 遷移 AWS Cloud9 至 Amazon CodeCatalyst

AWS Cloud9 CodeCatalyst 提供與 互動的完整受管體驗 AWS Cloud9。您可以在 Amazon 中手動複寫目前的 AWS Cloud9 程式碼資源 CodeCatalyst。程序在以下各節中詳細說明。若要移動程式碼資源並進行複寫,請在 中建立空間 CodeCatalyst。空格代表貴公司、部門或群組。您需要建立空間來新增專案、成員和您在 中建立的相關雲端資源 CodeCatalyst。當使用者接受專案的邀請時, CodeCatalyst 會自動將其新增至空間。具有 Space 管理員角色的使用者可以管理空間。

在此空間中,您可以建立專案並新增來源儲存庫。專案是 中的協作空間 CodeCatalyst ,可支援開發團隊和任務。建立專案之後,您可以新增、更新或移除資源。您也可以自訂專案儀表板,並監控團隊工作的進度。您可以在空間中擁有多個專案。您新增的來源儲存庫數量取決於您在環境中已使用的 AWS Cloud9 儲存庫數量。建立此專案並新增適用的來源儲存庫後,您可能需要返回 AWS Cloud9 環境,並將環境資料複寫至 中的這些新儲存庫 CodeCatalyst。您所做的工作取決於您在 中擁有的來源儲存庫類型 AWS Cloud9。

建立空間、專案和來源儲存庫後,您可以在 中 AWS Cloud9 搭配開發環境 CodeCatalyst 使用 啟動環境。開發環境是雲端型開發環境。您可以使用 中的開發環境 CodeCatalyst 來處理儲存在專案來源儲存庫中的程式碼。您也可以在 中建立開發環境 CodeCatalyst ,以使用支援的整合開發環境 () 在專案特定的開發環境中處理程式碼IDE。

您也可以 CodeCatalyst 使用複寫工具將目前的 AWS Cloud9 程式碼資源複寫至 。這是您在 AWS Cloud9 環境中下載和執行的工具。如果您已註冊 CodeCatalyst並建立空間,工具會自動在此空間內建立專案,並將程式碼資源複寫至 中的新儲存庫 CodeCatalyst。類似於手動複寫程序。這取決於您在 中擁有的來源儲存庫類型 AWS Cloud9。例如,如果您有 GitHub 儲存庫,您仍然需要使用 複寫這些儲存庫 GitHub 主控台中的 CodeCatalyst 延伸模組。

步驟 1. 註冊 Amazon CodeCatalyst 並建立空間

您可以註冊 Amazon, CodeCatalyst 而無需邀請現有的空間或專案。註冊時,您可以建立空間和專案。您可以輸入您用於 的現有 AWS 帳戶 ID AWS Cloud9。這同樣 AWS 帳戶 可用於計費目的。如需有關如何尋找 AWS 帳戶 ID 的資訊,請參閱您的 AWS 帳戶 ID 及其別名 。依照此程序註冊 Amazon CodeCatalyst 設定檔、建立空間,以及新增空間的帳戶。

註冊為新使用者
  1. 開啟CodeCatalyst主控台

  2. 在歡迎頁面上,選擇註冊

    隨即顯示建立您的 AWS 建置器 ID 頁面。您的 AWS Builder ID 是您建立用來登入的身分。此 ID 與 AWS 帳戶 ID 不同。若要進一步了解 AWS Builder ID,請參閱 AWS 登入使用者指南 中的 AWS Builder ID 和其他 AWS 憑證

  3. 針對您的電子郵件地址 ,輸入您要與 建立關聯的電子郵件地址 CodeCatalyst。然後選擇下一步

  4. 針對您的名稱 ,輸入您要在您使用 AWS Builder ID 的應用程式中顯示的名字和姓氏。

    此名稱是您的 AWS Builder ID 設定檔名稱。如果您想要,稍後可以變更名稱。

    選擇 Next (下一步)電子郵件驗證頁面隨即出現。驗證碼會傳送至您指定的電子郵件。

  5. 對於驗證碼 ,輸入您收到的程式碼,然後選擇驗證

    如果您在 5 分鐘後未收到程式碼,且無法在垃圾郵件或垃圾資料夾中找到程式碼,請選擇重新傳送程式碼

  6. 驗證程式碼後,輸入密碼,然後選擇確認密碼

    選取核取方塊,確認您已閱讀並確認 AWS 客戶協議和 AWS 服務條款,然後選擇建立我的設定檔。

  7. 建立別名頁面上,輸入要用於 的別名 CodeCatalyst。其他 CodeCatalyst 使用者將使用此別名,在註解和提取請求中 @mention 您。您的 CodeCatalyst 設定檔將同時包含您的 AWS Builder ID 和 CodeCatalyst 別名的完整名稱。您無法變更 CodeCatalyst 別名。

    您的全名和別名會顯示在 中的不同區域 CodeCatalyst。例如,您的設定檔名稱會顯示在您的活動摘要中,但專案成員會使用別名來 @mention you。

    選擇建立別名 。頁面會更新以顯示建立空間區段。

  8. 對於空間名稱 ,輸入空間的名稱,然後選擇下一步

    您無法變更此名稱。

  9. 針對 AWS 帳戶 ID ,連結您要連線至空間之帳戶的十二位數 ID。

    AWS 帳戶 驗證字符 中,複製產生的字符 ID。權杖會自動為您複製。但是,您可能想要在核准 AWS 連線請求時存放它。

  10. 選擇在 中驗證 AWS

  11. 驗證 Amazon CodeCatalyst 空間頁面會在 中開啟 AWS Management Console。

    這是 Amazon CodeCatalyst Spaces 頁面。您可能需要登入才能存取頁面。

    若要存取頁面,請登入 中的 Amazon CodeCatalyst SpacesAWS Management Console

    中的驗證權杖欄位 AWS Management Console 會自動填入在 中產生的權杖 CodeCatalyst。

  12. 選擇 驗證空間

    帳戶驗證成功訊息隨即顯示,顯示帳戶已新增至空格。

    依預設,您將使用 CodeCatalyst 免費層。如果您想要變更,請選擇若要啟用標準層或新增此空間IAM的角色,請檢視空間詳細資訊

    如需 CodeCatalyst 定價層的詳細資訊,請參閱 Amazon CodeCatalyst - 定價

    CodeCatalyst 空間詳細資訊頁面會在 中開啟 AWS Management Console。這是 Amazon CodeCatalyst Spaces 頁面。您可能需要登入才能存取頁面。

  13. 選擇前往 Amazon CodeCatalyst

  14. 在 的建立頁面上 CodeCatalyst,選擇建立空間

    建立空間時會顯示狀態訊息。建立空間時, CodeCatalyst 開啟空間的 頁面。檢視預設為專案索引標籤。

    注意

    如果顯示許可錯誤或橫幅,請重新整理頁面並嘗試再次檢視頁面。

註冊 CodeCatalyst 並建立空間後,複寫程序的下一個步驟是在此空間內建立專案。

步驟 2. 在空間中建立專案

下列步驟概述如何在您在上一個步驟中建立的空間內建立空專案。透過此專案,您可以稍後手動新增所需的資源。建立專案之前,您必須具有 Space 管理員角色,而且必須加入您要建立專案的空間。當您建立空間時, CodeCatalyst 會自動為您指派空間管理員角色。空間管理員角色是 中最強大的角色 CodeCatalyst。如需此角色及其許可的詳細資訊,請參閱空間管理員角色

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

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

  3. 選擇從頭開始

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

  5. 選擇建立專案

建立專案之後,複寫程序的下一個步驟是建立一或多個來源儲存庫。

步驟 3。在專案中建立來源儲存庫

在您剛建立的專案中,您需要建立來源儲存庫。此儲存庫包含單一檔案,即 README.md 檔案,您可以隨時編輯或刪除。根據您在建立來源儲存庫時所做的選擇,它也可能包含.gitignore檔案。

建立來源儲存庫
  1. 開啟CodeCatalyst主控台

  2. 導覽至您的專案。

  3. 在導覽窗格中,選擇程式碼 ,然後選擇來源儲存庫

  4. 選擇新增儲存庫 ,然後選擇建立儲存庫

  5. 儲存庫名稱 中,提供儲存庫的名稱。

    儲存庫名稱在專案中必須是唯一的。如需儲存庫名稱需求的詳細資訊,請參閱 中的來源儲存庫配額 CodeCatalyst

  6. (選用) 在描述 中,新增儲存庫的描述,以協助專案中的其他使用者了解儲存庫的用途。

  7. (選用) 針對您計劃推送的程式碼類型新增.gitignore檔案。

  8. 選擇 Create (建立)。

    注意

    CodeCatalyst 當您建立檔案時, 會將README.md檔案新增至您的儲存庫。 CodeCatalyst 也會在名為的預設分支中建立儲存庫的初始遞交。您可以編輯或刪除 README.md 檔案,但無法變更或刪除預設分支。

  9. 若要取得來源儲存庫複製 URL 和 PAT,請選擇複製儲存庫

  10. 若要複製每個HTTPS複製 URL和 PAT,請選擇複製 。然後,將複製URL存放在您可以擷取複製的PAT某個位置。

    複製 URL和 PAT將用於步驟 4,並參考為 CODECATALYST_SOURCE_REPO_CLONE_URLCODECATALYST_PAT

在專案中建立來源儲存庫之後,請將 AWS Cloud9 資料複寫至此來源儲存庫。

步驟 4. 將 AWS Cloud9 程式碼資源複寫至 中的來源儲存庫 CodeCatalyst

您在 AWS Cloud9 環境中擁有的來源儲存庫類型決定了您遵循的複寫方法,以將程式碼資源擷取到您建立的 CodeCatalyst 來源儲存庫。選項如下:

使用 GitHub 中的儲存庫 CodeCatalyst

使用 GitHub 儲存庫延伸模組,您可以使用連結的 GitHub Amazon CodeCatalyst 專案 AWS Cloud9 中的 儲存庫。下列步驟概述如何安裝 GitHub CodeCatalyst 目錄中的延伸。這些步驟也說明如何連接現有的 GitHub 帳戶到您的 CodeCatalyst 空間,並將您的 GitHub 儲存庫至您的 CodeCatalyst 專案。

此方法的第一步是安裝 GitHub CodeCatalyst 目錄中的儲存庫延伸。若要安裝擴充功能,請執行下列步驟。

重要

作為安裝和設定 的一部分 Github 儲存庫擴充功能,您必須在您的 中安裝擴充功能 GitHub 帳戶。若要這麼做,您必須是 GitHub 帳戶管理員和 CodeCatalyst空間管理員。

步驟 1. 從 CodeCatalyst 目錄安裝擴充功能
  1. 開啟CodeCatalyst主控台

  2. 導覽至您的空間。

    提示

    如果您屬於多個空間,您可以在頂端導覽列選擇要檢視的空間。

  3. 透過選擇搜尋列旁邊的頂端選單列中的目錄圖示,導覽至 CodeCatalyst 目錄。您可以搜尋 GitHub 根據類別的儲存庫或篩選條件延伸模組。

  4. (選用) 若要查看延伸模組的詳細資訊,例如與其相關聯的許可,請選擇 GitHub 儲存庫延伸名稱。

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

安裝 之後 GitHub 儲存庫延伸模組,系統會將您帶往 GitHub 儲存庫延伸詳細資訊頁面,您可以在其中檢視和管理已連線 GitHub 帳戶和連結 GitHub 儲存庫。

安裝 之後 GitHub 儲存庫延伸模組,連接您的 GitHub 帳戶到您的 CodeCatalyst 空間。連接您的 GitHub 帳戶,請執行下列步驟。

步驟 2. 連接您的 GitHub 帳戶至 CodeCatalyst
  1. 已連線 中 Github 帳戶索引標籤,選擇連線 GitHub 帳戶前往外部網站 GitHub.

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

  3. 選擇是否要允許 CodeCatalyst 存取所有目前和未來的儲存庫。或者,選擇特定的 GitHub 您要在 中使用的儲存庫 CodeCatalyst。預設選項為全部 GitHub 中的儲存庫 GitHub 空間。

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

連接您的 之後 GitHub 帳戶到 CodeCatalyst,您可以在 中檢視已連線的帳戶 GitHub 的帳戶索引標籤 GitHub 儲存庫延伸模組詳細資訊頁面。

使用 的最後步驟 GitHub 中的儲存庫 CodeCatalyst 是將儲存庫連結至您要使用儲存庫的 CodeCatalyst 專案。若要連結您的 GitHub 儲存庫至 CodeCatalyst 專案,請執行整個程序的步驟 3 中概述的下列步驟:

步驟 3。若要連結 GitHub 從 CodeCatalyst將 儲存庫儲存到專案 GitHub 儲存庫延伸詳細資訊頁面
  1. 連結的 GitHub 儲存庫索引標籤,選擇連結 GitHub 儲存庫..

  2. 針對 GitHub 帳戶 ,選取 GitHub 包含您要連結之儲存庫的帳戶。

  3. 針對 GitHub 儲存庫 ,選取要連結至 CodeCatalyst 專案的儲存庫。

  4. 針對CodeCatalyst 專案 ,選取您要連結的 CodeCatalyst 專案 GitHub 儲存庫。

  5. 選擇 Link (連結)

您的 CodeCatalyst 儲存庫現在應該有更新的檔案,並遞交您剛才推送的 。您現在可以從此分支建立開發環境,並使用 開啟它們 AWS Cloud9。如需開發環境的詳細資訊,請參閱 中的開發環境 CodeCatalyst

您現在可以從此分支建立開發環境,並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於步驟 5:使用 在 AWS Cloud9 中建立開發環境 CodeCatalyst

使用非GitHub 中的儲存庫 CodeCatalyst

您需要在 Amazon CodeCatalyst 中建立個人存取權杖 (PAT),才能複寫您的環境,使其不再 AWS Cloud9 使用非GitHub 儲存庫。下一節概述如何建立此權杖。

在 Amazon 中建立個人存取權杖 CodeCatalyst

您可以使用 存取您在本機電腦上建立的來源儲存庫 Git 用戶端或整合開發環境中 (IDE)。若要這麼做,您必須輸入應用程式特定的密碼。您可以建立個人存取權杖 (PAT) 以用於此目的。您建立的個人存取權杖 (PATs) 會與 中所有空間和專案的使用者身分相關聯 CodeCatalyst。您可以檢視PATs您建立之 的名稱和過期日期,也可以刪除不再需要PATs的 。您只能在建立PAT秘密時複製秘密。

建立個人存取權杖 (PAT)
  1. 在 https://https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

  2. 在頂端選單列中,選擇您的設定檔徽章,然後選擇我的設定

    提示

    您也可以找到您的使用者設定檔。若要這麼做,請在專案或空間的成員頁面上,從成員清單中選擇您的姓名。

  3. 個人存取權杖 下,選擇建立

  4. PAT名稱 中,輸入個人存取權杖的描述性名稱 (PAT)。

  5. 過期日期 中,保留預設日期或選擇行事曆圖示以選取自訂日期。過期日期預設為目前日期的 1 年。

  6. 選擇 Create (建立)。

    提示

    您也可以在為來源儲存庫選擇複製儲存庫時建立此權杖。

  7. 若要複製PAT秘密,請選擇複製 。將PAT秘密存放在您可以擷取秘密的位置。

    重要

    PAT 秘密只會顯示一次。關閉視窗後就無法擷取它。如果您未將PAT秘密儲存在安全位置,則可以建立另一個秘密。

PAT 為來源儲存庫建立 後,請在 AWS Cloud9 環境中 CodeCatalyst 新增遠端儲存庫 AWS Cloud9 並將資料推送至此儲存庫,以將資料從環境複寫至 ,如以下章節所述。

在 AWS Cloud9 環境中新增遠端儲存庫

假設您正在執行的儲存庫不是 GitHub 儲存庫。您可以在 AWS Cloud9 環境中新增遠端儲存庫,並將資料推送至 中的來源儲存庫 CodeCatalyst。若要完成此程序,請執行下列命令。

在 中 AWS Cloud9 IDE,新增遠端儲存庫,該儲存庫指向您在 複寫程序的步驟 3 中建立的來源儲存庫 CodeCatalyst。在 命令CODECATALYST_SOURCE_REPO_CLONE_URL中,將 取代URL為您在步驟 3 步驟 10 中儲存的複製。在專案 中建立來源儲存庫

git remote add codecatalyst CODECATALYST_SOURCE_REPO_CLONE_URL

使用下列命令,將新的分支推送至來源儲存庫。當系統提示您輸入密碼CODECATALYST_PAT時,請使用您在步驟 3 的步驟 10 中存放的密碼。在專案 中建立來源儲存庫

git checkout -b replication && git push codecatalyst replication

以下是預期的命令執行輸出範例:

Switched to a new branch 'replication' Password for 'https://[aws-account-id]@[aws-region].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository': Enumerating objects: 4, done. Counting objects: 100% (4/4), done. Compressing objects: 100% (3/3), done. Writing objects: 100% (4/4), 982 bytes | 122.00 KiB/s, done. Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 remote: Validating objects: 100% To https://[aws-account-id].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository * [new branch] replication → replication

此分支可在您在 中建立的來源儲存庫中使用 CodeCatalyst。您可以從此分支建立開發環境,並使用 開啟它們 AWS Cloud9。如需開發環境的詳細資訊,請參閱 中的開發環境 CodeCatalyst

您現在可以從此分支建立開發環境,並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於步驟 5:使用 在 AWS Cloud9 中建立開發環境 CodeCatalyst

在 中使用空的儲存庫 AWS Cloud9

首先在 Amazon 中建立個人存取權杖 (PAT), CodeCatalyst 然後您才能使用空 AWS Cloud9 的儲存庫複寫環境。下一節概述如何建立此權杖。

在 Amazon 中建立個人存取權杖 CodeCatalyst

您可以使用 存取您在本機電腦上建立的來源儲存庫 Git 用戶端或整合開發環境中的 (IDE)。若要這麼做,您必須輸入應用程式特定的密碼。您可以建立個人存取權杖 (PAT) 以用於此目的。您建立的個人存取權杖 (PATs) 會與 中所有空間和專案的使用者身分相關聯 CodeCatalyst。您可以檢視PATs您建立之 的名稱和過期日期,也可以刪除不再需要PATs的 。您只能在建立PAT秘密時複製秘密。

建立個人存取權杖 (PAT)
  1. 在 https://https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

  2. 在頂端選單列中,選擇您的設定檔徽章,然後選擇我的設定

    提示

    您也可以找到您的使用者設定檔。若要這麼做,請在專案或空間的成員頁面上,從成員清單中選擇您的姓名。

  3. 個人存取權杖 下,選擇建立

  4. PAT名稱 中,輸入個人存取權杖的描述性名稱 (PAT)。

  5. 過期日期 中,保留預設日期或選擇行事曆圖示以選取自訂日期。過期日期預設為目前日期的 1 年。

  6. 選擇 Create (建立)。

    提示

    您也可以在為來源儲存庫選擇複製儲存庫時建立此權杖。

  7. 若要複製PAT秘密,請選擇複製 。將PAT秘密存放在您可以擷取秘密的位置。

    重要

    PAT 秘密只會顯示一次。關閉視窗後就無法擷取它。如果您未將PAT秘密儲存在安全位置,則可以建立另一個秘密。

PAT 為來源儲存庫建立 後, CodeCatalyst 請在 AWS Cloud9 環境中啟動空儲存庫, AWS Cloud9 並指向您在 中建立的來源儲存庫,以將資料從環境複寫到 CodeCatalyst,如以下章節所述。

在 中啟動空儲存庫 AWS Cloud9

如果您沒有在 中設定的任何來源儲存庫 AWS Cloud9,請在 中啟動空儲存庫 AWS Cloud9。此外,指向您在 中建立的來源儲存庫 CodeCatalyst,並新增和推送您要複寫的檔案 Git。 執行下列步驟並執行下列命令,將 AWS Cloud9 檔案複寫至 CodeCatalyst。

  1. 從您的 AWS Cloud9 環境中,執行下列命令來啟動空儲存庫:

    git init -b main

    然後,您會看到類似輸出,如下所示:

    Initialized empty Git repository in /home/ec2-user/environment/.git/
  2. URL 從 複製來源儲存庫 CodeCatalyst。導覽至您在 CodeCatalyst 主控台中建立的 CodeCatalyst 專案,然後在導覽窗格中選擇程式碼 ,然後選擇來源儲存庫

  3. 從您想要的來源儲存庫清單中選擇儲存庫,然後選擇複製儲存庫以複製複製 URL。

  4. 使用URL您複製的 來新增儲存 CodeCatalyst 庫,並推送 中已存在於空白儲存庫中的內容 CodeCatalyst:

    git remote add origin [...] git push origin --force
  5. 新增您要複寫的檔案。如果您想要複寫環境目錄中的所有檔案,請執行 git add -A

    git add -A . git commit -m "replicate"
  6. 合併兩個不相關的歷史記錄。如果發生地址合併衝突:

    git merge origin/main --allow-unrelated-histories
  7. CodeCatalyst 執行下列命令,將變更推回 中的來源儲存庫。提示輸入密碼時,請輸入您產生步驟 3 步驟 10 的個人存取權杖 (CODECATALYST_PAT)。 在專案中建立來源儲存庫

    Admin:~/environment (main) $ git push origin main Password for 'https://222581768915@git.us-west-2.codecatalyst.aws/v1/MySpace222581768915/Replication/Replication':

完成此程序後,您的 CodeCatalyst 儲存庫具有您剛才推送的更新檔案和遞交。您現在可以從此分支建立開發環境,並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於下節。

步驟 5:在 AWS Cloud9 中使用 建立開發環境 CodeCatalyst

下列程序概述如何在 CodeCatalyst 中使用 AWS Cloud9 和您剛複寫的資料建立開發環境。

使用 建立開發環境 AWS Cloud9
  1. 在 https://https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

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

  3. 在導覽窗格中,選擇概觀 ,然後導覽至我的開發環境區段。

  4. 選擇建立開發環境

  5. AWS Cloud9 從下拉式選單中選擇 。

  6. 選擇複製儲存庫

    注意

    目前, CodeCatalyst 不支援複製第三方儲存庫,但您可以建立開發環境,並從您選擇的 將第三方儲存庫複製到其中IDE。

  7. 執行以下任意一項:

    1. 選擇要複製的儲存庫,選擇在現有分支中工作 ,然後從現有分支下拉式功能表中選擇分支。

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

  8. 或者,為開發環境新增別名。

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

  10. 選擇 Create (建立)。建立開發環境時,開發環境狀態欄會顯示正在啟動 ,而狀態欄會在建立開發環境後顯示正在執行