教學課程：使用 GitHub 來源儲存庫建立專案 - AWS CodeStar
第 1 步：創建項目並創建您的 GitHub 存儲庫步驟 2：檢視您的原始程式碼步驟 3：建立提 GitHub 取請求

2024 年 7 月 31 日，Amazon Web Services (AWS) 將停止建立和檢視 AWS CodeStar 專案的支援。2024 年 7 月 31 日之後，您將無法再存取 AWS CodeStar 主控台或建立新專案。但是 AWS CodeStar，由建立的 AWS 資源 (包括您的來源儲存庫、管道和組建) 將不受此變更的影響，並將繼續運作。 AWS CodeStar 連線和 AWS CodeStar 通知不會受到此停止的影響。

 

如果您想要追蹤工作、開發程式碼以及建置、測試和部署應用程式，Amazon CodeCatalyst 提供簡化的入門程序和其他功能來管理軟體專案。進一步了解 Amazon 的功能和定價 CodeCatalyst。

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

教學課程：使用 GitHub 來源儲存庫建立專案

使用AWS CodeStar，您可以設定儲存庫來建立、檢閱和合併提取請求與您的專案團隊。

在本教學課程中，您會建立一個專案，其中包含 GitHub儲存庫中的範例 Web 應用程式原始碼、部署變更的管道，以及在雲端託管應用程式的 EC2 執行個體。建立專案之後，本教學課程會示範如何建立和合併提 GitHub 取要求，以變更 Web 應用程式的首頁。

第 1 步：創建項目並創建您的 GitHub 存儲庫

在此步驟中，請使用主控台建立專案，並建立與新 GitHub 存放庫的連線。若要存取您的 GitHub 存放庫，您可以建立AWS CodeStar用來管理授權的連線資源 GitHub。建立專案後，系統會為您佈建其他資源。

  1. 請登入AWS Management Console，然後開啟AWS CodeStar主控台，位於 https://console.aws.amazon.com/codestar/。

  2. 選擇您想要建立專案及其資源的 AWS 區域。

  3. 在AWS CodeStar頁面上，選擇 [建立專案]。

  4. 在 [選擇專案範本] 頁面上，選取 Web 應用程式、Node.js 和 Amazon EC2 核取方塊。然後從符合這組選項的範本中選擇。

    如需詳細資訊，請參閱AWS CodeStar 專案範本。

  5. 選擇 Next (下一步)。

  6. 在 Project name (專案名稱) 中，輸入專案的名稱 (如 MyTeamProject)。如果您使用不同名稱，請在此教學課程中都使用此名稱。

  7. 在 [專案儲存庫] 下，選擇GitHub。

  8. 如果您選擇 GitHub，您將需要選擇或建立連線資源。如果您有現有的連線，請在搜尋欄位中選擇該連線。否則，您將在此處創建一個新的連接。選擇「Connect 至」 GitHub。

    [建立連線] 頁面隨即顯示。

    注意

    若要建立連線，您必須擁有一個 GitHub 帳戶。如果您要為組織建立連線，您必須是組織擁有者。

    1. 在 [建立 GitHub 應用程式連線] 底下的 [連線名稱] 中，輸入連線名稱。選擇「Connect 至」 GitHub。

      [Connect 到] GitHub 頁面隨即顯示並顯示 [GitHub 應用程式] 欄位。

    2. 在 [GitHub 應用程式] 下方，選擇應用程式安裝，或選擇 [安裝新的應用程式] 來建立

      注意

      您可以為您連至特定供應商的所有連線安裝一個應用程式。如果您已經安裝 GitHub應用程式的AWS連接器，請選擇該連接器並略過此步驟。

    3. 在 [安裝AWS連接器 GitHub] 頁面上，選擇您要安裝應用程式的帳戶。

      注意

      如果您先前已安裝應用程式，可以選擇 Configure (設定)，繼續前往應用程式安裝的修改頁面，或者您可以使用上一步按鈕返回主控台。

    4. 如果顯示 [確認密碼以繼續] 頁面，請輸入您的 GitHub 密碼，然後選擇 [登入]。

    5. 在 [安裝AWS連接器 GitHub] 頁面上，保留預設值，然後選擇 [安裝]。

    6. 在 [Connect 至 GitHub] 頁面上，新安裝的安裝 ID 會出現在GitHub應用程式中。

      成功建立連線之後，會在 [ CodeStar 建立專案] 頁面中顯示 [準備連線] 訊息。

      注意

      您可以在「開發人員工具」主控台的「設定」下檢視連線。如需詳細資訊，請參閱開始使用連線。

      顯示為 GitHub 儲存庫設定完成連線的主控台螢幕擷取畫面。

    7. 對於存放庫擁有者，請選擇 GitHub組織或您的個人 GitHub 帳戶。

    8. 對於存放庫名稱，請接受預設 GitHub存放庫名稱，或輸入不同的存放庫名稱。

    9. 選擇「公開」或「私人」

      注意

      如果要用AWS Cloud9作開發環境，則必須選擇一個公共存儲庫。

    10. (選擇性) 在存放庫說明中，輸入 GitHub 存放庫的說明。

  9. 如果您的專案部署到 Amazon EC2 執行個體且想要進行變更，請在 Amazon EC2 組態中設定您的 Amazon EC2 執行個體。例如，您可為專案選擇可用的執行個體類型。

    在 key pair 中，選擇您在其中建立的 Amazon EC2 金鑰配對步驟 4：為 AWS CodeStar 專案建立 Amazon EC2 金鑰對。選取 [我確認我有權存取私密金鑰檔案]。

  10. 選擇下一步。

  11. 檢閱資源和組態詳細資訊。

  12. 選擇 Next (下一步) 或 Create project (建立專案)。(顯示的選項視您的專案範本而定。)

    在創建項目時允許幾分鐘。

  13. 創建項目後，選擇查看應用程序以查看您的 Web 應用程序。

