練習 - 設定您的 Azure DevOps 環境

8 分鐘

在此單元中，您將會確定您的 Microsoft Azure DevOps 組織已適當設定，以完成本課程模組的其餘部分。

若要這麼做，您將會：

設定本課程模組的 Azure DevOps 專案。
請務必在本機設定專案，以將變更推送至管線。

取得 Azure DevOps 專案

在這裡，您將透過執行在 Azure DevOps 中為您建立專案的範本，確定您的 Azure DevOps 組織已安排要完成本課程模組的其餘部分。

此學習路徑中的課程模組是連貫的進程，以便您跟著 Tailspin Web 小組完成 DevOps 旅程。為方便學習，每個課程模組皆有相關聯的 Azure DevOps 專案。

執行範本

執行用於設定 Azure DevOps 組織的範本。

在 Visual Studio 或您選擇的 IDE 中取得並執行 ADOGenerator 專案。
當系統提示您 從範本清單中輸入範本號碼時，請在 Azure Pipelines 中輸入 28 代表 [裝載您自己的組建代理程式]，然後按 Enter。
選擇您的驗證方法。您可以設定並使用個人存取令牌（PAT）或使用裝置登入。

注意

如果您設定 PAT，請務必授權必要的範圍。在此課程模組中，您可以使用 完整存取權，但在真實世界中，您應該確保只授與必要的範圍。
輸入您的 Azure DevOps 組織名稱，然後按 Enter。
如果出現提示，請輸入您的 Azure DevOps PAT，然後按 Enter。
輸入項目名稱，例如 Space Game - web - Agent，然後按 Enter。
建立項目之後，請移至瀏覽器（at https://dev.azure.com/<your-organization-name>/）中的 Azure DevOps 組織，然後選取專案。

分叉存放庫

如果您尚未建立 mslearn-tailspin-spacegame-web 存放庫的分支。

在 GitHub 上，移至 mslearn-tailspin-spacegame-web 存放庫。
選取畫面右上方的 Fork。
選擇您的 GitHub 帳戶作為擁有者，然後選擇建立 Fork。

重要

此課程模組中的 [清除您的 Azure DevOps 環境] 頁面包含重要的清除步驟。執行清除有助於確保您不會用盡可用的建置時間。請務必執行清除步驟，即使您未完成此課程模組亦然。

在本機設定專案

在這裡，您會在 Visual Studio Code 中載入 Space Game 專案、設定 Git、在本機複製存放庫，以及設定上游遠端，以便下載入門程序代碼。

注意

如果您已在本機設定 mslearn-tailspin-spacegame-web 專案，則可以前往下一節。

開啟整合式終端

Visual Studio Code 隨附整合式終端，可讓您完全只從命令列來編輯檔案和工作。

啟動 Visual Studio Code。
在 [檢視] 功能表上選取 [終端]。
在下拉式清單中，選取 [bash]。如果您熟悉的是其他慣用的 Unix 殼層 (例如 Zsh)，請改為選取該殼層。

終端視窗可讓您選擇在系統上安裝的任何殼層，例如 Bash、Zsh 和 PowerShell。

在這裡，您將會使用 Bash。 Git for Windows 提供 Git Bash，可讓您輕鬆地執行 Git 命令。

注意

在 Windows 上，如果您沒有看到 Git Bash 列為選項，請確定您已安裝 Git，然後重新啟動 Visual Studio Code。
執行 cd 命令以導覽至您要的工作目錄，例如主目錄 (~)。想要的話，您可以選擇不同目錄。
```
cd ~
```

設定 Git

如果您不熟悉 Git 和 GitHub，則必須先執行幾個命令，將您的身分識別與 Git 建立關聯，並向 GitHub 進行驗證。

設定 Git 更詳細地說明了這個過程。

您至少需要完成下列步驟。從整合式終端執行下列命令：

注意

如果您已搭配 GitHub 使用雙因素驗證，請建立個人存取令牌，並在稍後出現提示時使用您的令牌來取代密碼。

將存取權杖視同密碼。請保存在安全的位置。

在 Visual Studio Code 中設定專案

在這部分，您在本機複製分支，以進行變更並建立管線設定。

注意

如果您在複製存放庫時收到檔案名稱太長的任何錯誤，請嘗試在沒有長名稱或深度巢狀的資料夾中複製存放庫。

在本機複製您的分支

您現在有 GitHub 帳戶中的 Space Game Web 項目複本。現在，您將下載或複製複本到您的計算機，以便使用它。

複製類似於分支，都是存放庫的複本。當您複製存放庫時，您可以進行變更、確認如預期運作，然後將這些變更上傳回到 GitHub。其他已驗證使用者所做的 GitHub 存放庫複本變更也可同步至本機複本。

若要將 Space Game Web 專案複製到您的電腦：

移至您在GitHub 上的 Space Game Web 專案 (mslearn-tailspin-spacegame-web) 分支。
選取 [程式碼]。然後，從 [HTTPS] 索引標籤中，選取所顯示 URL 旁的按鈕，將 URL 複製到剪貼簿。
在 Visual Studio Code 中，前往終端視窗。
在終端中前往您要的工作目錄，例如主目錄 (~)。想要的話，您可以選擇不同目錄。
```
cd ~
```
執行 git clone 命令。以您剪貼簿的內容取代這裡所顯示的 URL：
```
git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
```
移至 mslearn-tailspin-spacegame-web 目錄。這是您存放庫的根目錄。
```
cd mslearn-tailspin-spacegame-web
```

設定上游遠端

遠端是小組成員共同作業的 Git 存放庫（例如 GitHub 上的存放庫）。在這裡，您會列出遠端存放庫，並新增指向 Microsoft 存放庫複本的遠端存放庫，讓您可以取得最新的範例程式碼。

執行此 git remote 命令以列出您的遠端存放庫：
```
git remote -v
```
您會看到自己擁有存放庫的擷取 (下載) 和推送 (上傳) 存取權：
```
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
```
Origin 會指定 GitHub 上的存放庫。當您從另一個存放庫派生程式碼時，通常會將原始遠端 (派生來源) 命名為 upstream。
執行此 git remote add 命令，建立名為 upstream 的遠端存放庫，此存放庫指向 Microsoft 存放庫：
```
git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
```

再次執行 git remote 以查看變更：

git remote -v

您會看到自己仍具有存放庫的擷取 (下載) 和推送 (上傳) 存取權。您現在也具有 Microsoft 存放庫的擷取和推送存取權：

origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)

在檔案總管中開啟專案

在 Visual Studio Code 中，您的終端機視窗會指向 Space Game Web 專案的根目錄。您將從檔案總管中開啟專案，以利您檢視其結構以及使用檔案。

開啟專案最簡單的方式是在目前的目錄中重新開啟 Visual Studio Code。若要執行此作業，請在整合式終端中執行下列命令：
```
code -r .
```
您會看到在 [檔案總管] 中的目錄和檔案樹狀目錄。
開啟整合式終端。此終端會進入 Web 專案的根目錄。

如果 code 命令失敗，則您需要將 Visual Studio Code 新增至系統 PATH。若要這麼做︰

在 Visual Studio Code 中，選取 F1 或選取 [ 檢視>命令選擇區 ] 以存取命令選擇區。
在命令選擇區中，輸入 Shell命令：在PATH中安裝 'code' 命令。
重複上述程序，在檔案總管中開啟該專案。

您現在已準備好使用本機開發環境中的 Space Game 原始程式碼以及 Azure Pipelines 組態進行工作。