練習 - 設定您的 Azure DevOps 環境

已完成

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

若要這麼做,請:

  • 設定本課程模組的 Azure DevOps 專案。
  • 在 Azure Boards 上,將本課程模組的工作項目移至 [執行中] 資料行。
  • 請務必在本機設定專案,以將變更推送至管線。

取得 Azure DevOps 專案

請確定已設定 Azure DevOps 組織,以完成本課程模組的其餘部分。 您可以執行範本來完成此操作,該範本會在 Azure DevOps 中為您建立一個專案。

執行範本

執行範本以設定您 Azure DevOps 組織中的所有項目。

從 Azure DevOps 示範產生器網站中,進行下列步驟來執行範本:

  1. 選取 [登入] 並接受使用條款。

  2. 在 [建立新的專案] 頁面中,選取您的 Azure DevOps 組織,並輸入專案名稱,例如 Space Game - web - Tests

  3. 選取 [是,我要派生此存放庫] 旁邊的方塊,然後選取 [授權]。 如果出現視窗,則請授與對您 GitHub 帳戶的存取權。

    重要

    您必須選取此選項,範本才能連線至您的 GitHub 存放庫。 即使您已派生 Space Game 網站專案,仍應選取此選項。 範本會使用您現有的分支。

  4. 選取 [建立專案]

    Azure DevOps 示範產生器 [建立新專案] 的螢幕擷取畫面,其中醒目提示 [建立專案] 按鈕。

    執行範本需要一些時間。

  5. 選取 [瀏覽至專案],前往您在 Azure DevOps 中的專案。

重要

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

設定專案的可見度

一開始,GitHub 上 Space Game 存放庫的分支會設定為公用,而 Azure DevOps 範本所建立的專案設為私人。 GitHub 上的公用存放庫可供任何人存取,而私人存放庫只能存取您,以及您選擇與其共用的人員。 同樣地,在 Azure DevOps 上,公用專案會提供非驗證使用者的唯讀存取權,而私人專案則要求使用者獲得存取權,並經過驗證才能存取服務。

目前,為了本課程模組的目的,不需要修改任何這些設定。 不過,對於您的個人專案,您必須判斷您想要授與其他人的可見度和存取權。 例如,如果專案是開放原始碼,則您可以選擇將 GitHub 存放庫和 Azure DevOps 專案設為公用。 如果專案是專屬的,則您通常會將 GitHub 存放庫和 Azure DevOps 專案設為私人。

稍後,您可能會發現下列資源有助於判斷哪一個選項最適合您的專案:

在本機設定專案

您在 Visual Studio Code 中載入 Space Game 專案、設定 Git、在本機複製存放庫,並設定上游遠端存放庫,以下載起始程式碼。

注意

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

開啟整合式終端

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

  1. 啟動 Visual Studio Code。

  2. 在 [檢視] 功能表上選取 [終端]

  3. 在下拉式清單中,選取 [bash]。 如果您熟悉的是其他慣用的 Unix 殼層 (例如 Zsh),請改為選取該殼層。

    Visual Studio Code 的螢幕擷取畫面,其中顯示 Bash 殼層的位置。

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

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

    注意

    在 Windows 上,如果您看不到 [Git Bash] 列為選項,則請確定您已安裝 Git,然後重新啟動 Visual Studio Code。

  4. 執行 cd 命令以導覽至您要的工作目錄,例如主目錄 (~)。 想要的話,您可以選擇不同目錄。

    cd ~
    

設定 Git

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

設定 Git 將詳細說明此流程。

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

  1. 設定您的使用者名稱
  2. 設定您的認可電子郵件地址
  3. 快取您的 GitHub 密碼

注意

如果您已對 GitHub 使用雙重要素驗證,則請建立個人存取權杖,並在稍後提示時以您的權杖取代密碼。

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

在 Visual Studio Code 中設定專案

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

注意

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

在本機複製您的分支

您的 GitHub 帳戶中現在會有一個 Space Game Web 專案複本。 現在,您會將複本下載或複製至電腦,以供您使用。

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

如何將 Space Game Web 專案複製至您的電腦:

  1. 移至您在GitHub 上的 Space Game Web 專案 (mslearn-tailspin-spacegame-web) 分支。

  2. 選取 [程式碼]。 然後,從 [HTTPS] 索引標籤中,選取所顯示 URL 旁的按鈕,將 URL 複製到剪貼簿。

    在 GitHub 存放庫中找到 URL 和複製按鈕。

  3. 在 Visual Studio Code 中,前往終端視窗。

  4. 在終端中前往您要的工作目錄,例如主目錄 (~)。 想要的話,您可以選擇不同目錄。

    cd ~
    
  5. 執行 git clone 命令。 以您剪貼簿的內容取代這裡所顯示的 URL:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
    
  6. 移至 mslearn-tailspin-spacegame-web 目錄。 這是您存放庫的根目錄。

    cd mslearn-tailspin-spacegame-web
    

設定上游遠端

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

  1. 執行此 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

  2. 執行此 git remote add 命令,建立名為 upstream 的遠端存放庫,此存放庫指向 Microsoft 存放庫:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
    
  3. 再次執行 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 專案的根目錄。 您將從檔案總管中開啟專案,以利您檢視其結構以及使用檔案。

  1. 開啟專案最簡單的方式是在目前的目錄中重新開啟 Visual Studio Code。 若要執行此作業,請在整合式終端中執行下列命令:

    code -r .
    

    您會看到在 [檔案總管] 中的目錄和檔案樹狀目錄。

  2. 開啟整合式終端。 此終端會進入 Web 專案的根目錄。

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

  1. 在 Visual Studio Code 中,選取 F1 或選取 [檢視]>[命令選擇區] 來存取命令選擇區。
  2. 在命令選擇區中,輸入 Shell Command: Install 'code' command in PATH (殼層命令:在 PATH 中安裝「程式碼」命令)
  3. 重複上述程序,在檔案總管中開啟該專案。

您現在已設定為使用 Space Game 原始程式碼,以及您在本機開發環境中的 Azure Pipelines 設定。