練習 - 建立並執行基本管線

• 7 分鐘

您想要將更新自動部署到您的玩具公司網站。 第一個步驟是在 Azure DevOps 中建立基本管線。

在本練習中，您將會：

在 Azure DevOps 中建立專案

1. 在瀏覽器中，移至 dev.azure.com。 登入或建立新的帳戶。

2. 如已建立新的帳戶，請依提示建立 Azure DevOps 組織。 Azure DevOps 接著會提示您建立新專案。 繼續下一個步驟，以設定專案。

   若已登入現有的 Azure DevOps 組織，請選取 [新增專案] 建立新的專案。

   

3. 在 [建立專案以開始使用] 窗格中，輸入新專案的下列詳細資料：

   • 專案名稱：使用有意義但簡短的名稱。 在此練習中，請輸入 toy-website。
   • 描述：輸入專案用途的描述。 在此練習中，輸入 Toy 公司網站。
   • 可見度：您可以使用 Azure DevOps 建立公用與私人存放庫。 在此情況中，存放庫應該是私人的，因為您的公司網站檔案應該只能由組織內的人員存取。 您稍後可以將存取權授與其他使用者。

   您的專案設定看起來應該類似此範例：

   

4. 選取建立專案。

複製存放庫

1. 在歡迎窗格中，或在資源功能表上，選取 [Repos]。

   

2. 如果您使用 macOS，則需要特殊的密碼才能複製 Git 存放庫。 選取 [產生 Git 認證]，並將顯示的使用者名稱和密碼複製到安全的位置。

3. 在 [複製到您的電腦] 區段中，選取 [在 VS Code 中複製]。 如果系統提示您允許開啟 Visual Studio Code，請選取 [開啟]。

   

4. 如果出現對話方塊，提示您允許延伸模組開啟存放庫 URI，請選取 [開啟]。

5. 在本機裝置上建立要用於此存放庫的資料夾，然後選取 [選取存放庫位置]。

6. 因為您是第一次使用此存放庫，系統會提示您登入。

   若為 Windows，請輸入您稍早在本練習中用來登入 Azure DevOps 的相同認證。

   若為 macOS，請輸入您稍早所產生的 Git 使用者名稱和密碼。

7. Visual Studio Code 會提示您開啟存放庫。 選取開啟。

   

安裝 Azure Pipelines 延伸模組

Microsoft 發行了適用於 Visual Studio Code 的 Azure Pipelines 延伸模組。 此延伸模組可協助您撰寫管線 YAML 檔案。 建議您安裝此延伸模組，以便在工作時驗證 YAML 檔案。

1. 在 Visual Studio Code 中，選取 [檢視] > [延伸模組] (快速鍵為 Ctrl+Shift+x)。

2. 在 [搜尋] 方塊中，輸入 Azure Pipelines，然後選取由 Microsoft 發行的 Azure Pipelines 延伸模組。 選取安裝。

   

建立 YAML 管線定義

建立組織、專案與存放庫後，您就可以開始建立基本的管線定義。

1. 在 Visual Studio Code 中，開啟 [總管]。

2. 在 [總管] 中，將滑鼠停留在 TOY-WEBSITE 專案資料夾上，然後選取 [新增資料夾] 圖示。 將該資料夾命名為 deploy。

3. 選取 [部署] 資料夾，然後在 TOY-WBSITE 專案中選取 [新增檔案] 圖示。 將檔案命名為 azure-pipelines.yml。

   

4. YML 檔案會在主面板中開啟。 將下列管線定義程式碼貼上到檔案中：

   trigger: none
   
   pool:
     vmImage: ubuntu-latest
   
   jobs:
   - job:
     steps:
     - script: echo Hello world!
       displayName: 'Placeholder step'
   

5. 儲存對檔案所做的變更。

6. 透過選取 [終端機]>[新增終端機]，開啟一個 Visual Studio Code 終端機視窗。

   終端機視窗隨即開啟，通常在畫面的下半部開啟。

