iT邦幫忙

2021 iThome 鐵人賽

DAY 10
0
DevOps

DevOps 萌新的 TeamCity 極速上手寶典系列 第 10

第十天:在 TeamCity 上完成第一個建置工作

在前一天的練習裡,我們雖然只寫了一個非常簡單的 Hello World 程式,但只要能在 Run 面板裡看到 Hello, world 字串的輸出,就表示我們已經能成功的完成一個建置(Build)。而這個建置工作,我們接下來就可以委託給 TeamCity 執行。所以今天的練習就是要在 TeamCity 上設定第一個專案,並讓專案能完成第一個建置工作。

在 TeamCity 上建立專案

首先以 Admin 權限的帳號登入 TeamCity(不論您用哪種方式安裝畫面都是雷同的,本系列會使用 TeamCity Cloud 示範),點選上方導覽選單最右邊的 Administration 的連結進入到系統設定,選擇左側欄選單裡的 Projects,然後點選畫面右邊的 Create project 按鈕。

在建立專案的第一步,可以選擇 Repository 的來源,TeamCity 支援從 GitHub、Bitbucket Cloud、GitLab 抓取 Repository,或是直接把 Repository URL 貼上也可以(您可以直接用我的範例 Repo 來練習)。我們的範例 Repository 是 Public 的所以沒有存取限制,假如您使用的是 Private Repository,別忘了輸入 Username 及 Password。Parent project 則保持預設就好。

第二步可以設定 Project name(TeamCity 會自動從 Repo 名稱抓,有需要再改)、Build configuration name(預設就叫 Build)、Default Branch(預設會抓 main 或 master)。沒有特殊需求的話,基本上全用預設值就可。

第三步要設定 Build Step,也就是當 TeamCity 在執行建置工作時,要有哪些步驟?TeamCity 會很聰明的掃描 Repository 可能的設定檔,然後列出它覺得可以做的動作有哪些?我們可以依據自己的需求來做設定。以我們的範例 Repo 為例,TeamCity 猜到有兩個動作可以做,一個是 Gradle、一個是 Command Line。但我們其實只需要 Gradle 這個動作即可,所以勾 Gradle 的選項即可,然後點 Use selected 進到下一步。

執行第一次建置

完成後就可以點選畫面右上方的 Run 按鈕執行第一次的建置工作。

TeamCity 會自動把畫面帶到該次建置工作執行的頁面,您可以即時看到 TeamCity 正在做什麼?從一開始 TeamCity 正在尋找適合的 Agent、派發任務,Agent 接到任務後開始執行建置工作,從下載 Gradle 開始到執行 $ gradle clean$ gradle build 等動作。動作執行的過程中,您可以看到畫面上有時間軸顯示建置進程,同時也可以看到即時的 Console 輸出。

若建置過程中沒有發生錯誤的話,那這個建置就會被視為成功,您可以看到 TeamCity 會以綠色字及打勾的圖示來表示建置結果。恭喜您成功的完成第一次建置!

因為太簡單而覺得空虛?

您可能會覺得有點失落,覺得 TeamCity 好像也沒做什麼?跑完了好像也什麼都沒「產生」出來?這是因為我們目前的專案還太簡單,也沒有做任何的語法檢查、測試、產生文件…等動作,所以暫時看不出 TeamCity 可以幫助我們什麼?這沒關係,在後續的章節我們會持續在 IDE 及 TeamCity 之間來回,並加入更多的自動化動作,敬請期待!

參考資料


上一篇
第九天:建立練習專案
系列文
DevOps 萌新的 TeamCity 極速上手寶典10

尚未有邦友留言

立即登入留言