好代碼是管出來的——使用GitHub實現簡單的CI/CD

軟體開發一般來說是一項團隊作業，在本系列文章開始就提到過軟體的編碼是由一個團隊「並行」完成的，為了保證編碼任務正常完成，首先引入版本控制工具來完成代碼管理，為了保證代碼質量引入了代碼分析器以及代碼測試。

版本控制工具可以保證代碼有一個主版本，但代碼分析和測試均是開發人員手動在本地完成的(通過編譯、執行測試等方式)，在進行代碼分析和測試時可能並沒有將本地代碼更新到最新版本，這樣就會出現一個問題，當多個開發人員向版本庫提交代碼時，無法保證最新代碼庫的代碼是正確的，為了解決這個問題，提出了持續集成，持續集成的集成指的是持續的對多個開發人員編寫的代碼進行集成，本文從下面幾個方面介紹持續集成以及基於Github進行持續集成實踐：

CI&CD

常用的持續集成工具

GitHub市場簡介

使用AppVeyor實現持續集成

使用Codecov顯示代碼覆蓋率

小結

CI&CD

持續集成(Continuous integration，CI)指的是在開發過程中持續地將所有開發人員的代碼合併到代碼庫的主線上，然後對該主線代碼進行編譯、測試運行等操作對代碼進行檢驗，其目的是儘可能早的發現代碼集成後導致的問題。

實現持續集成的要點主要有：共享的代碼庫、自動化編譯、自動化測試等，同時要保證合理的集成頻率，一般持續集成的時機在於開發人員將代碼提交到代碼庫時自動進行，但是如果提交過於頻繁，那麼應該使用時間間隔的形式進行持續集成。

持續發布(Continuous delivery,CD)實際上是持續集成上的一個拓展，在持續集成的基礎上將發布工作自動化，避免人為操作從而減少發布時間和發布時人為造成的錯誤。

常用的持續集成工具

持續集成經過多年的發展，在不同的應用場景、平台/語言、商業化等因素下產生了許多持續集成工具，可參考(但不限於這些)：　　https://en.wikipedia.org/wiki/Comparison_of_continuous_integration_software

比較常用的持續集成工具有：

Jenkins

Jenkins是一個開源的跨平台持續集成工具，它提供了GUI界面以及大量的拓展插件，通過GUI界面可以簡單、快速的完成項目持續集成配置，更重要的是Jenkins支持所有的版本控制工具。

項目地址：https://jenkins.io/

TeamCity

TeamCity是JetBrains公司開發的持續集成工具，它有免費和收費兩種授權，免費版本的TeamCity擁有所有功能，其限制僅僅是只能創建100個編譯配置和只能並行運行3個代理。

項目地址：http://www.jetbrains.com/teamcity/

GitLab

GitLab是一個Git的代碼管理工具，使用GitLab可以輕鬆的在Linux環境搭建一個Git的遠程代碼託管平台，同時GitLab中也內置的CI/CD功能。

項目地址：https://about.gitlab.com/

Travis CI

Travis CI是一個持續集成託管平台，它為開源項目提供免費支持，但Travis CI不支持Windows下編譯。

項目地址：https://www.travis-ci.org/

AppVeyor

AppVeyor也是一個持續集成的託管平台，它支持Windows和Linux，並且AppVeyor可以對環境進行定製：https://www.appveyor.com/docs/build-environment/，是一個非常強大的CI工具，AppVeyor對開源項目提供免費支持。

項目地址：https://www.appveyor.com/

VSTS

VSTS(Visual Studio Team Services)是微軟的軟體開發管理解決方案，它包含了代碼版本管理、持續集成/發布、敏捷等特性，並且VSTS為5人以下團隊提供了免費使用。

項目地址：https://visualstudio.microsoft.com/zh-hans/team-services/

總的來說持續集成工具分為可本地安裝和平台託管兩類，本地安裝類型的工具適合有專用構建伺服器資源的閉源項目(當然開源項目也可以使用)，而託管平台則比較適合開源或者沒有專用構建伺服器資源的項目，使用上託管平台更加省心，這些工具需要根據實際情況來進行選用。

GitHub市場簡介

GitHub作為一個分散式的軟體管理解決方案，它除了提供代碼託管外，還通過應用市場的方式提供了拓展應用，這些應用主要用於持續繼承、部署、測試、代碼審查、項目管理等等，詳情查看：https://github.com/marketplace/

下圖為Github市場中的CI工具：

一般來說市場中提供的應用對於開源項目都是可以免費使用的，下面就介紹如何將Github上的開源項目使用其市場應用完成持續集成。

