練習 - 建立、檢閱及合併提取要求

5 分鐘

您已完成將佇列新增至網站的工作。現在，網站開發小組已準備好將變更合併至主分支。在此練習中，您將建立及合併變更的提取要求。

在此過程中，您將會：

建立提取要求。
檢閱提取要求。
完成提取要求。
確認變更已合併。

建立提取要求以合併功能分支

由於無法直接將變更推送至存放庫的主分支，您必須建立提取要求。

在瀏覽器中，移至 [程式碼]。
選取 [2 個分支]，以在 GitHub 存放庫中列出分支。
在 add-orders-queue 旁，選取 [更多] 圖示 (...)，然後選取 [新增提取要求]。
建立提取要求時，請注意，GitHub 已自動使用 Git 認可訊息作為提取要求的標題。

將描述更新為下列文字：

此 PR 會新增處理訂單的新 Azure 儲存體佇列，並更新網站設定以包含儲存體帳戶和佇列資訊。
選取 [建立提取要求]。

在瀏覽器中，移至 [存放庫]>[檔案]。

請注意，Azure DevOps 會顯示橫幅，指出 add-orders-queue 分支中的變更。橫幅能為這些變更建立提取要求。
選取 [建立提取要求]。
在建立提取要求的頁面上，請注意，Azure DevOps 已自動使用 Git 認可訊息作為提取要求標題。

將描述更新為下列文字：

此 PR 會新增處理訂單的新 Azure 儲存體佇列，並更新網站設定以包含儲存體帳戶和佇列資訊。
選取建立。

檢閱提取要求

一般而言，提取要求是由建立者以外的人員檢閱。在此範例中，您將假扮為另一個小組成員，並檢閱自己的提取要求。

從提取要求頁面中，選取 [檔案已變更] 索引標籤。

GitHub 會顯示在此提取要求中已變更的檔案。請注意，GitHub 會醒目提示所有已變更的行，因此您可以輕鬆查看應檢閱的內容。

提示

想像一下，您正在為自己的小組檢閱此內容。您是否有任何建議？
在已變更的 main.bicep 檔案中，將滑鼠暫留在第 18 行，然後選取具有加號 (+) 的按鈕。
在註解方塊中，輸入下列文字：這應該大寫嗎？
選取 [開始檢閱]。

提示

GitHub 不會讓您核准自己的提取要求。在這裡，您將對您的提取要求進行註解，但不會核准。當您處理自己小組的提取要求時，此時您就能批准要求以表明您很高興將其合併。
選取 [完成您的檢閱]。
在出現的檢閱面板中，選取 [提交檢閱]。

GitHub 會將您返回至提取要求的 [對話] 索引標籤。

從提取要求頁面中，選取 [檔案] 索引標籤。

Azure DevOps 會顯示在此提取要求中已變更的檔案。請注意，GitHub 會醒目提示所有已變更的行，因此您可以輕鬆查看應檢閱的內容。

提示

想像一下，您正在為自己的小組檢閱此內容。您是否有任何建議？
在已變更的 main.bicep 檔案中，將滑鼠暫留在第 18 行，然後選取註解按鈕。
在註解方塊中，輸入下列文字：這應該大寫嗎？
選取 [註解]。

瀏覽器視窗的寬度可能會影響註解對話方塊的顯示方式。註解將開啟 [討論] 對話方塊，而不是內嵌註解，如螢幕擷取畫面所示。
選取 [核准]。

選取 [核准] 之後，[設定自動完成] 即會變更為 [完成]。您稍後將在本單元中使用該功能。

回應提取要求檢閱

當建立或檢閱提取要求時，您可以參與相關內容的對話。想像一下，您是此檔案的作者，而您想要回應檢閱者的註解。

使用下列註解回應對提取要求的檢閱：否，儲存體佇列必須具有小寫名稱。
選取 [註解]，然後選取 [解決對話]，表示該行的討論已結束。

從提取要求頁面中，選取 [概觀] 索引標籤。
現在，假設您是這個檔案的作者。使用下列註解回應對提取要求的檢閱：否，儲存體佇列必須具有小寫名稱。
選取 [回覆並解決] 以表示該行的討論已結束。

完成提取要求

您網站的開發小組已確認您已經可以將訂單傳送至佇列中，因此您可以準備完成並合併您的提取要求。

您的提取要求已獲批准。您網站的開發小組已確認您已經可以將訂單傳送至佇列中，因此您可以準備完成並合併您的提取要求。

選取 [合併提取要求]。
GitHub 要求您確認合併。當 GitHub 合併提取要求時，會建立認可，並自動產生認可訊息。選取 [確認合併]。

您的提取要求已合併，且您的新功能現在位於存放庫的主分支中。
當您完成功能分支後，最好將其刪除。刪除分支有助於您避免將來會讓小組成員混淆哪些工作仍在進行中。選取 [刪除分支]。

選取 [完成]。
從 [完成提取要求] 中，使用預設設定。選取 [完成合併]。

您的提取要求已合併，且您的新功能現在位於存放庫的主分支中。

當您合併提取要求時，Azure DevOps 會自動刪除功能分支。當您完成功能分支後，最好將其刪除。刪除分支有助於您避免將來會讓小組成員混淆哪些工作仍在進行中。

驗證變更

合併提取要求之後，最好要確認變更已成功合併。

移至 [程式碼]。
移至 deploy/main.bicep 檔案，然後移至 deploy/modules/appService.bicep 檔案。

請注意，佇列和其他變更現在位於檔案中。

移至 [存放庫]>[檔案]。
移至 deploy/main.bicep 檔案，然後移至 deploy/modules/appService.bicep 檔案。

請注意，佇列和其他變更現在位於檔案中。