使用Jenkins部署.Net Core遇到的幾個坑

搞過CI/CD的同學一定吃過不少苦頭，或者說遇到不少坑，但是對自動化的執著住擋不了前進的步伐，如果你缺少了運維這一塊知識，那麼你的流水線總是不那麼完美，本文記錄的是自己躺過的坑，希望對你有所幫助。

• 伺服器：windows2008【歷史遺留伺服器，建議升級到2012以上，2016支援Windows的容器化技術】
• 原始碼管理：git
• .net core版本：net core 2.2

這裡最應該註意的是作業系統版本和Jenkins的版本，不同的版本，特別是作業系統操作的shell可能千差萬別，你會在網上看到各種命令，所以選擇好自己的環境。

安裝Jenkins比較簡單，這裡略過……

Step1.建立一個自由風格的Jenkins專案，這一步比較簡單略過（pipeline專案是一項更加挑戰，也許運維高手更需要熟悉，這裡跳過）

Step2.在配置git原始碼路徑的時候報錯：

解決方法：

1.安裝git client外掛，並重啟jenkins

2.確保安裝jenkins的伺服器同時也安裝了git，併在jenkins上配置git的路徑，如下圖：

3.成功配置git原始碼路徑

Step3.構建時候報錯：

從中可以判斷，我的郵件還沒有配置，所以傳送報錯……

Step4.進行郵件的配置

• Jenkins內建郵箱功能：

1.首先配置Jenkins Location

所在路徑：Manage Jenkins=》Configure System=>Jenkins Location

2.配置E-mail Notification如下圖所示

3.測試傳送成功

• Email外掛：Email Extension

外掛安裝後如下圖所示：

step5.構建的坑[該坑最耗時間，最後發現卻是最簡單]

1.請指定專案或解決方案檔案。當前工作目錄中未包含專案或解決方案檔案。

排查：切換到伺服器cmd下進行restore後發現，原來是nuget作怪，因為伺服器無法找到部署在本地伺服器的nuget包

2.釋出Nuget包到官網

試著解決：試著把nuget包釋出到官網。具體如何釋出請跳轉

新版本的釋出需要增加License.txt，否則無法透過，配置如下：其中Licese是從github上複製過來的。如果你釋出後發現程式碼沒有生效，請確認你是否在release下進行編譯，並且build過？

 解決方法：如下圖所示，極其簡單，折騰的半天，暈！你甚至dotnet restore和dotnet build都不用寫，因為dotnet publish本身包含restore和build

Step6.卡住在using GIT_ASKPASS to set credentials的坑

Unable to delete ‘D:\Program Files (x86)\Jenkins\workspace\Stone.Base.API’. Tried 3 times (of a maximum of 3) waiting 0.1 秒 between attempts.

解決方法：關閉配置裡的刪除功能

6.構建的時候卡住在using GIT_ASKPASS to set credentials 

解決方法：

Step 1:開始 -> 命令提示字元 -> 滑鼠右鍵 -> 以系統管理員身分執行

Step 2: 找出Jenkins Server 的Git 佈置位置，可以從自己的Jenkins 錯誤中知道位置在哪裡，以下是第一張圖顯示的Git 

Step3: 將命令提示字元(管理者許可權) 移動到該位置，輸入cd C:\Program Files\Git\bin 移動到該目錄

Step 4: 輸入 git config –system –unset credential.helper ，按下Enter

Step 5: 再重新建置Jenkins Job 就可以正常運行了

Step7.無法複製的坑

現象：無法將“obj\Debug\netcoreapp2.2\Stone.Base.API.dll”複製到“E:\Jacky\WebAPI\Base.API\Stone.Base.API.dll”

原因：該站點正在執行，dll被佔用，無法進行替換改寫

解決方法：

目前暫時還沒有找到方法，後面再做補充……

Step8.無法刪除的坑

原因：該站點正在執行，無法進行替換改寫

解決方法：把Delete workspace before build starts選項勾去掉，如下圖：

這裡的釋出改進了以往的手工釋出。從程式碼上傳那一刻開始，jenkins自動到git抓取程式碼，自動編譯打包，然後上傳到nuget伺服器。

jenkins配置如下：這裡有很多坑，特別是linux和windows很不一樣，同學們要留意。配置其實不麻煩，所有的jenkins編譯都可以在系統內部自行跑一遍，如果系統能跑通，jenkins絕對沒有問題。具體配置如下圖所示：

dotnet build 
"D:\Program Files (x86)\Jenkins\workspace\Stone.Util\UtilLib\Stone.Util"  -c Release


md publish\nuget
md publish\archives


dotnet pack "D:\Program Files (x86)\Jenkins\workspace\Stone.Util\UtilLib\Stone.Util" -c Release -o publish\nuget


dotnet nuget push "D:\Program Files (x86)\Jenkins\workspace\Stone.Util\UtilLib\Stone.Util\publish\nuget\*.nupkg" -k {自己key} -s https://api.nuget.org/v3/index.json


move "D:\Program Files (x86)\Jenkins\workspace\Stone.Util\UtilLib\Stone.Util\publish\nuget\*" "D:\Program Files (x86)\Jenkins\workspace\Stone.Util\UtilLib\Stone.Util\publish\archiv

參考文獻：

• .NET Core 從 Github到 Nuget 持續整合、部署

• Green Balls

該外掛讓你的感官有了更好的提升，客官請看：

• Build Monitor View

非常棒的構建看板，把團隊資訊透明度提升一個檔次，再也不用聽到前端開發在問：“有人在構建嗎？”，客官請看：

jenkins是如此強大，以至於今年來基本上一統CI、CD的江山，他的內容又是如此之多，足夠寫一本書，感嘆所學只不過它的冰山一角。在pipeline專案中，它也支援python等其他指令碼語言的流水化作業，功能非常之強大，期待後面的挖掘和豐富……