使用AppVeyor實現持續集成

AppVeyor是一個支持自定義持續集成環境的CI工具，它對.Net程序的支持非常強大，同時對開源項目免費，所以AppVeyor是.Net Core項目持續集成的首選，下面就介紹如何使用AppVeyor完成持續基礎：

1. 在GitHub市場中找到AppVeyor，並完成安裝：

2. 添加項目：

選擇GitHub倉庫，並完成授權：

添加需要的倉庫：

點擊「NEW BUILD」進行一次編譯：

從編譯的信息可以看到，此次編譯失敗了，並且給出了相應的錯誤信息，這是由於編譯環境導致的。

3. 環境配置：

將編譯鏡像選擇為VS2017：

在編譯前先執行dotnet restore命令還原項目依賴：

4. 開始一個新的編譯：

編譯結果：

從編譯結果可以看出Appveyor不僅僅是完成了編譯工作，而且還搜索了測試信息，並完成了測試。另外有一個要點是本項目中的測試是依賴資料庫的，這就意味著Appveyor的編譯環境提供了SQL Server數據的支持。

5. 將編譯後的內容發布到GitHub release：

為xUnitTestDemo代碼庫添加一個Tag：

然後Appveyor將會檢測到代碼庫的變化，自動編譯Tag，並將結果部署到Github的Release中：

自動部署的Release內容：

關於appveryor部署的更多信息參考：https://www.appveyor.com/docs/deployment/

6. 將編譯狀態顯示到GitHub上：

Appveyor的Badges(標記)配置界面中可以獲取到狀態標記地址：

將MarkDown的代碼複製到項目的README.md文件中：

效果：

7. 導出appveyor.yml文件以及通過appveyor.yml來完成配置：

上面的方法是通過Appveyor的Web界面上完成配置的，除此之外還可以通過appveyor.yml文件來完成配置，appveyor.yml文件可以自己創建或導出已有配置：

導出已有配置：

將appveyor.yml文件放置到代碼根目錄，並通過修改該文件來變更配置：

上圖在原有配置基礎上修改為release的方式編譯代碼，並且指定生成結果目錄，將結果進行壓縮。

更多appveyor.yml配置可參考：https://www.appveyor.com/docs/appveyor-yml/

使用Codecov顯示代碼覆蓋率

Codecov也是Github市場的一個應用，它用於生成代碼覆蓋率報告，codecov對C#的支持是基於OpenCover的(使用OpenCover檢測代碼覆蓋率參考：好代碼是管出來的——.Net Core中的單元測試與代碼覆蓋率)，Codecov對Github的公開項目是免費的，下面就開始介紹如何使用codecov來實現測試代碼覆蓋率的統計：

1. 安裝Codecov：

註：安裝完成Codecov後，會有一個Upload Token用來將代碼覆蓋報告上傳到Codecov，但Appveyor的公共倉庫可以不需要：

2. 修改appveyor.yml文件：

添加使用choco管理器安裝OpenCover及codecov，然後在test_script中添加代碼覆蓋率分析報告以及上傳腳本。

註：當上述變更push到Github後，Appveyor將開始自動編譯並完成包括代碼覆蓋率報告生成、上傳等所有工作，此時打開codecov頁面將會看到報告信息：

3. 在README.md文件中添加Codecov的標籤：

結果：

小結

本文介紹了CI和CD的基本概念，前者目的在於儘可能早的發現多人開發時代碼集成的錯誤，而後者目的是避免人為造成的錯誤，將一些重複的事情交由程序自動完成，既可以減少成本又可以提高正確率，現在流行的DevOps的基礎之一就是自動化也就是CI和CD。

另外本文還介紹了在Github上使用Appvoyer和Codecov工具實現了簡單的持續集成，當把新代碼推到GitHub倉庫時，Appvoyer會自動的完成一系列構建操作。Appvoyer是一個非常強大的CI工具，對C#的支持也非常好可以選擇VS版本(包括預覽版)，多種資料庫(包括Linux下的SQL Server)，所以在執行測試時依賴資料庫的測試也能通過。

下篇文章將介紹如何使用Jenkins完成本地CI伺服器的搭建。

參考：

https://en.wikipedia.org/wiki/Continuous_integration

https://en.wikipedia.org/wiki/Comparison_of_continuous_integration_software

https://en.wikipedia.org/wiki/Continuous_delivery

https://cakebuild.net/

https://docs.codecov.io/docs

https://www.appveyor.com/docs/

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！