7. 若要認可並將 azure-pipelines.yml 檔案推送至 Git 存放庫，請將此程式碼貼上至終端機面板中，然後按 Enter。

   git add deploy/azure-pipelines.yml
   git commit -m "Add initial pipeline definition"
   git push
   

在 Azure Pipelines 中設定管線

您已建立管線定義。 接下來，向 Azure Pipelines 註冊管線。

1. 在 Azure DevOps 工作階段的資源功能表中，選取 [管線]，然後在 [建立您的第一個管線] 窗格中，選取 [建立管線]。

   

2. 在 [連線] 索引標籤上 ([您的程式碼在哪裡?] 窗格)，選取 Azure Repos Git。

   

3. 在 [選取] 索引標籤的 [選取存放庫] 窗格中，選取 toy-website。

   

4. 在 [設定] 索引標籤上 ([設定您的管線] 窗格)，選取 [現有 Azure Pipelines YAML 檔案]。

   

5. 在 [選取現有的 YAML 檔案] 窗格上的 [路徑] 下拉式清單中，選取 /deploy/azure-pipelines.yml，然後選取 [繼續]。

   

   [檢閱] 索引標籤 ([檢閱您的管線 YAML] 窗格) 會將您的 YAML 管線定義顯示為新的管線。

   提示

   您可使用 Azure Pipelines Web 介面提供的編輯器來管理管線定義。 在本課程模組中，您會使用 Visual Studio Code 中的定義檔案，但您也可以探索 Azure Pipelines 編輯器，查看其運作方式。

6. 選取執行。

   

   Azure Pipelines 會建立管線，並啟動第一次執行。

驗證管線執行

1. 當管線執行啟動後，會有頁面顯示執行的相關資訊。

   

   每個管線執行都包含一個識別碼。 您可以使用此識別碼協助尋找特定的管線執行。

   作業狀態一開始會顯示為 [已排入佇列]。 您的管線可能無法立即啟動。 您的作業會新增至代理程式的佇列。 代理程式可供使用後，Azure Pipelines 就會指派代理程式並啟動該作業。 接著，作業狀態會變成 [正在執行]。

   頁面中包含分支名稱，以及執行所使用之 Git 認可的識別碼。 此資訊會指出管線所用的存放庫內容版本。

2. 重新整理頁面，直到作業狀態變更為 [成功] 為止。 然後，在 [作業] 下選取 [作業]。

   

3. 作業資訊頁面會顯示管線所執行步驟的記錄。 您的預留位置步驟會列在左側功能表的步驟中。

   

   作業中的步驟清單包含您未建立的步驟。 這些步驟均由 Azure Pipelines 自動建立。 在某些組織中，您可能也會看到組織自動包含在所有管線中的步驟。 您可以選取任何步驟來檢視該步驟的記錄檔。

4. 選取 [簽出 toy-website@main 至 s]。

   

   每個步驟的記錄檔都會提供管線執行期間確實發生狀況的詳細資料。 如果您需要診斷管線的問題，則記錄資訊會很有幫助。 您無法直接存取執行步驟的代理程式。

   在本案例中，存放庫內容是從 Azure Repos 下載至代理程式的檔案系統。

5. 選取 [預留位置步驟]。

   

   此步驟的記錄包含您在管線 YAML 檔案中建立的指令碼內容，以及執行此指令碼的 Hello world! 文字輸出。

將管線執行連結至認可

建議先了解如何交互參考管線執行與其中所包含的認可。 將管線執行連結至認可，即可協助您追蹤部署和診斷問題的記錄。 Azure DevOps 提供數種將管線執行連結至認可的方式。 在此程序中，您會手動檢查認可歷程記錄。

1. 若要回到存放庫概觀，請在 [DevOps 資源] 功能表中，選取 [Repos] > [認可]。

   

   這個認可識別碼與您從管線執行中記下的認可識別碼相同。 而且，Azure Pipelines 會顯示與認可建立關聯的管線執行狀態。

2. 選取該項認可。 已變更的檔案清單和透過認可的變更會以綠色醒目提示，表示所有文字都是新的。