[第八屆IT邦幫忙鐵人賽] TeamCity Build Configuration 介紹

前言

前兩篇文章中,我們說明了安裝 TeamCity 與增加 Build Agent的設定步驟,而在這一篇我會簡單介紹 TeamCity 的操作介面與如何設定 build configuration(建置設定) 功能,讓大家能在 TeamCity 上進行基本操作。本篇文章若有錯誤或任何建議,請各位先進不吝提出,謝謝!

介紹

導覽功能列

http://ithelp.ithome.com.tw/upload/images/20161204/20091494KsIfHzjCJa.png
在 TeamCity 網頁最上方導覽功能包含了 Project, Change, Agents 與 Build Queue,右邊包含目前使用者的姓名、Administration與搜尋功能。

  1. Project: 列出專案與其 build configuration,可以在此執行工作與檢視其執行狀態。
  2. Change: 檢視近期內執行工作歷史紀錄。
  3. Agents: 檢視與設定 Build Agents 功能。
  4. Build Queue: 工作貯列,可以觀看有哪些工作正在等待。
  5. 使用者姓名: 可以依據使用者習慣進行設定。
  6. Administration: 管理者頁面,包含專案相關設定、權限管理、整合工具與進階管理功能。

'

專案儀表板 (Project)

http://ithelp.ithome.com.tw/upload/images/20161204/20091494sdLfbfz1g9.png
專案儀錶板為最主要操作畫面,在這個畫面列出了專案、子專案與底下每一個 Build Configuration,開發人員可以手/自動選擇那一個 Branch 與 Agent 執行建置工作,並檢視每個建置工作執行進度與結果。我們通常在每個專案底下皆會設定子專案來進行分類與管理,像是區分:

  • 開發環境
  • 功能、模組或微服務
  • 測試組合(整合測試、壓力測試)

如上圖所例, Devops 開發流程依據需求通常會區分 Dev, QA, Staging, Production...等不同環境,一來讓開發人員、測試人員與發佈管理人員工作的時候不會互相影響,二來嚴謹循序的佈署流程讓問題發生率降至最低。專案儀錶板也顯示了佈署版本號碼與工作執行狀態,讓開發人員可以透過這些資訊了解自動化執行情況,一旦錯誤發生,開發人員也能夠過 log 了解哪一個工作階段(編譯? 測試? 佈署?)發生錯誤。

'

建置專案與 build configuration

註:若您看不到Administration,請確認您有足夠權限

Step 1 我們點選右上角 Administration,在 Projects 功能頁面內,點選 Create Project
http://ithelp.ithome.com.tw/upload/images/20161204/20091494KgrlWxDi3K.png

Step 2 輸入 Project Name,ID會隨著name自動產生(您也可以自行修改)。輸入完成後點 Create。
http://ithelp.ithome.com.tw/upload/images/20161204/20091494isHIEMLN3F.png

Step 3 您可以在 Project 底下建立 Sub Project 方便進行管理;您也可以直接開始 Build Configuration 設定,或建立 Build Template 讓其他 Build Configuration 繼承使用。
http://ithelp.ithome.com.tw/upload/images/20161204/20091494658MQUvW2G.png

Step 4 我們在建立一層 Sub Project 進行環境管理,名稱為 Dev 。
http://ithelp.ithome.com.tw/upload/images/20161204/200914944gWnXFoXmf.png

http://ithelp.ithome.com.tw/upload/images/20161204/20091494uBaFanhjmJ.png

Step 5 建立好 Sub Project,我們開始建立一個新的 Build Configuration
http://ithelp.ithome.com.tw/upload/images/20161204/20091494BLcbgUcpP7.png

Step 6 輸入 Build Configuration name 與 ID
http://ithelp.ithome.com.tw/upload/images/20161204/2009149446ZmWvIQoo.png

Step 7 第一次建立 Build Configuration 會進入下面畫面,輸入版本控管相關資訊設定(CVS)(像是 url、帳號與密碼等),這裡有多種不同 CVS 設定提供選擇;您也可以按下 skip 略過 CVS 設定。
註:但並非所有 Build Configuration 需要這些資訊,如:壓力測試就不需要輸入CVS相關資訊。您可以依據需求進行設定。
http://ithelp.ithome.com.tw/upload/images/20161204/200914941KdRC0DJwO.png

Step 8 來到 Build Configuration 設定畫面
http://ithelp.ithome.com.tw/upload/images/20161204/20091494OKxzNE0DL4.png
如上圖,您能看見左邊有些設定選項(只介紹常用的,其他部分略過):

  1. General Setting: 設定專案名稱、ID與描述
  2. Version Control Settings: 版本控管相關設定
  3. Build Steps: 最重要的功能,建置工作步驟設定。
  4. Trigger: 觸發程序,您可以設定每天定時執行工作,或程式碼變更(push)的時候進行工作。
  5. Build feature: 執行工作過程中相關設定,像是效能監控與硬碟空間需求。
  6. Parameters: 可以設定Configuration變數、環境變數與系統變數,於設定Build Configuration或撰寫Build Script的時候可以參考使用。

我們會在 Build Steps 內設定每一個自動化流程的步驟:TeamCity Agents將透過內部預設或自行撰寫的 Build scripts 執行每一個步驟。我們將在後面的章節說明如何使用 Gulp 與 Powershell 來撰寫 Build scripts,在本章節只先做簡單介紹。

Step 9 返回 Project,您可以看見建置的結果。
http://ithelp.ithome.com.tw/upload/images/20161204/20091494ImQDP22crz.png

'

執行與執行狀態

http://ithelp.ithome.com.tw/upload/images/20161204/20091494cKWedLTZmD.png
如上圖,當執行工作的時候,會顯示進度條與預估時間;而發生錯誤或測試失敗的時候,可以點選狀態旁的小三角形按鈕 -> Build log 來檢視詳細錯誤訊息(非常重要)

'


上一篇:TeamCity 增加 Agents
下一篇:ASP.NET Core 介紹與安裝
返回目錄


參考資料:

註:本系列文章將於2016 IT邦幫忙鐵人賽進行同時,一併發佈於個人blogger與dotblog。