步驟 2：檢視您的原始程式碼

在此步驟中，您可以檢視原始程式碼以及可用於來源儲存庫的工具。

  1. 在專案的導覽列中，選擇 [儲存庫]。

    若要檢視中的提交清單 GitHub，請選擇 [檢視認可]。這會在中打開您的提交歷史記錄 GitHub。

    若要檢視問題，請選擇專案的「問題」頁標。若要在中建立新問題 GitHub，請選擇 [建立 GitHub問題]。這會在中開啟您的存放庫問題表單 GitHub。

  2. 在「存儲庫」選項卡下，選擇「存儲庫名稱」下的鏈接，您的項目存儲庫將在新選項卡或窗口中打開。此儲存庫包含專案的原始程式碼。

步驟 3：建立提 GitHub 取請求

在此步驟中，您會對原始程式碼進行小幅變更，並建立提取要求。

  1. 在中 GitHub，在存放庫中建立新的功能分支。選擇主分支下拉式欄位，並在名為的欄位中輸入新分支feature-branch。選擇 [建立新分支]。即會為您建立並出庫分支。

  2. 在中 GitHub，對分feature-branch支進行變更。開啟公用資料夾並開啟index.html檔案。

  3. 在AWS CodeStar主控台的 [提取要求] 底下，若要在中建立提取要求 GitHub，請選擇 [建立提取要求]。這會在中開啟您的儲存庫提取請求表單 GitHub。在中 GitHub，選擇鉛筆圖示以編輯檔案。

    之後Congratulations!，添加字符串Well done, <name>!並替換為您<name>的名字。選擇 Commit changes (遞交變更)。更改已提交給您的功能分支。

  4. 在AWS CodeStar主控台中，選擇您的專案。選擇「儲存區域」頁籤。在提取請求下，選擇建立提取請求。

    表單即會在中開啟 GitHub。將主分支保留在基本分支中。對於「比較目標」，請選擇您的功能分支。檢視差異。

  5. 在中 GitHub，選擇建立提取請求。已建立名為更新 index.html 的提取要求。

  6. 在AWS CodeStar主控台中，檢視新的提取要求。選擇「合併變更」，將變更提交至儲存庫，並將提取要求與儲存庫的主分支合併。

  7. 返回中的專案AWS CodeStar並檢查「管線」頁面。您現在應看到管道正在部署。

  8. 創建項目後，選擇查看應用程序以查看您的 Web 應用程序。